GitHub
Twitter{{-expression-}}
Omit whitespace from around the output of the template.
{{-EXPRESSION-}}
Whitespace may be omitted from either or both ends of a magic tag by including a
- character by the braces. When present, all whitespace on that side will be
omitted up to the next tag, magic tag, or non-whitespace character. It also works with {{{expression}}}.
The following ensures there is no extra whitespace between the second <pre>, the output of {{-this.message-}},
and the </pre> closing tag:
<my-demo></my-demo>
<style>
pre {border: solid 1px;}
</style>
<script type="module">
import {Component} from "can";
Component.extend({
tag: "my-demo",
view: `
<pre>
{{this.message}}
</pre>
<pre>
{{- this.message -}}
</pre>`,
ViewModel: {
message: {default: "Hi There!"}
}
});
</script>
Parameters
- EXPRESSION
{Literal Expression|KeyLookup Expression|Call Expression|Helper Expression}:An expression whose unescaped result is inserted into the page.
{{--}}
Whitespace may be omitted without an expression. This is useful between html tags, for example, where it may cause issues in the display of static inline elements.
The following ensures there is no extra whitespace between the inline items:
<my-demo></my-demo>
<style>
.slantycolors {
display: inline-block;
transform: skewX(15deg);
padding: 10px;
color: white;
font-weight: bold;
background: linear-gradient(to top, orange, black, blue);
}
</style>
<script type="module">
import {Component} from "can";
Component.extend({
tag: "my-demo",
view: `
<span class="slantycolors">
orange
</span>
{{--}}
<span class="slantycolors">
black
</span>
{{--}}
<span class="slantycolors">
blue
</span>
<span class="slantycolors">
{{message}}
</span>`,
ViewModel: {
message: {default: "There's no {{--}} before me."}
}
});
</script>
Examples
Basic Usage
<div>
{{-# if(user.isMarried) -}}
Mrs
{{- else -}}
Miss
{{-/ if -}}
</div>
would render as:
<div>{{# if(user.isMarried) }}Mrs{{ else }}Miss{{/ if }}</div>
and
<div>
{{{- toMarkdown(content) -}}}
</div>
would render as:
<div>{{{ toMarkdown(content) }}}</div>
Span Elements
One use case is to remove spaces around span elements.
<div>
<span>
{{-# if(user.isMarried) -}}
Mrs.
{{- else -}}
Miss.
{{-/ if -}}
</span>
{{- user.name }}
</div>
would render as:
<div>
<span>{{#if(user.isMarried)}}Mrs.{{else}}Miss.{{/if}}</span>{{ user.name }}
</div>
Empty Elements
Another would be to assure that empty elements are able to match the :empty
css pseudo-class (the whitespace that would be otherwise present prevents this),
while still being cleanly formatted for human consumption.
<div>
{{-! output the users name }}
{{-# if(user.name) }}
{{ user.name }}
{{/ if -}}
</div>
would render as:
<div>{{-! output the users name }}{{-# if(user.name) }}
{{ user.name }}
{{/ if -}}</div>
Special Case
You may want to remove all whitespace between elements without output or comment.
<ul>
{{--}}
<li>Inline Nav Item 1</li>
{{--}}
<li>Inline Nav Item 2</li>
{{--}}
</ul>
would render as:
<ul><li>Inline Nav Item 1</li><li>Inline Nav Item 2</li></ul>