Play框架拾遺之三：模板引擎

時間 2019-11-06

標籤 play 框架拾遺之三模板引擎简体版

原文原文鏈接

一、模板語法

用表達式時，以下使用時，只有client不爲null的狀況下，才進行client.name的輸出。css

<h1>Client ${client?.name}</h1>

在應用中，模板引擎默認對全部的動態表達式進行轉義，以此來避免XSS的安全問題。能夠經過調用擴展方法raw()，以非轉義的形式在頁面中輸出，如：html

${title.raw()} --> <h1>Title</h1>

若是須要顯示大量的非轉義HTML內容，可使用#{verbatim /}標籤：java

#{verbatim}
  ${title} --> <h1>Title</h1>
#{/verbatim}

Play經過路由器能夠（逆向）生成URL，匹配指定的路由。在模板中使用@{…}引用能夠達到相同的目的：安全

<h1>Client ${client.name}</h1>
<p><a href="@{Clients.showAccounts(client.id)}">All accounts</a></p>
<hr />
<a href="@{Clients.index()}">Back</a>

該實例中，@{Clients.showAccounts(client.id)}調用了Clients控制器中的showAccounts Action方法，並傳遞了client.id參數。 @@{…}引用的使用語法與@{…}相同，只不過生成的是絕對URL（尤爲適用於郵箱）。服務器

二、模板繼承

Play中，能夠使用#{extends /} 和 #{doLayout /}來繼承模板，使用#{get}和#{set}標籤進行參數傳遞，如：session

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>#{get 'title' /}</title>
  <link rel="stylesheet" type="text/css" href="@{'/public/stylesheets/main.css'}" />
</head>

<body>
  <h1>#{get 'title' /}</h1>
  #{doLayout /}
  <div class="footer">Built with the play! framework</div>
</body>
</html>

其餘頁面使用#{extends}標籤能夠很是簡單地植入該裝飾模板，具體使用方法以下：併發

#{extends 'simpledesign.html' /}

#{set title:'A decorated page' /}
This content will be decorated.

該子模板使用#{extends 'simpledesign.html' /}標籤來繼承simpledesign.html，使用#{set title:'A decorated page' /}標籤傳遞頁面的title變量，最後在頁面中輸出This content will be decorated。mvc

三、內置標籤

#{a} Play須要經過路由器（逆向）生成URL，以此來調用指定的Action。框架封裝了HTML中的超連接標籤<a>，能夠方便地調用控制器中的Action，如：app

#{a @Application.index()} 首頁 #{/a}

#{authenticityToken /} 使用#{authenticityToken /}標籤能夠防止跨站請求僞造，同時也能消除刷新提交和後退提交所帶來的困擾。#{authenticityToken /}首先會爲服務器和客戶端表單生成相同的隨機令牌，並以隱藏的input輸入域的形式嵌入表單。當用戶點擊submit按鈕提交時，令牌會伴隨着表單信息一併發送至控制器中的Action，在Action對提交的表單進行處理前，會先進行令牌的比對，只有令牌信息一致時，才進行後續的表單處理操做。框架

#{authenticityToken /}

#{field} #{field}標籤的做用很是大，本着Play的「簡約」理念，#{field}標籤能夠幫助開發者減小同一變量名的重複使用：

#{field 'user.name'}
<p>
  <label>&{field.name}</label>
  <input type="text" id="${field.id}" name="${field.name}" value="${field.value}" class="${field.errorClass}">
  <span class="error">${field.error}</span>
</p>
#{/}

Field.name 是user.name， filed.value是user.name的值。Play提倡在頁面開發中儘可能使用#{field}標籤，而不是重複地編寫變量名。 #{i18n} i18n在模板中的用法比較特殊，不只能夠直接以標籤的形式用於模板語言，也能夠直接在JavaScript中調用。能夠在JavaScript代碼中使用i18n()方法來訪問本地化消息文件，如i18n('app_title')。引入

#{i18n /}

在Js中使用

alert(i18n('hello_world'));
alert(i18n('hello_someone', 'John'));

#{set}，#{get} #{set}標籤用於設置能夠在模板中使用的變量。如 #{set email:'china@oopsplay.org'}，就設置了模板變量email的值，能夠經過 #{get 'email'} 來獲取。#{set}標籤的定義中能夠引用其餘變量。

四、內置對象擴展

在模板引擎中使用Java對象是必不可少的，開發者還能夠爲其增長一些額外的方法。這些方法並無定義在原始的Java類中，而是模板引擎動態添加的。下面是一些比較有用的擴展：

${['red', 'green', 'blue'].join('/')} //合併 效果 red/green/blue
${['red', 'green', 'blue'].last()} //返回最後一個元素 ，效果 blue
${new Date(1275910970000).format('dd MMMM yyyy hh:mm:ss')} //07 June 2010 01:42:50
${new Date(new Date().getTime() - 1000000).since()} //多久以前 16 minutes ago
${1275910970000.asdate('dd MMMM yyyy hh:mm:ss', 'fr')} //07 juin 2010 01:42:50
${[id:'42', color:'red'].asAttr()} //屬性表示方式，效果 id="42" color="red" html
${42.format('000.00')} // 042.00
${42.page(10)} //頁數計算
${"lorum ipsum dolor".capAll()} // Lorum Ipsum Dolor
${"lorum ipsum dolor".cut('um')} // lor ips dolor
${"The <blink>tag</blink> is evil".escape().raw()} //The &lt;blink&gt;tag&lt;/blink&gt; is evil
${(["red", "green", "blue"] as String[]).add('pink').join(' ')} //red green blue pink
${(['red', 'green', 'blue'] as String[]).contains('green')} //true
${(['red', 'green', 'blue'] as String[]).remove('green').join(' ')} //red blue

五、內置對象

Play中全部的內置對象： errors 驗證錯誤信息結果集，對應play.data.validation.Validation.errors() flash Flash做用域，對應play.mvc.Scope.Flash lang 當前使用的語言，對應play.i18n.Lang messages 消息映射變量，對應play.i18n.Messages out 引用頁面輸出流，對應java.io.PrintWriter params 當前參數變量，對應play.mvc.Scope.Params play Play框架類，對應play.Play request 當前請求對象，對應play.mvc.Http.Request session Session做用域，對應play.mvc.Scope.Session

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。