嵌入 Interpolation
Pug 提供了若干种操作符以满足您不同的嵌入需求。
字符串嵌入,转义
观察下面例子中的局部变量 title
、author
和 theGreat
是如何被嵌入模板的。
- var title = "On Dogs: Man's Best Friend";
- var author = "enlore";
- var theGreat = "<span>转义!</span>";
h1= title
p #{author} 笔下源于真情的创作。
p 这是安全的:#{theGreat}
title
被简单地求值;但在 #{
和 }
里面的代码也会被求值,转义,并最终嵌入到模板的渲染输出中。
里面可以是任何的正确的 JavaScript 表达式,您可以自由发挥。
- var msg = "not my inside voice";
p This is #{msg.toUpperCase()}
Pug 足够聪明来分辨到底哪里才是嵌入表达式的结束,所以您不用担心表达式中有 }
,也不需要额外的转义。
p 不要转义 #{'}'}!
如果您需要表示一个 #{
文本,您可以转义它,也可以用嵌入功能来生成(可以,这很元编程)。
p Escaping works with \#{interpolation}
p Interpolation works with #{'#{interpolation}'} too!
字符串嵌入,不转义
您当然也 并不是必须 要用安全的转义来构造内容。您可以嵌入没有转义的文本进入模板中。
- var riskyBusiness = "<em>我希望通过外籍教师 Peter 找一位英语笔友。</em>";
.quote
p 李华:!{riskyBusiness}
危险
请您务必清醒地意识到,如果直接使用您的用户提供的数据,未进行转义的内容可能会带来安全风险。不要相信用户的输入!
标签嵌入
嵌入功能不仅可以嵌入 JavaScript 表达式的值,也可以嵌入用 Pug 书写的标签。它看起来应该像这样:
p.
这是一个很长很长而且还很无聊的段落,还没有结束,是的,非常非常地长。
突然出现了一个 #[strong 充满力量感的单词],这确实让人难以 #[em 忽视]。
p.
使用带属性的嵌入标签的例子:
#[q(lang="es") ¡Hola Mundo!]
您确实可以在 Pug 中嵌入一行原始 HTML 代码来做同样的事情。但问题是,如何只用 Pug 来做这件事情?将 Pug 的标签语句用 #[
和 ]
括起来就可以了。它会被求值并嵌入到它原来位置的内容中。
空格的调整
标签嵌入功能,在需要嵌入的位置上前后的空格非常关键的时候,就变得非常有用了。因为 Pug 默认会去除一个标签前后的所有空格。请观察下面一个例子:
p
| 如果我不用嵌入功能来书写,一些标签比如
strong strong
| 和
em em
| 可能会产生意外的结果。
p.
如果用了嵌入,在 #[strong strong] 和 #[em em] 旁的空格就会让我舒服多了。
阅读文档“纯文本”页中关于空格控制的章节更深入地探讨本话题。