The htl
Notation
This package additionally provides the @htl_str
non-standard string literal, which is more succinct than the @htl
macro.
using HypertextLiteral: @htl, @htl_str
Strings prefixed by htl
are processed by @htl_str
.
name = "World"
htl"<span>Hello $name</span>"
#-> <span>Hello World</span>
@htl_str "<span>Hello \$name</span>"
#-> <span>Hello World</span>
Other than a handful of exceptions, htl"<tag/>"
and @htl("<tag/>")
are otherwise identical in behavior.
Dynamic Templates
The @htl_str
macro can be used to dynamically construct templates in combination with eval
. Suppose you have a schema that is provided dynamically. Let's make a test database with exactly one row.
T = NamedTuple{(:idx, Symbol("A <Value>")), Tuple{Int64, String}};
database = [T((1, "A&B"))];
display(database)
#=>
1-element Vector{NamedTuple{(:idx, Symbol("A <Value>")), …}:
(idx = 1, A <Value> = "A&B")
=#
We could construct a table header from this schema.
fields = T.parameters[1]
#-> (:idx, Symbol("A <Value>"))
head = @htl "<tr>$([@htl("<th>$x") for x in fields])"
#-> <tr><th>idx<th>A <Value>
Then, we need to compute a template for each row.
row_template = "<tr>$(join(["<td>\$(row[$(repr(x))])" for x in fields]))"
print(row_template)
#-> <tr><td>$(row[:idx])<td>$(row[Symbol("A <Value>")])
Using eval
with @htl_str
we could construct our template function.
eval(:(tablerow(row) = @htl_str $row_template))
tablerow(database[1])
#-> <tr><td>1<td>A&B
A template for the entire table could be constructed.
table_template = "<table>$head\$([tablerow(row) for row in data])</table>"
print(table_template)
#-> <table><tr><th>idx…$([tablerow(row) for row in data])</table>
eval(:(print_table(data) = @htl_str $table_template))
Then, finally, this could be used.
print_table(database)
#-> <table><tr><th>idx<th>A <Value><tr><td>1<td>A&B</table>
Of course, one should be careful about using eval
to ensure that the template itself is well sanitized.
Notable Differences
Unlike @htl
, htl
uses @raw_str
escaping rules. In particular, so long as a double-quote character does not come before a slash, the slash itself need not be escaped.
htl"<span>\some\path</span>"
#-> <span>\some\path</span>
To represent the dollar-sign, use use HTML character entity #&36;
.
amount = 42
htl"<span>They paid $$amount</span>"
#-> <span>They paid $42</span>
Unlike macros, this syntax does not nest.
htl"Hello $(htl"World")"
#-> ERROR: syntax: cannot juxtapose string literal
Triple double-quoted syntax can be used as a work around.
htl"""Hello $(htl"World")"""
#-> Hello World
However, this trick works only one level deep. Hence, there are some significant downsides to using this format, which are explored in detail at Julia #38948.
Marginal Benefits
Since the implementers of the notation have some control over the parsing, there are some benefits. First, we can reliably detect string literals (Julia #38501) before v1.6. This is fixed in Julia 1.6+
htl"""<span>$("A&B")</span>"""
#-> <span>A&B</span>
Second, there is one less round of parenthesis needed for tuples, named tuples and generators (Julia #38734). This is especially useful when building attributes.
name = "Hello"
htl"<tag $(user=name,)/>"
#-> <tag user='Hello'/>
print(htl"<span>$(n for n in 1:3)</span>")
#-> <span>123</span>
Beyond these differences, this could just be a matter of preference; or which form of syntax highlighting works best.
Regression Tests & Notes
Due to @raw_str
escaping, string literal forms are a bit quirky. Use the triple double-quoted form if your content has a double quote. Avoid slashes preceding a double quote, instead use the /
HTML entity.
htl"\"\t\\"
#-> "\t\
htl"(\\\")"
#-> (\")
Even though we could permit interpretation of arrays notation, we stick with keeping this an error for consistency with the macro form.
htl"$[1,2,3]"
#=>
ERROR: LoadError: DomainError with [1, 2, 3]:
interpolations must be symbols or parenthesized⋮
=#
Let's also not permit top-level assignments.
htl"$(k=value)"
#=>
ERROR: LoadError: DomainError with k = value:
assignments are not permitted in an interpolation⋮
=#