Play的魔板引擎本人认为可以说是为full stack Developers量身打造的功能。在原有的html页面基础上,只需要在html文件名后缀名前面加上”.scala“,就可以在页面上写Scala代码,而且页面之间可以像函数一样被”调用“。例如:index.html本身这个文件中不能够写scala代码,但是如果index.html后缀名前加上”.scala“变为”index.scala.html“,就可以在其中写scala代码了,”index.html“变为”index.scala.html“后,就会被看成一个scala文件,编译的时候会当做一个object来编译;是不是有点JSP的感觉?但是比JSP更爽,JSP必须是一个完整的html文件,而play 的魔板引擎可以”拼凑“,就是可以一个功能模块写一个文件,或者共同的模块儿抽象出来,写成一个公共的模块文件,然后被其他文件调用。有了play魔板引擎,写页面变的如此简单!
下面我们对play的页面魔板引擎做一个简单的介绍:
其实play的页面魔板引擎并不是为play而生的,它本身就是一个简单框架,有自己的名字,叫:”Twirl“,Twirl并不是依赖着play而存在的,它是一个单独的项目,具体请关注https://github.com/playframework/twirl/blob/master/README.md。
一个play 的页面魔板 是一个包含少量scala代码块的简单的text文件。页面魔板可以在任何文本格式的文件中触发,例如:HTML、XML或者CSV等。
页面魔板将会被编译成标准的Scala函数,假如你创建了一个views/Application/index.html页面魔板文件,它会生成一个包含applay()方法的views.html.Application.index类。
好了,正式开始:
play的页面模板是从神奇”@“字符开始的。在页面模板中,加入”@“后,就可以写Scala代码了,可以是变量、函数、对象、代码块…任何Scala相关的东西。
例如:
1、 Hello @customer.name ! 在这里,”customer“代表的就是一个对象,name是customer的属性
2、Hello @{customer.firstName +customer.lastName}!看见了没有加了”@“后可以直接写Scala的代码,这样为动态的赋值增加了便利
3、Hello @{val name=customer.firstName +customer.lastName;name} 注意:这样输出的是”name“的值,很像Scala函数返回值的写法有木有?
加一个”@“有神奇的效果,但是两个”@“:”@@“就是脱离这种效果了,大家要注意。
页面模板就像一个函数,函数当然可以有参数,如果你想加参数,就得在文件的上面 定义:@(customer:Customer,order:List[Order]),完全是Scala函数的定义方法 有木有?也可以这样:@(title:String=”Home“) 还可以柯里化的形式,像这样:@(title:String)(body:Html),总之就是Scala函数的定义方法基本都可以。
循环:play 页面模板推荐使用增强for循环
例: <ul>
@for(p <-products){
<li>@p.name ($@p.price)</li>
}
</ul>
这里有个需要注意的地方:”{“必须和”for“字段在同一行
if语句:
例:@if(items.isEmpty){
<h1>Nothing to display</h1>
}else{
<h1>@items.size.items!</h1>
}
声明可以再度使用的代码块:(函数)
例1: @display(product:Product)={
@product.name($@product.price)
}
<ul>
@for(product <- products){
@display(product)
}
例2:
@title(text:String)=@{
text.split(' ').map(_.capitalize).mkString(" ")
}
<h1>@title("hello world")</h1>
这个·用法非常的常用,可以在这个语法块中处理相关的逻辑,然后得出一个返回值,然后再别处调用。
顺便说一下:如果你想定义一个隐士的变量,必须在@之后以”implicit“开头命名就可以,例如:
@implicitFieldConstructor=@{MyFieldConstructor()}
注意:implicit和名字必须是连起来的,@implicit FiledConstructor这样写是不行的。
声明可以使用的值
@defining(user.firstName+" "+user.lastName){ fullName =>
<div>Hello @fullName </div>
}
注意:fullName的作用范围仅仅是”{}“之内,出了”{}“就不好用了
引入声明:
你可以引入任何你先引入的东西,类、包等等
例子:
@(customer:Customer,orders:List[Order])
@import utils._
注释:
play 页面模板的注释:@* *@
例子:
@*********************
* This is a comment *
*********************@
你可以放一条注释在模板的首页,作为Scala API的文档:
@*************************************
* Home page. *
* *
* @param msg The message to display *
*************************************@
@(msg: String)
<h1>@msg</h1>
输出真实的HTML:
<p>
@Html(article.content)
</p>