A reactive helper that ensures normalized class list strings in frontend frameworks like Leptos.
Examples provided will be for the Leptos framework post-{context removal}, but it will work pre-{context removal} and might work in other similar frameworks.
This library is meant to be agnostic and has no runtime dependencies, but it has only been tested with Leptos.
bash
cargo add class_list
class_list![] by default wraps itself in a move closure, meaning it will be reactive by default.
```rs let (count, setcount) = createsignal(0);
setinterval( move || { setcount.update(|count| *count += 1); }, Duration::from_millis(100), );
let countclass = move || format!("count-{}", count()); let countis_even = move || count() % 2 == 0;
view! {
count_is_even() is true.
// You also don't need to call closures here.
"even" <=> countiseven
] />
}
```
Each option must be followed by a ;.
To generate a non-reactive String, add the raw option to the beginning.
rs
class_list![
raw;
"default-class-names",
]
Rarely, you may need to clone something before passing it in.
The macro makes this easy with the clone option which clones the variable before it gets moved into the closure.
If possible try to avoid needing this option in the first place.
rs
class_list![
clone[count_class];
"default-class-names",
]
This should never be needed because it's automatically supplied by a wrapper macro_rules!.
In a case where the trait imports cannot be resolved--such as when used inside of another library--, the path can be redefined.
The path should lead to the root of this library.
rs
__class_list![
crate = ::your_lib::class_list;
"default-class-names",
]