一.简单表达格式:
1.变量的表达式：${...}
2.选择变量表达式：*{...}
3.信息表达:#{...}
4.链接URL表达式:@{...}
二.字面值
1.文本文字：'one text', 'Another one!',…
2.文字数量：0, 34, 3.0, 12.3,…
3.布尔型常量：true, false
4.空的文字：null
5.文字标记：one, sometext, main,…
四：文本处理
1.字符串并置：+
2.文字替换：|The name is ${name}|
五.表达基本对象
1.#ctx:上下文对象
2.#vars:上下文变量
3.#locale:上下文语言环境
4.#httpServletRequest:(只有在Web上下文)HttpServletRequest对象
5.#httpSession:(只有在Web上下文)HttpSession对象。
用法：
US. 六.实用表达对象
#dates: java.util的实用方法。对象:日期格式、组件提取等.#calendars: 类似于#日期,但对于java.util。日历对象#numbers: 格式化数字对象的实用方法。#strings:字符串对象的实用方法:包含startsWith,将/附加等。#objects: 实用方法的对象。#bools: 布尔评价的实用方法。#arrays: 数组的实用方法。#lists: list集合。#sets:set集合。#maps: map集合。#aggregates: 实用程序方法用于创建聚集在数组或集合.#messages: 实用程序方法获取外部信息内部变量表达式,以同样的方式,因为他们将获得使用# {…}语法#ids: 实用程序方法来处理可能重复的id属性(例如,由于迭代)。Dates#dates : utility methods for java.util.Date objects:/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Dates * ====================================================================== *//* * Null-safe toString() */${#strings.toString(obj)} // also array*, list* and set*/* * Format date with the standard locale format * Also works with arrays, lists or sets */${#dates.format(date)}${#dates.arrayFormat(datesArray)}${#dates.listFormat(datesList)}${#dates.setFormat(datesSet)}/* * Format date with the specified pattern * Also works with arrays, lists or sets */${#dates.format(date, 'dd/MMM/yyyy HH:mm')}${#dates.arrayFormat(datesArray, 'dd/MMM/yyyy HH:mm')}${#dates.listFormat(datesList, 'dd/MMM/yyyy HH:mm')}${#dates.setFormat(datesSet, 'dd/MMM/yyyy HH:mm')}/* * Obtain date properties * Also works with arrays, lists or sets */${#dates.day(date)} // also arrayDay(...), listDay(...), etc.${#dates.month(date)} // also arrayMonth(...), listMonth(...), etc.${#dates.monthName(date)} // also arrayMonthName(...), listMonthName(...), etc.${#dates.monthNameShort(date)} // also arrayMonthNameShort(...), listMonthNameShort(...), etc.${#dates.year(date)} // also arrayYear(...), listYear(...), etc.${#dates.dayOfWeek(date)} // also arrayDayOfWeek(...), listDayOfWeek(...), etc.${#dates.dayOfWeekName(date)} // also arrayDayOfWeekName(...), listDayOfWeekName(...), etc.${#dates.dayOfWeekNameShort(date)} // also arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...), etc.${#dates.hour(date)} // also arrayHour(...), listHour(...), etc.${#dates.minute(date)} // also arrayMinute(...), listMinute(...), etc.${#dates.second(date)} // also arraySecond(...), listSecond(...), etc.${#dates.millisecond(date)} // also arrayMillisecond(...), listMillisecond(...), etc./* * Create date (java.util.Date) objects from its components */${#dates.create(year,month,day)}${#dates.create(year,month,day,hour,minute)}${#dates.create(year,month,day,hour,minute,second)}${#dates.create(year,month,day,hour,minute,second,millisecond)}/* * Create a date (java.util.Date) object for the current date and time */${#dates.createNow()}/* * Create a date (java.util.Date) object for the current date (time set to 00:00) */${#dates.createToday()}Calendars#calendars : analogous to #dates, but for java.util.Calendar objects:/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Calendars * ====================================================================== *//* * Format calendar with the standard locale format * Also works with arrays, lists or sets */${#calendars.format(cal)}${#calendars.arrayFormat(calArray)}${#calendars.listFormat(calList)}${#calendars.setFormat(calSet)}/* * Format calendar with the specified pattern * Also works with arrays, lists or sets */${#calendars.format(cal, 'dd/MMM/yyyy HH:mm')}${#calendars.arrayFormat(calArray, 'dd/MMM/yyyy HH:mm')}${#calendars.listFormat(calList, 'dd/MMM/yyyy HH:mm')}${#calendars.setFormat(calSet, 'dd/MMM/yyyy HH:mm')}/* * Obtain calendar properties * Also works with arrays, lists or sets */${#calendars.day(date)} // also arrayDay(...), listDay(...), etc.${#calendars.month(date)} // also arrayMonth(...), listMonth(...), etc.${#calendars.monthName(date)} // also arrayMonthName(...), listMonthName(...), etc.${#calendars.monthNameShort(date)} // also arrayMonthNameShort(...), listMonthNameShort(...), etc.${#calendars.year(date)} // also arrayYear(...), listYear(...), etc.${#calendars.dayOfWeek(date)} // also arrayDayOfWeek(...), listDayOfWeek(...), etc.${#calendars.dayOfWeekName(date)} // also arrayDayOfWeekName(...), listDayOfWeekName(...), etc.${#calendars.dayOfWeekNameShort(date)} // also arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...), etc.${#calendars.hour(date)} // also arrayHour(...), listHour(...), etc.${#calendars.minute(date)} // also arrayMinute(...), listMinute(...), etc.${#calendars.second(date)} // also arraySecond(...), listSecond(...), etc.${#calendars.millisecond(date)} // also arrayMillisecond(...), listMillisecond(...), etc./* * Create calendar (java.util.Calendar) objects from its components */${#calendars.create(year,month,day)}${#calendars.create(year,month,day,hour,minute)}${#calendars.create(year,month,day,hour,minute,second)}${#calendars.create(year,month,day,hour,minute,second,millisecond)}/* * Create a calendar (java.util.Calendar) object for the current date and time */${#calendars.createNow()}/* * Create a calendar (java.util.Calendar) object for the current date (time set to 00:00) */${#calendars.createToday()}Numbers#numbers : utility methods for number objects:/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Numbers * ====================================================================== *//* * ========================== * Formatting integer numbers * ========================== *//* * Set minimum integer digits. * Also works with arrays, lists or sets */${#numbers.formatInteger(num,3)}${#numbers.arrayFormatInteger(numArray,3)}${#numbers.listFormatInteger(numList,3)}${#numbers.setFormatInteger(numSet,3)}/* * Set minimum integer digits and thousands separator: * 'POINT', 'COMMA', 'NONE' or 'DEFAULT' (by locale). * Also works with arrays, lists or sets */${#numbers.formatInteger(num,3,'POINT')}${#numbers.arrayFormatInteger(numArray,3,'POINT')}${#numbers.listFormatInteger(numList,3,'POINT')}${#numbers.setFormatInteger(numSet,3,'POINT')}/* * ========================== * Formatting decimal numbers * ========================== *//* * Set minimum integer digits and (exact) decimal digits. * Also works with arrays, lists or sets */${#numbers.formatDecimal(num,3,2)}${#numbers.arrayFormatDecimal(numArray,3,2)}${#numbers.listFormatDecimal(numList,3,2)}${#numbers.setFormatDecimal(numSet,3,2)}/* * Set minimum integer digits and (exact) decimal digits, and also decimal separator. * Also works with arrays, lists or sets */${#numbers.formatDecimal(num,3,2,'COMMA')}${#numbers.arrayFormatDecimal(numArray,3,2,'COMMA')}${#numbers.listFormatDecimal(numList,3,2,'COMMA')}${#numbers.setFormatDecimal(numSet,3,2,'COMMA')}/* * Set minimum integer digits and (exact) decimal digits, and also thousands and * decimal separator. * Also works with arrays, lists or sets */${#numbers.formatDecimal(num,3,'POINT',2,'COMMA')}${#numbers.arrayFormatDecimal(numArray,3,'POINT',2,'COMMA')}${#numbers.listFormatDecimal(numList,3,'POINT',2,'COMMA')}${#numbers.setFormatDecimal(numSet,3,'POINT',2,'COMMA')}/* * ========================== * Utility methods * ========================== *//* * Create a sequence (array) of integer numbers going * from x to y */${#numbers.sequence(from,to)}${#numbers.sequence(from,to,step)}Strings#strings : utility methods for String objects:/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Strings * ====================================================================== *//* * Check whether a String is empty (or null). Performs a trim() operation before check * Also works with arrays, lists or sets */${#strings.isEmpty(name)}${#strings.arrayIsEmpty(nameArr)}${#strings.listIsEmpty(nameList)}${#strings.setIsEmpty(nameSet)}/* * Perform an 'isEmpty()' check on a string and return it if false, defaulting to * another specified string if true. * Also works with arrays, lists or sets */${#strings.defaultString(text,default)}${#strings.arrayDefaultString(textArr,default)}${#strings.listDefaultString(textList,default)}${#strings.setDefaultString(textSet,default)}/* * Check whether a fragment is contained in a String * Also works with arrays, lists or sets */${#strings.contains(name,'ez')} // also array*, list* and set*${#strings.containsIgnoreCase(name,'ez')} // also array*, list* and set*/* * Check whether a String starts or ends with a fragment * Also works with arrays, lists or sets */${#strings.startsWith(name,'Don')} // also array*, list* and set*${#strings.endsWith(name,endingFragment)} // also array*, list* and set*/* * Substring-related operations * Also works with arrays, lists or sets */${#strings.indexOf(name,frag)} // also array*, list* and set*${#strings.substring(name,3,5)} // also array*, list* and set*${#strings.substringAfter(name,prefix)} // also array*, list* and set*${#strings.substringBefore(name,suffix)} // also array*, list* and set*${#strings.replace(name,'las','ler')} // also array*, list* and set*/* * Append and prepend * Also works with arrays, lists or sets */${#strings.prepend(str,prefix)} // also array*, list* and set*${#strings.append(str,suffix)} // also array*, list* and set*/* * Change case * Also works with arrays, lists or sets */${#strings.toUpperCase(name)} // also array*, list* and set*${#strings.toLowerCase(name)} // also array*, list* and set*/* * Split and join */${#strings.arrayJoin(namesArray,',')}${#strings.listJoin(namesList,',')}${#strings.setJoin(namesSet,',')}${#strings.arraySplit(namesStr,',')} // returns String[]${#strings.listSplit(namesStr,',')} // returns List${#strings.setSplit(namesStr,',')} // returns Set /* * Trim * Also works with arrays, lists or sets */${#strings.trim(str)} // also array*, list* and set*/* * Compute length * Also works with arrays, lists or sets */${#strings.length(str)} // also array*, list* and set*/* * Abbreviate text making it have a maximum size of n. If text is bigger, it * will be clipped and finished in "..." * Also works with arrays, lists or sets */${#strings.abbreviate(str,10)} // also array*, list* and set*/* * Convert the first character to upper-case (and vice-versa) */${#strings.capitalize(str)} // also array*, list* and set*${#strings.unCapitalize(str)} // also array*, list* and set*/* * Convert the first character of every word to upper-case */${#strings.capitalizeWords(str)} // also array*, list* and set*${#strings.capitalizeWords(str,delimiters)} // also array*, list* and set*/* * Escape the string */${#strings.escapeXml(str)} // also array*, list* and set*${#strings.escapeJava(str)} // also array*, list* and set*${#strings.escapeJavaScript(str)} // also array*, list* and set*${#strings.unescapeJava(str)} // also array*, list* and set*${#strings.unescapeJavaScript(str)} // also array*, list* and set*/* * Null-safe comparison and concatenation */${#strings.equals(str)}${#strings.equalsIgnoreCase(str)}${#strings.concat(str)}${#strings.concatReplaceNulls(str)}/* * Random */${#strings.randomAlphanumeric(count)}Objects#objects : utility methods for objects in general/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Objects * ====================================================================== *//* * Return obj if it is not null, and default otherwise * Also works with arrays, lists or sets */${#objects.nullSafe(obj,default)}${#objects.arrayNullSafe(objArray,default)}${#objects.listNullSafe(objList,default)}${#objects.setNullSafe(objSet,default)}Booleans#bools : utility methods for boolean evaluation/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Bools * ====================================================================== *//* * Evaluate a condition in the same way that it would be evaluated in a th:if tag * (see conditional evaluation chapter afterwards). * Also works with arrays, lists or sets */${#bools.isTrue(obj)}${#bools.arrayIsTrue(objArray)}${#bools.listIsTrue(objList)}${#bools.setIsTrue(objSet)}/* * Evaluate with negation * Also works with arrays, lists or sets */${#bools.isFalse(cond)}${#bools.arrayIsFalse(condArray)}${#bools.listIsFalse(condList)}${#bools.setIsFalse(condSet)}/* * Evaluate and apply AND operator * Receive an array, a list or a set as parameter */${#bools.arrayAnd(condArray)}${#bools.listAnd(condList)}${#bools.setAnd(condSet)}/* * Evaluate and apply OR operator * Receive an array, a list or a set as parameter */${#bools.arrayOr(condArray)}${#bools.listOr(condList)}${#bools.setOr(condSet)}Arrays#arrays : utility methods for arrays/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Arrays * ====================================================================== *//* * Converts to array, trying to infer array component class. * Note that if resulting array is empty, or if the elements * of the target object are not all of the same class, * this method will return Object[]. */${#arrays.toArray(object)}/* * Convert to arrays of the specified component class. */${#arrays.toStringArray(object)}${#arrays.toIntegerArray(object)}${#arrays.toLongArray(object)}${#arrays.toDoubleArray(object)}${#arrays.toFloatArray(object)}${#arrays.toBooleanArray(object)}/* * Compute length */${#arrays.length(array)}/* * Check whether array is empty */${#arrays.isEmpty(array)}/* * Check if element or elements are contained in array */${#arrays.contains(array, element)}${#arrays.containsAll(array, elements)}Lists#lists : utility methods for lists/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Lists * ====================================================================== *//* * Converts to list */${#lists.toList(object)}/* * Compute size */${#lists.size(list)}/* * Check whether list is empty */${#lists.isEmpty(list)}/* * Check if element or elements are contained in list */${#lists.contains(list, element)}${#lists.containsAll(list, elements)}/* * Sort a copy of the given list. The members of the list must implement * comparable or you must define a comparator. */${#lists.sort(list)}${#lists.sort(list, comparator)}Sets#sets : utility methods for sets/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Sets * ====================================================================== *//* * Converts to set */${#sets.toSet(object)}/* * Compute size */${#sets.size(set)}/* * Check whether set is empty */${#sets.isEmpty(set)}/* * Check if element or elements are contained in set */${#sets.contains(set, element)}${#sets.containsAll(set, elements)}Maps#maps : utility methods for maps/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Maps * ====================================================================== *//* * Compute size */${#maps.size(map)}/* * Check whether map is empty */${#maps.isEmpty(map)}/* * Check if key/s or value/s are contained in maps */${#maps.containsKey(map, key)}${#maps.containsAllKeys(map, keys)}${#maps.containsValue(map, value)}${#maps.containsAllValues(map, value)}Aggregates#aggregates : utility methods for creating aggregates on arrays or collections/* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Aggregates * ====================================================================== *//* * Compute sum. Returns null if array or collection is empty */${#aggregates.sum(array)}${#aggregates.sum(collection)}/* * Compute average. Returns null if array or collection is empty */${#aggregates.avg(array)}${#aggregates.avg(collection)}Messages#messages : utility methods for obtaining externalized messages inside variables expressions, in the same way as they would be obtained using #{...} syntax./* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Messages * ====================================================================== *//* * Obtain externalized messages. Can receive a single key, a key plus arguments, * or an array/list/set of keys (in which case it will return an array/list/set of * externalized messages). * If a message is not found, a default message (like '??msgKey??') is returned. */${#messages.msg('msgKey')}${#messages.msg('msgKey', param1)}${#messages.msg('msgKey', param1, param2)}${#messages.msg('msgKey', param1, param2, param3)}${#messages.msgWithParams('msgKey', new Object[] {param1, param2, param3, param4})}${#messages.arrayMsg(messageKeyArray)}${#messages.listMsg(messageKeyList)}${#messages.setMsg(messageKeySet)}/* * Obtain externalized messages or null. Null is returned instead of a default * message if a message for the specified key is not found. */${#messages.msgOrNull('msgKey')}${#messages.msgOrNull('msgKey', param1)}${#messages.msgOrNull('msgKey', param1, param2)}${#messages.msgOrNull('msgKey', param1, param2, param3)}${#messages.msgOrNullWithParams('msgKey', new Object[] {param1, param2, param3, param4})}${#messages.arrayMsgOrNull(messageKeyArray)}${#messages.listMsgOrNull(messageKeyList)}${#messages.setMsgOrNull(messageKeySet)}IDs#ids : utility methods for dealing with id attributes that might be repeated (for example, as a result of an iteration)./* * ====================================================================== * See javadoc API for class org.thymeleaf.expression.Ids * ====================================================================== *//* * Normally used in th:id attributes, for appending a counter to the id attribute value * so that it remains unique even when involved in an iteration process. */${#ids.seq('someId')}/* * Normally used in th:for attributes in
七.thymeleaf的$和*的区别:
Name: Sebastian.
Surname: Pepper.
Nationality: Saturn.
这等同于如下方式：
Name: Sebastian.
Surname: Pepper.
Nationality: Saturn.
也可以混用,如下:
Name: Sebastian.
Surname: Pepper.
Nationality: Saturn.
当一个对象的选择,选择的对象将也可用美元作为#对象表达变量表达式：
Name: Sebastian.
Surname: Pepper.
Nationality: Saturn.
如果没有执行对象选择,美元和星号语法是完全等价的:
Name: Sebastian.
Surname: Pepper.
Nationality: Saturn.