riot-tmpl v3.0.8
Tmpl
The riot template engine
Installation
Npm
npm install riot-tmpl --save
Bower
From v2.4.2, bower is not supported.
Documentation
How it works?
Three ways:
Expressions:
tmpl('{ value }', data)
. Returns the result of evaluated expression as a raw object.Templates:
tmpl('Hi { name } { surname }', data)
. Returns a string with evaluated expressions.Filters:
tmpl('{ show: !done, highlight: active }', data)
. Returns a space separated list of trueish keys (mainly used for setting html classes), e.g. "show highlight".
Template examples
tmpl('{ title || "Untitled" }', data)
tmpl('Results are { results ? "ready" : "loading" }', data)
tmpl('Today is { new Date() }', data)
tmpl('{ message.length > 140 && "Message is too long" }', data)
tmpl('This item got { Math.round(rating) } stars', data)
tmpl('<h1>{ title }</h1>{ body }', data)
Falsy expressions
In templates (as opposed to single expressions) all falsy values except zero (undefined/null/false) will default to empty string:
tmpl('{ undefined } - { false } - { null } - { 0 }', {})
// will return: " - - - 0"
tmpl('{}') // undefined
tmpl('{ false }', {}) // false
tmpl('{ null }', {}) // null
tmpl('{ 0 }', {}) // 0
Changes in v2.3
- Brackets can not contain characters in the set
[\x00-\x1F<>a-zA-Z0-9'",;\\]
- No comments in expressions, the compiler is the only that strip comments
- Attributes with expressions containing
>
must be quoted
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago