UNPKG

arc-templates

Version:

Fully powered JavaScript template engine with halfway-decent syntax.

github.com/StephenCleary/arc-templates

StephenCleary/arc-templates

53 lines (27 loc) • 1.56 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# Expressions Expressions are parts of the document that are evaluated as JavaScript code. The result of the expression is converted to a string and injected into the document. Expressions usually use [variables or functions](identifiers.md). ## Basic syntax Expressions start with `${` and end with `}`. A simple expression: Hello, ${ name }! with a data object of `{ name: 'world' }` will result in: Hello, world! Note that whitespace within an expression is ignored (just like regular JavaScript), but whitespace outside the expression is significant: Hello, ${name } ! with a data object of `{ name: 'world' }` will result in: Hello, world ! ## Escaping By default, the expression's value is escaped (using [lodash's `escape`](https://lodash.com/docs#escape)): Hello, ${ name }! with a data object of `{ name: '<html>' }` will result in: Hello, &lt;html&gt;! If you want to prevent escaping, use the [built-in `raw` function](identifiers.md#raw): Hello, ${ raw(name) }! with a data object of `{ name: '<html>' }` will result in: Hello, <html>! ## Caveats Expressions are not interpreted by ARC templates; they are only evaluated. This means that *an expression may not contain `}`*. For example, this template: ${ 'test of }' } will result in a syntax error when the template is compiled, because the template attempts to treat `'test of ` as an expression. This also means you can't use IIFEs as expressions.