form1.cn
Make a little progress every day

Thymeleaf内置对象、定义变量、URL参数及标签自定义属性

12th of August 2017 Java Java 3288

如标题所述,这篇文章主要讲述Thymeleaf中的内置对象(list解析、日期格式化、数字格式化等)、定义变量、获取URL的参数和在页面标签中自定义属性的应用。

如果对Thymeleaf的基本使用、maven依赖等不清楚的可以先阅读我的另一篇文章《Thymeleaf 之 初步使用》。


Controller部份

@Controller
public class IndexController {
    @GetMapping(value = "index")
    public String index(Model model, HttpServletRequest request) {
        List<String> datas = new ArrayList<String>();
        datas.add("Form1");
        datas.add("http://www.form1.cn");
        datas.add("393156105");
        model.addAttribute("datas", datas);
        model.addAttribute("curDate", new Date());
        model.addAttribute("money", Math.random()*100);
        return "index";
    }
}


在这个控制器的Model中存放了这样几个数据:一个String类型的列表、一个日期对象和一个数值,这些东西在实际应用开发过程中应用非常广泛,下面具体看一下在Thymeleaf中是如何解析这些数据的。


日期格式化

<span th:text="${#dates.format(curDate, 'yyyy-MM-dd HH:mm:ss')}"></span>

说明: 使用内置对象dates的format函数即可对日期进行格式化,在format函数中,第一个参数是日期对象,对二两个参数为日期格式(规则跟SimpleDateFormat一样)


需要注意的是:

· 内置对象一般都以s结尾,如dates、lists、numbers等
· 在使用内置对象是在对象名前都需要加#号。


数字格式化

<span th:text="${#numbers.formatDecimal(money, 0, 2)}"></span>

说明: 此示例表示保留两位小数位,整数位自动;

<span th:text="${#numbers.formatDecimal(money, 3, 2)}"></span>

说明: 此示例表示保留两位小数位,3位整数位(不够的前加0)


获取列表长度

<span th:text="${#lists.size(datas)}"></span>

说明: 使用#lists.size来获取List的长度。


获取URL参数值

<span th:text="${#httpServletRequest.getParameter('page')}"></span>

说明: 当访问http://localhost:1105/index?page=5时页面将会得到page对应的值:5。


定义变量

<div th:with="curPage=${#httpServletRequest.getParameter('page')}">
    <h3>当前页码:<span th:text="${curPage}"></span></h3>
</div>

说明: 同样,当访问http://localhost:8888/index?page=5时,页面将显示:当前页码:5,说明用th:with来定义变量,多个用,号隔开,使用范围在当前标签内。


自定义标签属性

在Thymeleaf中可以使用th:加上标签的任何属性进行赋值,但有些时候会遇到自定义的属性,再用th:加自定义的属性则会无效。比如:需要对<span>标签增加objName和objId这样的属性,在非Thymeleaf情况下是这样:

<span objId="1" objName="知识林"></span>

变量情况是:

<span objId="${obj.id}" objName="${obj.name}"></span>

在Thymeleaf下则是:

<span th:attr="myDate=${#dates.format(curDate, 'yyyy-mm-dd')}, myMoney=${money}"></span>

说明: 在页面上查看源代码可以看到:<span myMoney="91.6059494319957" myDate="2016-31-02"></span>,说明自定义属性用:th:attr,多个属性用,隔开。


thymeleaf对于checked属性的判断

对于属性是有些特定值的,比如checked属性,thymeleaf都采用bool值,比如th:checked=${user.isActive}
这里,user.isActive=false时应该checked是不会出现这个attr的。
总的来说thymeleaf是不错的,但内联不是太好用,经常js的alert的时候,不得不把后半个括号换一行,如alert("aaa" + /[[#{message}]]*/'message');
这种情况,会把后面的);都删掉所以只能写成
alert("aaa" + /[[#{message}]]*/'message'
);


内置对象

上面简单描述了比较常用的dates、lists、numbers这几个内置对象,在Thymeleaf还有很多的内置对象,像strings也非常常用,用法跟Java.lang.String类的用法一样。


在Thymeleaf中的内置对象有:


#dates:日期格式化内置对象,具体方法可以参照java.util.Date;


#calendars:类似于#dates,但是是java.util.Calendar类的方法;


#numbers: 数字格式化;


#strings:字符串格式化,具体方法可以参照java.lang.String,如startsWith、contains等;


#objects:参照java.lang.Object;


#bools:判断boolean类型的工具;


#arrays:数组操作的工具;


#lists:列表操作的工具,参照java.util.List;


#sets:Set操作工具,参照java.util.Set;


#maps:Map操作工具,参照java.util.Map;


#aggregates:操作数组或集合的工具;


#messages:操作消息的工具。