play 内置标签

---

标签使用说明

1 标签皆可应用在页面和js代码中
2 使用?.可避免当对象为空时出现NullPointerException导致页面渲染失败
3 取值使用${}格式

${flash?.errCode}//从flash对象中取值
${jumpUrl}//action返回页面参数
${session?.user?.userName}//从session中获取用户名

4 可通过指定全限定类名直接调用静态方法、字段等

${utils.DateUtils?.getTime()}//通过调用DateUtils中的静态方法获取当前时间
${utils.DateUtils?.FORMAT_YMD}//获取DateUtils中的字段值

5 闭合标签#{a}首页#{/a}，非闭合标签#{input /}
6 注释使用%{注释文本}%

---

常用标签

• a：链接到router表中对应的路由

#{a @Application.index()}首页#{/a} 
[首页](“@{Application.index()}”)
[首页](“application/index”)

• authenticityToken： 用来生成一个包含token信息的可以放到任何form的隐藏域,用来防止跨站点的请求伪造攻击。后台form提交路由函数中直接调用checkAuthenticity()，校验不通过会跳转到默认的错误页面。

#{authenticityToken /} 
   

• doLayout： 模板继承标签，子元素通过#{extends '父元素相对路径'/}来进行页面的嵌套

    
头部
    
    #{doLayout /}
    
底部

• extends：继承父标签

#{extends 'common/common.html' /}
子页面内容区

• if...else：用来在页面中进行逻辑判断，if可单用也可配合使用，可用页面js中

#{if user==null}登录#{/if}
#{elseif user!=null && !user?.auther}认证#{/elseif}
#{else}登录成功#{/else}

• list：用来迭代后台集合数据,items指定集合数据，as指定别名

#if{userList!=null && userList.size()>0}
#{list items:userList,as:'user'}
    
        ${user_index}//本次迭代的索引值
        ${(page?.currPage - 1)*page?.pageSize+_index}//分页数据中的索引值
        ${user?.name}
        ...
    
#{/list}
#{/if}
或者
#if{userList!=null && userList.size()>0}
#{list items:userList}
    
        ${user_index}//本次迭代的索引值
        ${(page?.currPage - 1)*page?.pageSize+_index}//分页数据中的索引值
        ${_?.name}
        ...
    
#{/list}
#{/if}

• %{}：代码块，可用来直接编写源代码，可直接在页面通过${}引用

%{utils.DateUtils date = new utils.DateUtils();}%
# ${date?.currentTime()?.format('yyyy-MM-dd HH:mm:ss')
# ${constants.Constants.money?.format('###,##0.00')}
# ${constants.Constants.money?.formatCurrency('CNY')}

输入图片说明

• get|set

#{set title:'标题'/}
#{get 'title'/}

• @{‘’}：静态资料导入标签
  

• form：表单
  #{form @login(), method:'POST', id:'sub'} #{/form}

• include：类似jsp中的include标签
  #{include 'Application/index.html'/}

---

标签内置常用函数

• format()：格式化日期、金额等

${money?.format('###,##0.00')}
${money?.formatCurrency('CNY')}
${date?.format('yyyy-MM-dd HH:mm:ss')}

• raw()：以html格式显示
  ${content?.raw()}

---