1 stable release
1.0.0 | Apr 15, 2023 |
---|
#1408 in Rust patterns
63 downloads per month
Used in unocss-classes
6KB
95 lines
classes
classes
is a lightweight and dependency-free macro that simplifies the process of building class strings for DOM
elements. It accepts a variable number of arguments and combines them into a single class string.
This macro is designed after the popular classnames
npm package, which is commonly used in React and other frameworks.
Usage
You can supply string types or types that can be transformed into a string to the macro:
Option<String>
/Option<&str>
will use the inner value if the option isSome
, and ignore the option if it'sNone
String
/&str
will be applied as is- The special syntax
string_expr => bool_expr
will use thestring_expr
whenbool_expr
evaluates to true
Using the Classes macro can simplify your code by reducing the boilerplate needed to build class strings.
Example
use classes::classes;
fn main() {
let optional = Some("lumos");
let is_night = true;
let class = classes!["hogwarts", optional, "hogwarts--at-night" => is_night, "wingardium-leviosa" => false];
println!("{class}"); // => 'hogwarts lumos hogwarts--at-night'
}
Dioxus Example
use classes::classes;
pub fn Button<'a>(cx: Scope<'a, ButtonProps<'a>>) -> Element {
let class = classes!["button", "button--disabled" => cx.props.disabled, cx.props.class];
cx.render(rsx! {
button { class }
})
}