Freemarker语法详解与插值规则全面解析

Freemarker语法完全总结是一份详尽且适合初学者的教程，它以中文形式呈现，深入浅出地介绍了FreeMarker模板语言的关键组成部分。FreeMarker是一种强大的模板引擎，用于动态生成HTML等输出，其模板文件结构主要包括文本输出区域、注释、插值和FTL指令。 1. **文本与注释**: - 模板文件主要由文本和注释组成，文本部分直接输出，而使用`<#---->`的注释内容会被编译器忽略，不参与最终输出。 2. **插值**: - 插值是FreeMarker的核心功能，通过`${}`或`#{}`语法，将数据模型中的值插入到模板中。通用插值`${expr}`用于直接输出表达式的值，支持多种类型的数据转换，如数字、日期等。例如，`${answer?string.number}`会将数字值格式化为字符串，而`${answer?string.percent}`则会将其转换为百分比格式。 - 数字格式化插值使用`#{expr;format}`，如`<#set number_format = "currency"`后，`#{answer;number_format}`会根据设置的格式（如货币）进行转换。 3. **FTL指令**: - 类似于HTML标签，FreeMarker的FTL指令用于执行特定的操作。它们有三种形式： - 开始标签 `<#directivenameparameter>` - 结束标签 `</#directivename>` - 空标签 `<#directivenameparameter/>` - 使用FTL指令时需遵循正确嵌套规则，避免语法错误。非内置指令（由用户自定义）前的`#`符号应更改为`@`。 4. **指令与标签的使用**: - 在使用指令时，确保指令名称的书写正确，并注意标签间的正确格式。FreeMarker会忽略标签内部的空白字符，以及`<`, `/`, 和指令之间的空白。 5. **设置与默认格式**: - Freemarker允许通过`#setting`指令设置全局变量，比如`number_format`，用于控制数字插值的格式化方式。这为模板提供了灵活的定制选项。 学习Freemarker语法时，理解并掌握这些基本元素至关重要，包括如何正确运用插值表达式和指令，以及如何设置和利用默认格式，都是构建高效模板的关键。这份全面的总结为初学者提供了一个清晰的学习路径和实践指导。