rdxl

Crates.iordxl
lib.rsrdxl
version0.5.26
sourcesrc
created_at2020-04-27 17:08:08.726602
updated_at2021-01-15 00:39:52.777212
descriptionMacros and Component System for HTML Templating
homepage
repositoryhttps://github.com/andrew-johnson-4/rdxl
max_upload_size
id234721
size1,747,154
Andrew Johnson (andrew-johnson-4)

documentation

https://docs.rs/rdxl/

README

Rusty Domain Extensible Language

Crates.IO Documentation Build Nightly Build Donate using Liberapay

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>
);

Contribution

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.

Commit count: 253

cargo fmt