Thymeleaf参考指南
  • Introduction
  • I. 使用Thymeleaf
    • 1 介绍Thymeleaf
      • 1.1 Thymeleaf是什么?
      • 1.2 Thymeleaf能处理什么类型的模版?
      • 1.3 方言:标准方言
    • 2 百里香虚拟杂货店
      • 2.1 杂货店网站
      • 2.2 创建和配置模板引擎
        • 模版解析器
        • 模版引擎
    • 3 使用文本
      • 3.1 多种语言显示欢迎
        • 使用th:text以及外部化文本
        • 上下文
        • 执行模版引擎
      • 3.2 与文本和变量有关的更多内容
        • 非转义文本
        • 使用和显示变量
    • 4 标准表达式语法
      • 4.1 信息
      • 4.2 变量
        • 表达式基本对象
        • 表达式工具对象
        • 重新格式化主页里的日期
      • 4.3 选择变量表达式(星号语法)
      • 4.4 链接URL
        • 主页的菜单栏
        • 服务器根相对路径
      • 4.5 分段
      • 4.6 字面量
        • 文本字面量
        • 数字字面量
        • 布尔字面量
        • null字面量
        • 字面量标记
      • 4.7 文本拼接
      • 4.8 字面量置换
      • 4.9 算术运算
      • 4.10 比较和相等
      • 4.11 条件表达式
      • 4.12 默认表达式(猫王运算符)
      • 4.13 无操作标记
      • 4.15 数据转换/格式化
      • 4.14 预处理
    • 5 设置属性值
      • 5.1 设置任何属性的值
      • 5.2 为指定的属性设置值
      • 5.3 一次设置多个值
      • 5.4 附加与前置
      • 5.5 定值布尔属性
      • 5.6 设置任何属性的值(默认的属性处理器)
      • 5.7 对HTML5友好的属性和元素名的支持
    • 6 遍历
      • 6.1 遍历基础
        • 使用th:each
        • 可遍历值
      • 6.2 保持遍历状态
      • 6.3 通过数据的懒惰检索实现优化
    • 7 条件求值
      • 7.1 简单条件:if与unless
      • 7.2 switch声明
    • 8 模版设计
      • 8.1 包含模版片段
        • 定义和引用片段
        • 片段规范语法
        • 不使用th:fragment引用片段
        • th:insert与th:replace(与th:include)的区别
      • 8.2 参数化片段签名
        • 不带片段参数的片段本地变量
        • th:assert——用于模板内断言
      • 8.3 弹性布局:超越片段插入
        • 使用空片段
        • 使用无操作标记
        • 片段的高级条件插入
      • 8.4 移除模版片段
    • 9 本地变量
    • 10 属性优先级
    • 11 注释与块
      • 11.1. 标准的HTML/XML注释
      • 11.2. Thymeleaf解析器级别注释块
      • 11.3. Thymeleaf原型注释块
      • 11.4. 人造th:block标签
    • 12 内联
      • 12.1. 表达式内联
        • 内联对战自然模版
        • 禁用内联
      • 12.2 文本内联
      • 12.3 JavaScript内联
        • JavaScript自然模版
        • 高级内联求值与JavaScript序列化
      • 12.4 CSS内联
        • 高级特性:CSS自然模版等
    • 13 文本模版模式
      • 13.1 文本语法
        • 转义的元素属性
      • 13.2 扩展性
      • 13.3 文本原型注释块:添加代码
      • 13.4 文本解析器级别注释块:移除代码
      • 13.5 自然JavaScript和CSS模版
    • 14 给我们的杂货店添加更多页面
      • 14.1 订单列表
      • 14.2 订单详情
    • 15 更多配置
      • 15.1 模板解析器
        • 链接模板解析器
      • 15.2 信息解析器
        • 标准信息解析器
        • 配置信息解析器
      • 15.3 转换服务
      • 15.4 日志记录
    • 16 模版缓存
    • 17 解耦的模版逻辑
      • 17.1 解耦的逻辑:概念
      • 17.2 配置解耦的模版
        • 启用解耦的模版
        • 混合耦合的与解耦的逻辑
      • 17.3 th:ref属性
      • 17.4 解耦的模板对性能的影响
      • 17.5 解耦的逻辑的解析
    • 18 附录A:表达基本对象
      • 基本对象
      • 请求或会话属性的网络上下文命名空间等
      • 网络上下文对象
    • 19 附录B:表达实用对象
      • 执行信息
      • 信息
      • URI/URL
      • 转换
      • 日期
      • 日历
      • 数字
      • 字符串
      • 对象
      • 布尔值
      • 数组
      • 列表
      • 集合
      • 映射
      • 合计
      • ID
    • 20 附录C:标记选择器语法
      • 多值类的匹配
