# Changelog
## (Unreleased)
- **breaking** unify the fail and success decoder into just text_reponse_decoder, it receives the status code together with the text body and header
## 0.33.0
- **breaking** overhaul on the `Http` api to allow users to manipulate response headers, and assign callback functions to errored request.
- fix too aggressive assertion in `apply_patches` checking for matching tags.
- implement `set_location_hash` to `Browser` api.
- **breaking** dissolve `Browser` api functionalities into `Window` api.
- Fix behavior of checkboxes, it must be explicitly set_checked to false when checked attribute is removed
## 0.32.6
- implement `on_mount` event where virtual node (sauron::Node) can listen to when the element is materialized into an actual dom element.
The `MountEvent` that is passed on the argument function contains the `target_node` which is the equivalent created DOM node.
- restructure the interactive examples
## 0.32.5
- improve implementation of markdown-parser
- Use `<p>` to wrap multiple top-level elements instead of `<div>` in sauron-markdown.
- use the semantic equivalent html tag, such as `<em>` and `<strong>`, instead of just `<span>` with a `class` attribute
- fix parsing of self-closing tag for in `sauron-parse` crate.
- Add special handling of `on_enter` event, input elements can now use `on_enter` event to listen to when the user presses the `Enter` key
## 0.32.4
- minor: put behind a feature-flag some trace/debugging code.
## 0.32.3
- put behind a feature flag functionalities which deals with `node_idx_lookup`
## 0.32.2
- Add `on_copy` and `on_paste` event.
- modify `execute_in_request_animation_frame` to return the handle ( can be used for cancelling the execution )
- Add special attributes `focus`, `skip` and `replace`
- If an element has a `focus(true)` attribute, it will always have a focus on each update.
- If an element has a `skip(true)` attribute, it will skip diffing of that node and assume no changes
- If an element has a `replace(true)` attribute, it will return a `ReplaceNode` patch replacing the matching old node skipping the diffing.
This will be useful, for parts in the view code where it always changes at every update, for diffing would just become an uncessary overhead.
## 0.32.1
- Fix `apply_text_patch` to include RemoveNode
## 0.32.0
- Added improvements on `node!` macro, now allowing you to use the exact attribute names for rust keywords.
before:
```rust
node!(
<main>
<label for_="input1">Input:</label>
<input id="input1" type_="text" />
</main>
)
```
now:
```rust
node!(
<main>
<label for="input1">Input:</label>
<input id="input1" type="text" />
</main>
)
```
- simplify the algorithmn for `find_node_recursive`
- Fix server side rendering of self closing tags html, such as `input`, `br`, `hr`
- unify attribute manipulation in render and in dom_updater, the common code is in html::attributes module
- Add node_idx attribute in render if `with-nodeidx` feature is enabled
- Reexport `serde_json` in order for `jss` macro be able to use reexported `serde_json` from sauron crate
- fix example: remove the use of workaround on attributes that are keywords in rust
- Add `#[allow(unused_braces)]` inside node macro to prevent the compiler from making expressions in braces in html as unncessary
## 0.31.2
- Fix the `render` function where attributes of the same name not merged.
- use the exported Style struct from html::attributes, to avoid namespace collision with 'style' attribute
- Add Minimal SSR example
- expose a `lite-markdown` feature from `sauron` which exclude the `sauron-parse` crate to minimize binary size
- expose `empty_attr` in `html::attributes`
- this allows you to add a conditional attribute in building the view.
Example:
```rust
img(vec![
src("img/image.jpg"),
if let Some(img_title) = self.img_title {
title(img_title.to_string())
} else {
empty_attr()
}
],
vec![]
)
```
- add `jss` module and utility functions which utilizes json to preprocess css styles.
- `jss_ns` allows you to add style to your components while prefixing the classnames with a namespace to prevent clashing
with classes from other components.
Check out the `futuristic-ui` [example](https://github.com/ivanceras/sauron/tree/master/examples/futuristic-ui/) for complete usage.
## 0.31.0
- (**breaking**) Improved `style!` macro by using json as the syntax
- Added `jss!` macro which parses `json` and convert them to `css`
- Invocation the `init` method of `Component` will be done
after the `Component` has been mounted into the DOM.
- Unified base code of `append_to_mount` and `replace_mount` in `DomUpdater`
- Added `map_msg` function for mapping `DomUpdater` to a different `MSG`
- Fix all the example project's start scripts and `index.html` load script to get rid of errors from webkit based browser
- Modified scripts to use `--target web` and import module to fix problems in safari
- Get rid of test_fixtures and move it to the test directory
- use `span(vec![],vec![])` instead of `text("")` in `view_if(bool,..)` when the
flag evaluates to false
- Add support for `transitionend` and `animationend` event
- Add initial support for `style` in `Component`
- Remove the deprecated svg tag macro that should have been removed together with the html tag macro
## 0.30.0
- refactor `Cmd` to not use the `Callback`.
- remove the need for `MSG` and `PhantomData` in Cmd.
- change the `no_request_animation_frame`feature flag to `with-request-animation-frame` to be additive and is enabled by default
- change the `measure` feature flag to `with-measure`.
- Introduce a `node!` macro syntax which allows users to write view code which resembles html syntax.
- Restructure the project to have the code code of sauron in a crate `sauron-core`.
This paves a way to introduce modules which depends on the core functionality of sauron and then will be re-exported as part of the sauron package.
Example: `sauron-markdown`
- Reexport `sauron_markdown` in `sauron`. can be used as `sauron::markdown`
- dom internal: Remove only the event listener which match the event_name from the ActiveClosure
## 0.29.0
- Fix the todomvc with a new rewrite and storage support
- Update the todomvc app using keyed elements
- Fix set_checked when setting attributes for checkboxes, radio buttons
- Implement code for InsertChildren patches since Patch is changed in `mt-dom`
- Use the keyed-elements diffing in mt-dom, this will ensure that the elements with the callback will be matched with the same callback
- TruncateChildren is replaced with RemoveChildren in mt-dom, this provide a more flexible patches
- Add an example of server-side rendering using warp
## 0.28.2
- merge attributes of the same name first, before applying the attributes to the DOM element
## 0.28.1
- Adjusted for changes in mt-dom with performance improvements
- remove merge_attribute functionality in Element.
- MSG doesn't need to be clone, just use get_attributes instead of merge_attributes
- A lot of performance improvement due to changes in mt-dom crate
## 0.28.0
- adjust sauron for changes in mt-dom where there are multiple values in one attribute
## 0.27.0
- change syntax of attribute events which uses `_` after the `on` ie: `on_click` instead of `onclick`
- Make a special case for style than just a plain attribute
- Use `mt-dom` crate as replacement to sauron_vdom. `mt-dom` is a very generic virtual-dom crate which doesn't put too much constraints
on the types of the member fields
## 0.26.0
- Change `to_pretty_string` to `render` with focus on writing to the common buffer.
- This is a performance improvement
## 0.25.0
- Add a function `Node.text` to return the string of the text element
- Add a function `Node.eldest_child_text` to return the string of the only child of this element
- Add a function `Node.get_children` to return children of a node
- Add a utility function `mousemove` and `release` for MouseEvent
- Remove the call to `stop_propagation` in the add_event_listener processor, since this is handled by the event_mapper.
## 0.24.0
- **Breaking** Add the tag in patches, to give clue to backend on how to handle special tags
- This is used in gtk, since widgets in gtk doesn't follow a proper tree nesting as with html
- **Breaking** Detach `markdown` module into a high-level crate (sauron-md)
- Detach `to_syntax` module into a high-level crate (sauron-syntax)
- Create `sauron-parse` crate which `sauron-md` and `sauron-syntax` depends on.
- Add functionality for inner_html which optimizes the performance of client side apps
- Add a functionality to hook url hashchange event in the browser
## 0.23.0
- move Cmd and Dispatch from sauron_vdom to sauron
- Simplify the use Dispatch without the need for Rc
## 0.22.2
- Export `sauron_vdom::diff::diff_with_key`
- Add function `take_callback` to consume attribute and get the callback
## 0.22.1
- Only expose html::events in prelude when 'with-dom' feature is enabled
## 0.22.0
- Make use of prelude to simpilfy imports in sauron
- Add feature to parse html and convert it into sauron view syntax code.
- Add link to [html2sauron](https://ivanceras.github.io/html2sauron/) tool in the docs
- Refactor Attribute key to use generic type, Attribute key was previously using `&'static str`, It got changed to a generic type, which allows us to create attribute with key other than `&'static str` such as `String` or strongly typed `enums`.
- Simplify the indent utility function
- Improve the svg_clock example to make the subsecond update to the subsecond by ticking at every 20ms
- Add cargo deny configuration
## 0.21.1
- Add a help function classes which joins an array of string into a space class
- Use criterion in benchmarks
- Add data-viewer as an example
## 0.21.0
- add Window as a global object to let components easily attached events to the window
- add style! macro for a nicer html style attribute syntax
- **Breaking Change** remove tag style from the macro export, as it conflicts with the style attribute macro, which is more common
- include mousemove in the supported event type
- implement creating an attribute that has namespace, such as xlink:href in embededd svg image
- fix error in svg_graph example
## 0.20.3
- expose `onclick_with`, `onclick_stop_propagation`, `onclick_prevent_default`, `onclick_prevent_all` which allows developers
control on the behavior of the event of a DOM element.
## 0.20.2
- Enable doubleclick event
- improve and modularize shell scripts
- Fix errors in the todomvc benchmark
- Explicitly set the value of element by calling the set_value function since just setting the attribute value is not enough
- Enable calling to event.prevent_default() to allow both oninput and keypress event play nicely together, as used in the todomvc example
- Add svg_graph example
## 0.20.1
- bumped up to see logo in docs.rs
## 0.20.0
- Add macro based syntax to provide a cleaner syntax in writing the view:
## Old syntax:
```rust
fn view(&self) -> Node<Msg> {
div(
vec![class("some-class"), id("some-id"), attr("data-id", 1)],
vec![
input(
vec![
class("client"),
r#type("button"),
value("Click me!"),
onclick(|_| {
trace!("Button is clicked");
Msg::Click
}),
],
vec![],
),
text(format!("Clicked: {}", self.click_count)),
],
)
}
```
## New syntax:
```rust
fn view(&self) -> Node<Msg> {
div!(
[class("some-class"), id("some-id"), attr("data-id", 1)],
[
input!(
[
class("client"),
type_("button"),
value("Click me!"),
onclick(|_| {
trace!("Button is clicked");
Msg::Click
}),
],
[],
),
text!("Clicked: {}", self.click_count),
],
)
}
```
- Move DomEvent in dom module
- nicer name for `dumb_patch` -> `apply_dumb_patch`
- Refactor `dom_updater` and `created_node` out of the dom module
- Add macro syntax, which provides a cleaner code by eliminating the `vec![]` syntax on the components view functions
- Enable github actions
- Reorganize dom specific module to get rid of multiple cfg feature code in the library
- Reorganize `html::tags` and `svg::tags`
- Remove the html_array syntax
- Fix unused warning errors when no feature is enabled
- Use the proper logging by using `log` and `console_log crate`
- Completely remove the with-serde feature
- Add feature gate 'with-dom' for browser specific functionality, such that sauron can be efficiently used for server-side rendering
- Constraint the generic Type: `F` to be 'static in Callback, instead of the return generic type
- Fix attributes helper functions: (`styles`, `styles_flag`, `classes`, `classes_flag`, `attrs_flag`) should not require MSG to be clone
## 0.11.1
- attributes helper functions such as (styles, classes, etc) should not require MSG to be Clone.
## 0.11.0
- Add underscores on html tags and attribtues(`type`,`for`, `async`, `loop`) that are also special keywords in rust.
Now, you can use `type_("text")` as an alternative to `r#type("text")`
- rename as_element -> as_element_mut, children -> add_children
- Add `dumb_patch` for patching the dom without involving the callbacks.
- Expose to `html::tag` module for the uncommon html tags which conflicts with common html attributes such as `style`, `title`.
## 0.10.1
- implemented removing the associated closures of elements that has been removed from the DOM including the removed element descendants.
## 0.10.0
- performance improvement on node tree building
- using vec![] as the argumemts for attributes and children, this changes the syntax a lot
- The original array based syntax is still preserved by using the `html_array` module. This however has performance penalty
- events and attributes are now unified in one field: `attrs`
- `map` function mapping Msg from in between component is now `map_msg` to avoid confusion with the rust std common maps such `Iterator.map`
- add units utility functions
- Remove requirement for Msg to have any Clone,Debug,PartialEq
## 0.7.1
- Add initial implementation for markdown handling
- Add history function get history object
- events now prevents defaults and stop propagation
## 0.7.0
- Added an initial implementation for Http for fetching data which returns a Cmd
- Added Examples usage of Http fetch
- Added Browser for listening to browser resize event which returns a Cmd
- Added Cmd module for abstracting calls such as Http requests
- Added an optional `init` function in Component which allows apps execute Cmd Task such as fetching data at the start of the app
- Change the update method in Component to return Cmd<Self,Msg> in update method
## 0.6.0
- Refactor sauron_vdom::Event to cater general usecase for mouse, keyboard and input event
- Events such as onclick, onkeypress, and oninput are now supplied with: MouseEvent, KeyEvent, and InputEvent
accordingly, therefore no additional matching/unwrapping code is neccessary on the users code.
Before:
```rust
onclick(|event: Event| {
if let Event::MouseEvent(mouse) = event{
sauron::log!("clicked at ({},{})", mouse.x(), mouse.y())
}else{
panic!("This should not happen")
}
})
```
Now:
```rust
onclick(|mouse: MouseEvent| {
sauron::log!("clicked at ({},{})", mouse.x(), mouse.y())
})
```
- Move to svg_extra the following tags and attributes: style, width, height, id, font_size, font_family,
since these conflicts with the commonly used tags and attributes in html. Attributes that are defined in html attributes
could also be used in svg attributes. What's not possible is using tags declared in html module in svg elements,
since svg elements needs to be created with svg namespace in the DOM.
## 0.5.0
- Use &'static str type for Node's attribute name, event name and namespace.
- Add helper function `styles` which allows users to write style properties easily.
- Add helper function `styles_flag` which allows users to write even more granular style properties.
- Elements attributes are now appended to the existing attributes ones,
this is needed when there is multiple calls assigning on the same attributes on the same element
- Put back `Callback<Event,MSG>` as the value of node.events.
- Add `map` functionality which lets user embed subcomponents view into the parent component by mapping the callbacks
with a wrapped MSG variant from the parent.
## 0.4.0
- Added the complete list of svg/html attributes.
- Separate the uncommon html tags into html_extract module. These includes `style`, which conflicts with the
commonly used `style` attributes.
- Separate the uncommon attributes such as `span`, `label` which conflicts with the
commonly used `span` and `label` html tags.
- Use snake_case for non-ident tags and attributes.