Templates syntax

    • 简洁、富于表现力且灵活：它最小化了一个文件中的字符和按键数，使你的工作流快速、连续。与大部分模板语法不同，你无需在 HTML 内显式地标注服务端的代码块，解析器能从你的代码中自动推断出来。这使得模板语法简洁紧凑而富有表现力，写起来干净、快速而且好玩。
    • 容易学习：只需要学习少量概念，即可使你高效多产。你只需要使用简单的 Scala 概念及你已有的 HTML 技巧即可。
    • 不是一门新语言：我们有意识地选择不去创造一门新语言，而是想让 Scala 开发者能使用他们现有的 Scala 语言技巧，并提供一种使 HTML 构建过程更赞的模板标记语法。
    • 可在任意文本编辑器中编辑：它不需要特殊的开发工具，你可以在任意的纯文本编辑器中高效使用它。

    模板会被编译，因此如果有错误，你可以在浏览器中直接看到：

    概述

    Play 的 Scala 模板是一个包含小段 Scala 代码块的文本文件。模板可以生成任意基于文本的格式，如 HTML，XML 或 CSV。

    模板系统的设计使 HTML 使用者用起来会很舒服，前端开发者很容易就可以上手。

    模板会被编译成标准 Scala 函数（使用一种简单的命名约定）。如果你创建一个 模板文件，它会生成一个 views.html.Application.index 类，这个类有一个 apply() 方法。

    例如，下面是一个简单的模板：

    你可以在任意 Scala 代码中调用上述代码，就像你调用一个类的方法一样：

    1. val content = views.html.Application.index(c, o)

    神奇的 ‘@’ 字符

    Scala 模板只使用一个特殊字符：@。每次遇到这个字符，它就表明一条动态语句的开始。你无需显式地标注代码块的结束，动态语句在哪结束会被自动地推断出来：

    1. Hello @customer.name!
    2.        ^^^^^^^^^^^^^
    3.        Dynamic code

    模板引擎是通过分析你的代码来推断代码块在哪结束，因此它只能支持简单的语句。如果你要插入一条复杂语句，用括号来显式地标注它：

    1. Hello @(customer.firstName + customer.lastName)!
    2.        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    3.                     Dynamic Code
    1. Hello @{val name = customer.firstName + customer.lastName; name}!
    2.        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

    由于 @ 是特殊字符，当你想使用 @ 这个字符时，就需要转义它（即 @@）：

    1. My email is bob@@example.com

    模板就像函数，因此它也需要参数。参数必须被声明在模板文件的顶部：

    1. @(customer: Customer, orders: List[Order])

    你也可以为参数提供默认值：

    甚至可以提供几个参数组：

    1. @(title: String)(body: Html)

    遍历

    你可以使用关键词 for 进行遍历：

    1. <ul>
    2. @for(p <- products) {
    3.   <li>@p.name ($@p.price)</li>
    4. }

    if 块

    if 块的使用并没有什么特别的，和 Scala 中的 if 用法相似：

    1. @if(items.isEmpty) {
    2.   <h1>Nothing to display</h1>
    3. } else {
    4.   <h1>@items.size items!</h1>
    5. }

    你可以创建可复用的代码块：

    1. @display(product: Product) = {
    2.   @product.name ($@product.price)
    3. }
    5. <ul>
    6. @for(product <- products) {
    7.   @display(product)
    8. }
    9. </ul>

    注意，你也可以声明可复用的纯代码块：

    1. @title(text: String) = @{
    2.   text.split(' ').map(_.capitalize).mkString(" ")
    4. <h1>@title("hello world")</h1>

    按照惯例，一个可复用的代码块命名如果以 implicit 开头，它就会被标记为 ：

    1. @implicitFieldConstructor = @{ MyFieldConstructor() }

    声明可复用的值

    你可以使用 defining helper 方法来定义一个局部值：

    导入声明

    你可以在模板（或子模板）的开始处导入任何你想要的东西：

    1. @(customer: Customer, orders: List[Order])
    3. @import utils._
    5. ...

    为确保绝对的解析路径，可以在 import 语句前加上 root 前缀：

    1. @import _root_.company.product.core._

    如果在所有的模板中，你都要导入一个相同的东西，那么你可以将它声明在 build.sbt：

    1. TwirlKeys.templateImports += "org.abc.backend._"

    使用 @* *@，你就可以在模板中像服务端那样写块注释：

    1. @*********************
    2. * This is a comment *
    3. *********************@

    你可以在模板最开始处写上注释，这样可以把你的模板文档化到 Scala API doc 中：

    1. @*************************************
    2.  * Home page.                        *
    3.  *                                   *
    4.  * @param msg The message to display *
    5.  *************************************@
    6. @(msg: String)
    8. <h1>@msg</h1>

    转义

    默认情况下，动态内容会根据模板的类型（如 HTML 或 XML）规则进行转义。如果你想输出原始内容，则需要将它包在模板的内容类型里。

    例如，要输出原始的 HTML 内容：

    1. <p>
    3. </p>