mustache 0.1.0 mustache: ^0.1.0 copied to clipboard
Mustache template library
Mustache templates #
A Dart library to parse and render mustache templates.
Example #
import 'package:mustache/mustache.dart' as mustache;
main() {
var source = '{{#names}}<div>{{lastname}}, {{firstname}}</div>{{/names}}';
var template = mustache.parse(source);
var output = template.render({'names': [
{'fistname': 'Greg', 'lastname': 'Lowe'},
{'fistname': 'Bob', 'lastname': 'Johnson'}
]});
print(output);
}
API #
Template parse(String source, {bool lenient : false});
abstract class Template {
String render(values, {bool lenient : false});
}
Once a template has been created it can be rendered any number of times.
Both parse and render throw a FormatException if there is a problem with the template or rendering the values.
When lenient mode is enabled tag names may use any characters, otherwise only a-z, A-Z, 0-9, underscore and minus. Lenient mode will also silently ignore nulls passed as values.
Supported #
Variables {{var-name}}
Sections {{#section}}Blah{{/section}}
Inverse sections {{^section}}Blah{{/section}}
Comments {{! Not output. }}
See the mustache templates tutorial for more information.
To do #
Escape tags {{{ ... }}}, and {{& ... }}
Partial tags {{>partial}}
Functions as values
And maybe later:
Incremental parser, and renderer (i.e. Stream based)
Allow the incremental renderer to handle values which are Futures and Streams.