片段规范语法

分段表达式的语法相当简单。有三种不同的格式:

  • 使用~{templatename::selector}包含片段。此片段在名为templatename的模版上应用指定的Markup Selector得到。注意:selector可以仅仅是一个片段名,所以你可以像上一节里的~{footer :: copy}一样,用~{templatename::fragmentname}简单地指定片段。

Markup Selector语法由底层的AttoParser解析库定义,与XPath表达式或者CSS选择器相似。详细情况请查看附录C

  • 使用~{templatename}包含名为templatename的整个模版。

注意:你在th:insert/th:replace标签里使用的模版名需要能够被模版引擎使用中的模版解析器解析。

  • 使用~{::selector}或者"~{this::selector}",包含同一个模版里匹配selector的片段。如果在此表达式出现的模版上找不到相同的选择器,模版调用(insertion)的栈会朝着最初处理的模版(root)遍历,直到在某一级别上匹配到 selector

上面例子里的templatenameselector可以是完全的表达式(甚至是条件表达式!),比如:

<div th:insert="footer :: (${user.isAdmin}? #{footer.admin} : #{footer.normaluser})"></div>

再次注意:在th:insert/th:replace里可以没有~{...}

片段可以包含任何的th:*属性。一旦片段被包含进目标模版(含有th:insert/th:replace属性),这些属性会被求值,并且它们可以引用定义在目标模版里的任何上下文变量。

这种学习片段的方法的好处是你可以在页面上写上你的片段--它们有着完整而且有效的标记结构,能被浏览器完美地表示。同时,可以让Thymeleaf把它们包含进其它模版。

Last updated