Thymeleaf语法总结 | 笔记分享
Thymeleaf语法总结
一、Thymeleaf介绍
Thymeleaf是Spring boot推荐使用的模版引擎,直接以html显示,前后端可以很好的分离。
二、Thymeleaf语法(Thymeleaf3)
在使用Thymeleaf时页面要引入名称空间: xmlns:th="http://www.thymeleaf.org" 1、th属性,常用th属性如下: 1)th:text:文本替换;
2)th:utext:支持html的文本替换。
3)th:value:属性赋值
4)th:each:遍历循环元素
//每次遍历都会产生th:each所标注的标签以及内部标签
Onions
2.41
5)th:if:判断条件,类似的还有th:unless,th:switch,th:case
你填的是true
//这里引用了一个th:if指令,跟vue中的v-if类似
6)th:insert:代码块引入,类似的还有th:replace,th:include,常用于公共代码块提取的场景
7)th:fragment:定义代码块,方便被th:insert引用
8)th:object:声明变量,一般和*{}一起配合使用,达到偷懒的效果。
Name: Jack.
Age: 21.
friend: Rose.
9)th:attr:设置标签属性,多个属性可以用逗号分隔
例子:
前端HTML
Thymeleaf 语法
ITDragon Thymeleaf 语法
ID:
TH:
DE:
后台controller:
@Controller
public class ThymeleafController {
@RequestMapping("thymeleaf")
public String thymeleaf(ModelMap map) {
map.put("thText", "th:text 设置文本内容 加粗");
map.put("thUText", "th:utext 设置文本内容 加粗");
map.put("thValue", "thValue 设置当前元素的value值");
map.put("thEach", Arrays.asList("th:each", "遍历列表"));
map.put("thIf", "msg is not null");
map.put("thObject", new ThObject(1L, "th:object", "用来偷懒的th属性"));
return "grammar/thymeleaf";
}
}
2、标准表达式语法:
- ${...} 变量表达式,Variable Expressions
- @{...} 链接表达式,Link URL Expressions
- #{...} 消息表达式,Message Expressions
- ~{...} 代码块表达式,Fragment Expressions
- *{...} 选择变量表达式,Selection Variable Expressions
-
~{...} 代码块表达式,支持两种语法结构
代码块表达式的使用
代码块表达式需要配合th属性(th:insert,th:replace,th:include)一起使用。 th:insert:将代码块片段整个插入到使用了th:insert的HTML标签中, th:replace:将代码块片段整个替换使用了th:replace的HTML标签中, th:include:将代码块片段包含的内容插入到使用了th:include的HTML标签中,#{...} 消息表达式
消息表达式一般用于国际化的场景。@{...} 链接表达式
链接表达式好处 不管是静态资源的引用,form表单的请求,凡是链接都可以用@{...} 。这样可以动态获取项目路径,即便项目名变了,依然可以正常访问 #修改项目名,链接表达式会自动修改路径,避免资源文件找不到 server.context-path=/itdragon 链接表达式结构 无参:@{/xxx} 有参:@{/xxx(k1=v1,k2=v2)} 对应url结构:xxx?k1=v1&k2=v2 引入本地资源:@{/项目本地的资源路径} 引入外部资源:@{/webjars/资源在jar包中的路径} 列举:
${...} 变量表达式功能
一、可以获取对象的属性和方法 二、可以使用ctx,vars,locale,request,response,session,servletContext内置对象 三、可以使用dates,numbers,strings,objects,arrays,lists,sets,maps等内置方法(重点介绍)常用的内置对象
一、ctx :上下文对象。 二、vars :上下文变量。 三、locale:上下文的语言环境。 四、request:(仅在web上下文)的 HttpServletRequest 对象。 五、response:(仅在web上下文)的 HttpServletResponse 对象。 六、session:(仅在web上下文)的 HttpSession 对象。 七、servletContext:(仅在web上下文)的 ServletContext 对象 这里以常用的Session举例,用户刊登成功后,会把用户信息放在Session中,Thymeleaf通过内置对象将值从session中获取。 // java 代码将用户名放在session中 session.setAttribute("userinfo",username); // Thymeleaf通过内置对象直接获取 th:text="${session.userinfo}"常用的内置方法
一、strings:字符串格式化方法,常用的Java方法它都有。比如:equals,equalsIgnoreCase,length,trim,toUpperCase,toLowerCase,indexOf,substring,replace,startsWith,endsWith,contains,containsIgnoreCase等 二、numbers:数值格式化方法,常用的方法有:formatDecimal等 三、bools:布尔方法,常用的方法有:isTrue,isFalse等 四、arrays:数组方法,常用的方法有:toArray,length,isEmpty,contains,containsAll等 五、lists,sets:集合方法,常用的方法有:toList,size,isEmpty,contains,containsAll,sort等 六、maps:对象方法,常用的方法有:size,isEmpty,containsKey,containsValue等 七、dates:日期方法,常用的方法有:format,year,month,hour,createNow等 1
2
3 ITDragon Thymeleaf 内置方法
4 ITDragon Thymeleaf 内置方法
5 #strings
6
7 Old Str :
8 toUpperCase :
9 toLowerCase :
10 equals :
11 equalsIgnoreCase :
12
13 indexOf :
14 substring :
15 replace :
16 startsWith :
17 contains :
18
19
20 #numbers
21
22 formatDecimal 整数部分随意,小数点后保留两位,四舍五入:
23
24 formatDecimal 整数部分保留五位数,小数点后保留两位,四舍五入:
25
26
27
28 #bools
29
30
31
32
33 #arrays
34
35 length :
36 contains :
37 containsAll :
38
39 #lists
40
41 size :
42 contains :
43 sort :
44
45 #maps
46
47 size :
48 containsKey :
49 containsValue :
50
51 #dates
52
53 format :
54 custom format :
55 day :
56 month :
57 monthName :
58 year :
59 dayOfWeekName :
60 hour :
61 minute :
62 second :
63 createNow :
64
1 @RequestMapping("varexpressions")public String varexpressions(ModelMap map) {
2 map.put("itdragonStr", "itdragonBlog");
3 map.put("itdragonBool", true);
4 map.put("itdragonArray", new Integer[]{1,2,3,4});
5 map.put("itdragonList", Arrays.asList(1,3,2,4,0));
6 Map itdragonMap = new HashMap();
7 itdragonMap.put("thName", "${#...}");
8 itdragonMap.put("desc", "变量表达式内置方法");
9 map.put("itdragonMap", itdragonMap);
10 map.put("itdragonDate", new Date());
11 map.put("itdragonNum", 888.888D); return "grammar/varexpressions";
12 }