Crates.io | rdxl |
lib.rs | rdxl |
version | 0.5.26 |
source | src |
created_at | 2020-04-27 17:08:08.726602 |
updated_at | 2021-01-15 00:39:52.777212 |
description | Macros and Component System for HTML Templating |
homepage | |
repository | https://github.com/andrew-johnson-4/rdxl |
max_upload_size | |
id | 234721 |
size | 1,747,154 |
Domain specific language macros and component system for Rust to generate xhtml. (pronounced "Rad Axle")
Rdxl is implemented as procedural macros, so there are no runtime dependencies other than for string manipulation. This means that rdxl can be used both for server-side or client-side through web assembly.
let my_int = 3;
let my_str = "asdf";
let my_vec = vec![true, false, true, true];
println!("{}",xhtml!(<ul>
{{ for v in my_vec.iter() {{
<li>{{my_int}}, {{my_str}}, {{v}}</li>
}} }}
</ul>));
Modularized templating is encouraged through custom XML elements that implement the Display property. Foreign xhtml snippets or miscellaneous content can be inserted inline as long as it also implements the Display trait.
xtype!(<!MyList my_string:String my_int:u64>
<!MyItem my_bool:bool/>
<!MyOtherItem my_char:char/>
</MyList>);
xrender!(MyList, <ul>
<li>{{ self.my_string }}</li>
<li>{{ self.my_int }}</li>
{{ for i in self.children.iter() {{
{{ if let MyListChildren::MyItem(my_item) = i {{
<li>MyItem: {{ my_item.my_bool }}</li>
}} else if let MyListChildren::MyOtherItem(my_other_item) = i {{
<li>MyOtherItem: {{ my_other_item.my_char }}</li>
}} }}
}} }}
</ul>);
Foreign syntaxes, like Javascript, may be quoted inline with cooked or raw strings.
xrender!(BarGraph,
<script src="https://d3js.org/d3.v4.min.js"></script>
<script>
r#"var margin = {top: 20, right: 20, bottom: 30, left: 40},
width = 960 - margin.left - margin.right,
height = 500 - margin.top - margin.bottom;"#
...
</script>
);
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in rdxl by you, shall be dual licensed under the MIT and Apache 2.0 license without any additional terms or conditions.