Thymeleaf With Dialect
A dialect for Thymeleaf that allows you to use attributes with a "with" prefix to avoid having long "th:with"-expressions.
Requirements
- Java 5
- Thymeleaf 3.0.0+ (3.0.0.RELEASE and its dependencies included)
Installation
For Maven and Maven-compatible dependency managers
Add a dependency to your project with the following co-ordinates:
- GroupId:
ch.mfrey.thymeleaf.extras.with - ArtifactId:
thymeleaf-with-dialect - Version:
${thymeleaf-with-dialect.version}
Usage
Add the With dialect to your existing Thymeleaf template engine, eg:
ServletContextTemplateResolver templateresolver = new ServletContextTemplateResolver();
templateresolver.setTemplateMode(TemplateMode.HTML);
templateengine = new TemplateEngine();
templateengine.setTemplateResolver(templateresolver);
templateengine.addDialect(new WithDialect()); // This line adds the dialect to ThymeleafOr, for those using Spring configuration files:
<bean id="templateResolver" class="org.thymeleaf.templateresolver.ServletContextTemplateResolver">
<property name="templateMode" value="HTML5"/>
</bean>
<bean id="templateEngine" class="org.thymeleaf.spring3.SpringTemplateEngine">
<property name="templateResolver" ref="templateResolver"/>
<!-- These lines add the dialect to Thymeleaf -->
<property name="additionalDialects">
<set>
<bean class="ch.mfrey.thymeleaf.extras.with.WithDialect" />
</set>
</property>
</bean>Use it
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
xmlns:with="http://www.thymeleaf.org/extras/with">
<head></head>
<body>
<div with:isActive="${true}"
with:hello="'Hello'"
with:helloWorld="${hello} + ' World'"
with:helloUnderWorld="${hello + ' Under World'}"
with:someCalc="${2 + 4}"
with:moreCalc="${someCalc + 10}">
<div th:text="${isActive}">true</div>
<div th:text="${hello}">Hello</div>
<div th:text="${helloWorld}">Hello World</div>
<div th:text="${helloUnderWorld}">Hello Under World</div>
<div th:text="${someCalc}">6</div>
<div th:text="${moreCalc}">16</div>
<div with:evenMoreCalc="${moreCalc + 5}" th:text="${evenMoreCalc}">21</div>
</div>
</body>
</html>Changelog
0.0.1-SNAPSHOT
- Initial commit.
1.0.0
- Considered stable
- Changed groupid
2.0.0
- Working against Thymeleaf 2.1.0+
3.0.0-SNAPSHOT
- Working against Thymeleaf 3.0.0.RELEASE