Powered by GitBook
On this page

Was this helpful?

  1. I. 使用Thymeleaf

20 附录C:标记选择器语法

PreviousIDNext多值类的匹配

Last updated 6 years ago

Was this helpful?

Thymeleaf的标记选择器直接借自Thymeleaf的句法分析库:。

这些选择器的语法与XPath、CSS、jQuery里的选择器的语法很是相似。这使它们对大多数用户来说,容易上手。你可以在上看看完整的语法。

比如,下面的选择器会选择标记里的每个位置上,每一个带有class属性并且其值为content的<div>(注意这没有尽可能的简洁,继续读下去你就会知道为什么):

<div th:insert="mytemplate :: //div[@class='content']">...</div>

它的基本语法包括:

  • /x:当前名为x的节点的直接的子节点。

  • //x:当前名为x的节点在任何深度上的子节点。

  • x[@z="v"]:名为x的元素,并且此元素有名为z、值为“v”的属性。

  • x[@z1="v1" and @z2="v2"]:名为x的元素,并且此元素有名为z1、值为“v1”的属性和名为z2、值为“v2”的属性。

  • x[i]:在名为x的元素的同级节点上,位于数字i上的元素。

  • x[@z="v"][i]:在名为x、含有值为“v”的属性z的元素的同级节点上,位于数字i上的元素。

但是也可以使用更为简洁的语法:

  • x与//x完全等价(在任何深度上搜索名字或者引用为x的元素,当是th:ref或者th:fragment时则为引用)。

  • 选择器允许没有元素名/引用,只要它们包含有参数说明。所以,[@class='oneclass']是一个有效的选择器。它会寻找任何带有class属性并且值为"oneclass"的元素(标签)。

高级属性选择特性:

  • 除了=(相等),另外的比较运算符同样有效:!=(不相等),^=(以······开头)以及$=(以······结束)。例如:x[@class^='section']表示名为x,属性class的值以section开头的元素。

  • 属性既可以以@开头(XPath风格)的方式指定,也可以不加@(jQuery风格)。所以,x[z='v']与x[@z='v']是等价的。

  • 多属性修饰符可以用and(XPath风格)连接,也可以通过链接多个修饰符(jQuery风格)连接。所以,x[@z1='v1' and @z2='v2']实际上等价于 x[@z1='v1'][@z2='v2'](也等价于x[z1='v1'][z2='v2'])。

直接类jQuery选择器:

  • x.oneclass与x[class='oneclass']等价。

  • .oneclass与[class='oneclass']等价。

  • x#oneid与x[id='oneid']等价。

  • #oneid与[id='oneid']等价。

  • x%oneref的意思是带有th:ref="oneref"或者th:fragment="oneref"属性的<x>标签。

  • %oneref的意思是任何带有th:ref="oneref"或者th:fragment="oneref"属性的标签。注意,这实际上等同于简单的oneref。因为可以使用引用代替元素名。

  • 直接选择器和属性选择器可以混合使用:a.external[@href^='https']。

所以上面的标记选择器表达式:

<div th:insert="mytemplate :: //div[@class='content']">...</div>

可以这样写:

<div th:insert="mytemplate :: div.content">...</div>

测试另一个不同的例子:

<div th:replace="mytemplate :: myfrag">...</div>

它会寻找一个th:fragment="myfrag"片段签名(或者th:ref引用)。但是,如果存在名为myfrag的标签,也会寻找(在HTML里不会)。注意与下面的语句的不同:

<div th:replace="mytemplate :: .myfrag">...</div>

它实际上会寻找任何带有class="myfrag"的元素,并不会考虑th:fragment签名(或者th:ref引用)。

AttoParser
AttoParser文档