擴充套件Thymeleaf很容易:只需要建立一個方言並將其新增到模板引擎。 下面來看看，如何一步步地實現。
所有在這裡看到的程式碼都來自一個工作應用程式。可以從GitHub倉庫檢視或下載原始碼。
Thymeleaf方言(Dialects)是可以在模板中使用的一組功能。 這些功能包括:
#array，#dates等)，以執行可能需要的操作。所有這些功能都是可選的，方言只能指定其中的一部分。 例如，一個方言可能不需要指定任何處理器，但是可以宣告幾個表示式物件。
如果已經看到用標準方言編寫的程式碼片段，應該注意到，可處理的屬性以th:開頭。 這個「th」被稱為方言字首，這意味著由該方言處理的所有標籤和屬性將以這樣的字首開頭。 每種方言都可以指定自己的字首。
同樣重要的是要注意，一個模板引擎可以一次設定多個方言，從而允許處理包括來自所有指定方言的特徵的模板(將方言看作是一種JSP標籤庫)。 更重要的是，這些方言中的一些可以共用字首，有效地作為一種方言。
這裡將在應用程式中建立一個方言。 這將是一個Spring MVC應用程式，所以將要已經使用SpringStandard方言(更多細節參見Thymeleaf + Spring教學)。 但是想新增一個新的屬性，向請求的用戶端顯示問候語，如下所示:
<p hello:sayto="World">Hi ya!</p>
首先，需要建立屬性處理器來處理顯問候語訊息。
所有處理器都實現org.thymeleaf.processor.IProcessor介面，特別是標記處理器實現org.thymeleaf.processor.element.IElementTagProcessor介面，因為它是一個處理器，它適用於元素(以XML/HTML術語)，這種元素的開放標籤。
另外，這個處理器會被這個開放標籤(hello:sayto)中的指定屬性觸發，所以將擴充套件一個有用的抽象類，它將給出大部分的類基礎結構:org.thymeleaf.processor.element.AbstractAttributeTagProcessor。請參考下面程式碼的實現 -
public class SayToAttributeTagProcessor extends AbstractAttributeTagProcessor {
private static final String ATTR_NAME = "sayto";
private static final int PRECEDENCE = 10000;
public SayToAttributeTagProcessor(final String dialectPrefix) {
super(
TemplateMode.HTML, // This processor will apply only to HTML mode
dialectPrefix, // Prefix to be applied to name for matching
null, // No tag name: match any tag name
false, // No prefix to be applied to tag name
ATTR_NAME, // Name of the attribute that will be matched
true, // Apply dialect prefix to attribute name
PRECEDENCE, // Precedence (inside dialect's precedence)
true); // Remove the matched attribute afterwards
}
protected void doProcess(
final ITemplateContext context, final IProcessableElementTag tag,
final AttributeName attributeName, final String attributeValue,
final IElementTagStructureHandler structureHandler) {
structureHandler.setBody(
"Hello, " + HtmlEscape.escapeHtml5(attributeValue) + "!", false);
}
}
建立處理器非常簡單，但現在還需要建立方言類，負責告訴Thymeleaf處理器是可用的。
最基本的方言介面:org.thymeleaf.dialect.IDialect只告訴Thymeleaf一個特定的類是方言。 但是引擎需要知道那個建立的方言能夠提供什麼，並且宣告方言類,需要實現一組或幾組IDialect子介面。
具體來說，out方言將提供*處理器，因此它將實現org.thymeleaf.dialect.IProcessorDialect。 為了更容易一些，這裡不是直接實現介面，而是擴充套件一個名為org.thymeleaf.dialect.AbstractProcessorDialect的抽象類，參考以下程式碼:
public class HelloDialect extends AbstractProcessorDialect {
public HelloDialect() {
super(
"Hello Dialect", // Dialect name
"hello", // Dialect prefix (hello:*)
1000); // Dialect precedence
}
/*
* Initialize the dialect's processors.
*
* Note the dialect prefix is passed here because, although we set
* "hello" to be the dialect's prefix at the constructor, that only
* works as a default, and at engine configuration time the user
* might have chosen a different prefix to be used.
*/
public Set<IProcessor> getProcessors(final String dialectPrefix) {
final Set<IProcessor> processors = new HashSet<IProcessor>();
processors.add(new SayToAttributeTagProcessor(dialectPrefix));
return processors;
}
}
使用上面建立這個新方言非常簡單。 這是一個Spring MVC應用程式，只需在組態期間將它新增到templateEngine Bean。如下程式碼所示 -
@Bean
public SpringTemplateEngine templateEngine(){
SpringTemplateEngine templateEngine = new SpringTemplateEngine();
templateEngine.setEnableSpringELCompiler(true);
templateEngine.setTemplateResolver(templateResolver());
templateEngine.addDialect(new HelloDialect());
return templateEngine;
}
請注意，通過使用addDialect(),而不是setDialect()，告訴引擎除了預設的StandardDialect之外，還想使用新的方言。 所以所有的標準th:*屬性也將可用。
現在需要新屬性可以無縫工作，如下:
<p>Hello World!</p>