模板作为简单的函数,可以由任意的方式构成。下面是一些常见的使用情况。
让我们来声明一个 views/main.scala.html
模板来作为主要的布局模板:
@(title: String)(content: Html)
<!DOCTYPE html>
<html>
<head>
<title>@title</title>
</head>
<body>
<section class="content">@content</section>
</body>
</html>
正如你所见,这个模板接收两个参数:标题(title)和 HTML 内容块(content)。下面我们在另一个模板(views/Application/index.scala.html
)中使用它:
@main(title = "Home") {
<h1>Home page</h1>
}
注意:有时候我们使用命名参数,如
@main(title = "Home")
,而不是@main("Home")
。这个视具体情况,选择一个表述清楚的即可。
有时候,你需要另一个页面内容来作为侧边栏(sidebar),这时你可以添加一个额外的参数来做到:
@(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>
}
下面我们来写一个简单的标签 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>
}
同样没有任何特别之处,你可以调用任意其它模板(事实上可以调用任意地方的任意函数):
<h1>Home</h1>
<div id="side">
@common.sideBar()
</div>
想在 Scala 模板中定义 moreScripts 和 moreStyles 等价物(像在 Play! 1.x 那样),你只需像下面那样在主模板中定义一个变量:
@(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 ...
}