PLAY2.6-SCALA(十一) 模板常用场景

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))

posted @ 2018-06-07 14:40 飞末阅读(380) 评论(0) 收藏举报

刷新页面返回顶部

飞末