1.布局
声明一个views/main.scala.html模板作为主布局模板
@(title: String)(content: Html)
<!DOCTYPE html>
<html>
<head>
<title>@title</title>
</head>
<body>
<section class="content">@content</section>
</body>
</html>
有两个参数，一个标题，一个html格式的内容，在 views/Application/index.scala.html模板中调用它
@main(title = "Home") {
<h1>Home page</h1>
}
有时你需要第二个特殊页面的侧边栏或者浏览路径，可以通过添加一个参数做到
@(title: String)(sidebar: Html)(content: Html)
<!DOCTYPE html>
<html>
<head>
<title>@title</title>
</head>
<body>
<section class="sidebar">@sidebar</section>
<section class="content">@content</section>
</body>
</html>
可以从‘index’模板使用它
@main("Home") {
<h1>Sidebar</h1>
} {
<h1>Home page</h1>
}
也可以单独声明一个工具栏
@sidebar = {
<h1>Sidebar</h1>
}
@main("Home")(sidebar) {
<h1>Home page</h1>
}
2.标签
views/tags/notice.scala.html显示HTML通知的简单标签
@(level: String = "error")(body: (String) => Html)
@level match {
case "success" => {
<p class="success">
@body("green")
</p>
}
case "warning" => {
<p class="warning">
@body("orange")
</p>
}
case "error" => {
<p class="error">
@body("red")
</p>
}
}
在另一个模板中调用它
@import tags._
@notice("error") { color =>
Oops, something is <span style="color:@color">wrong</span>
}
3.moreScripts and moreStyles equivalents
在main模板中定义一个变量
@(title: String, scripts: Html = Html(""))(content: Html)
<!DOCTYPE html>
<html>
<head>
<title>@title</title>
<link rel="stylesheet" media="screen" href="@routes.Assets.at("stylesheets/main.css")">
<link rel="shortcut icon" type="image/png" href="@routes.Assets.at("images/favicon.png")">
<script src="@routes.Assets.at("javascripts/jquery-1.7.1.min.js")" type="text/javascript"></script>
@scripts
</head>
<body>
<div class="navbar navbar-fixed-top">
<div class="navbar-inner">
<div class="container">
<a class="brand" href="#">Movies</a>
</div>
</div>
</div>
<div class="container">
@content
</div>
</body>
</html>
在一个需要使用额外脚本的模板中
@scripts = {
<script type="text/javascript">alert("hello !");</script>
}
@main("Title",scripts){
Html content here ...
}
不需要的
@main("Title"){
Html content here ...
}
4.添加自定义的模板格式
play.twirl.api.Format[A] 接口有两个方法，raw(text: String): A 和 escape(text: String): A分别用来处理静态内容和动态内容
参数类型A代表了模板引擎的返回结果，e.g. Html代表了HTML模板。这个类型必须是play.twirl.api.Appendable<A>特质的子类，该特质定义了如何将各部分连接起来
为了方便起见，Play提供了抽象类play.twirl.api.BufferedContent<A>，该类实现了play.twirl.api.Appendable<A>，使用StringBuilder来构建结果，并且实现了play.twirl.api.Content接口，所以Play知道如何将结果转换为HTTP相应体。
简单地说，你需要两个类：一个用来定义结果（实现play.twirl.api.Appendable），另一个用来处理文本（实现lay.twirl.api.Format），下面给出一个HTML格式的例子
// The `Html` result type. We extend `BufferedContent[Html]` rather than just `Appendable[Html]` so
// Play knows how to make an HTTP result from a `Html` value
class Html(buffer: StringBuilder) extends BufferedContent[Html](buffer) {
val contentType = MimeTypes.HTML
}
object HtmlFormat extends Format[Html] {
def raw(text: String): Html = …
def escape(text: String): Html = …
}
关联文件扩展名与格式
在编译整个应用之前，模板会被编译进.scala的文件中。TwirlKeys.templateFormats是sbt中的一个配置，用来定义文件扩展名与格式之间的关系，实际上是一个Map[String,String]。如果你想让Play使用你自己的HTML格式，可以添加以下配置：
TwirlKeys.templateFormats += ("html" -> "my.HtmlFormat.instance")
注意箭头右边需要使用play.twirl.api.Format<?>类型的全名
5.告诉Play如何根据模板结果类型生成http结果
Play可以为任何A存在隐式play.api.http.Writeable[A]值的类型值编写HTTP响应主体。所以你所需要的就是为你的模板结果类型定义一个这样的值。例如，下面是如何为HTTP定义这样一个值：
implicit def writableHttp(implicit codec: Codec): Writeable[Http] = Writeable[Http](result => codec.encode(result.body), Some(ContentTypes.HTTP))
如果你的模型类型继承自play.twirl.api.BufferedContent，你可以只定义一个play.api.http.ContentTypeOf值
implicit def contentTypeHttp(implicit codec: Codec): ContentTypeOf[Http] = ContentTypeOf[Http](Some(ContentTypes.HTTP))