Thymeleaf模板引擎的编写

Thymeleaf-模板引擎的编写

Thymeleaf 简介

Thymeleaf 是一个跟 Velocity、FreeMarker 类似的模板引擎，它可以完全替代 JSP 。相较与其他的模板引擎，它有如下三个极吸引人的特点：

1，Thymeleaf 在有网络和无网络的环境下皆可运行，即它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型，然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性，所以 thymeleaf 的模板可以静态地运行；当有数据返回到页面时，Thymeleaf 标签会动态地替换掉静态内容，使页面动态显示。

2，Thymeleaf 开箱即用的特性。它提供标准和spring标准两种方言，可以直接套用模板实现JSTL、 OGNL表达式效果，避免每天套模板、该jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。

3.，Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块，可以快速的实现表单绑定、属性编辑器、国际化等功能。

 

Hello Thymeleaf实例

1，创建Maven项目

2，添加Spring的依赖

3，修改pom.xml文件，加入Thymeleaf

    org.thymeleaf
    thymeleaf
    2.1.4.RELEASE


    org.thymeleaf
    thymeleaf-spring4
    2.1.4.RELEASE

4，在Spring MVC配置文件中添加thymeleaf视图解释器

关闭Thymeleaf页面的缓存，可以让对页面的改动及时反映到视图中。

5，创建一个页面

html页面标签中引入如下：

具体html页面如下：

index


    Hello Thymeleaf!

6、创建一个Controller

@Controller
@RequestMapping("/index")
public class IndexController {
    
    @RequestMapping("returnString")
    public String returnString(){
        return "index";
    }
}

7，运行项目访问IndexController

 

页面参数获取/回显

1，创建一个pojo

public class Person {
    private int id;
    private String name;
    private String addrs;
    public Person(int id, String name, String addrs) {
        super();
        this.id = id;
        this.name = name;
        this.addrs = addrs;
    }
    public Person() {
        super();
    }
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getAddrs() {
        return addrs;
    }
    public void setAddrs(String addrs) {
        this.addrs = addrs;
    }
    @Override
    public String toString() {
        return "Person [id=" + id + ", name=" + name + ", addrs=" + addrs + "]";
    }
}

2，创建提交表单页面person.html

person





    
        

            id 
            

                
            
        
        

            名称
            

                
            
        
        

            地址
            

                
            
        
        

            

                提交
            
        
    

解释：

th:action属性

表示其值代替静态页面的action的值。等价action='/savePerson'。

th:method属性

表示其值将代替静态页面的method的值。等价method='post'。

3，创建回显页面return.html

return





    
    from表单获取提交过来的数据
    
        

            id 
            

                
            
        
        

            名称
            

                
            
        
        

            地址
            

                
            
        
        

            

                提交
            
        
    
    
    表格获取提交过来的数据 
    
      
        id
        name
        addrs
      
      
        
        
        
      
    

解释：

th:object属性

表示有一个属性名为"person"的Java bean传递到页面上来。可以通过表达式*{fieldName}才能取得其值。

th:value属性

表示取得Person实例中的属性值，也就是通过调用Java bean的get方法获得。等价于标签value='xxx'

th:text属性

文本显示。等价于标签text='xxx'

4，创建PersonController

@Controller
public class PersonController {
    @RequestMapping
    public String returnString(){
        return "person";
    }
    
    @RequestMapping("/savePerson")
    public String savePerson(Model Model ,Person person){
        Model.addAttribute("person", person);
        return "return";
    }
}

运行访问：http://localhost:8081/Thymeleaf/，点击提交

运行结果：

 

 

基本表达式

1，${}

变量表达式（美元表达式），用于访问容器上下文环境中的数据，功能与jstl中${}的相同。

2，*{}

选择表达式（星号表达式），获取选定对象里的数据域（th:object属性用于绑定对象）。

选择表达式与变量表达式的区别：

选择表达式计算的是选定的对象，而不是整个环境变量映射。也就是：只要是没有选择的对象，选择表达式与变量表达式的语法是完全一样的。

from表单获取提交过来的数据

    

        id 
        

            
        
    
    

        名称
        

            
        
    
    

        地址
        

            
        
    
    

        

            提交
        
    

3，#{}

没明白怎么使用！自己测试不出来。希望看见的大佬能指点迷津。

4，@{}

超链接url表达式。

 

常用属性

1，th:action

定义后台控制器路径，类似标签的action属性。 2，th:each

对象遍历，功能类似jstl中的标签

Controller

@RequestMapping("/listPerson")
public String listPerson(Model Model){
    List list = new ArrayList();
    list.add(new Person(1, "Zender", "Shanghai"));
    list.add(new Person(2, "Zender2", "Shanghai2"));
    list.add(new Person(3, "Zender3", "Shanghai3"));
    Model.addAttribute("listPerson", list);
    return "listPerson";
}

listPerson





    each循环
    
      
        id
        name
        addrs
      
      
          
            
            
            
          
      
    

personStat称作状态变量，属性有：

3，th:field

常用于表单字段绑定。通常与th:object一起使用。 属性绑定、集合绑定。

Controller

@RequestMapping("/person")
public String returnString(){
    return "person";
}
 
@RequestMapping("/savePerson")
public String savePerson(Model Model ,Person person){
    Model.addAttribute("person", person);
    return "return";
}

表单页面

    

        id 
        

            
        
    
    

        名称
        

            
        
    
    

        地址
        

            
        
    
    

        

            提交
        
    

回显页面

from表单获取提交过来的数据

    

        id 
        

            
        
    
    

        名称
        

            
        
    
    

        地址
        

            
        
    
    

        

            提交
        
    

4，th:href

定义超链接。

5，th:id

id声明，类似html标签中的id属性。

6，th:if，th:unless

th:if条件判断，th:if中条件成立时才显示。

th:unless于th:if恰好相反，表达式中的条件不成立，才会显示其内容。

123

7，th:include，th:replace和th:fragment

模板文件footer.html：

    Copyright ©2018 Zender


    头部 Zender

页面index.html

    

    Hello Thymeleaf!
    

文件路径

 

访问

 

8，th:src

用于外部资源引入，类似于标签的src属性，常与@{}一起使用。

9，th:text

文本显示。

10，th:value

用于标签复制，类似标签的value属性。

11，th:switch

默认属性default可以用*表示。

  
User is an administrator
  
User is a manager
  
User is some other thing

 

常用属性表格：

关键字

功能介绍

案例

th:id

替换id

th:text

文本替换

description

th:utext

支持html的文本替换

conten

th:object

替换对象