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
  • ~{...} 代码块表达式,支持两种语法结构

    推荐:~{templatename::fragmentname}     支持:~{templatename::#id}   templatename:模版名,Thymeleaf会根据模版名解析完整路径:/resources/templates/templatename.html,要注意文件的路径。 fragmentname:片段名,Thymeleaf通过th:fragment声明定义代码块,即:th:fragment="fragmentname" id:HTML的id选择器,使用时要在前面加上#号,不支持class选择器。

代码块表达式的使用

代码块表达式需要配合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 }