HTML标签
Beetl 也支持HTML tag形式的标签,个人认为,这是一种引用模板更加优雅的实现,能和静态HTML标签融为一体。
比如在一个模板中引用另外一个模板,我们可以使用include
我们也可以为 page.html定义一个HTML标签,那他的调用方法就变成了下面这种。
是不是更加符合,静态HTML标签的习惯。
一、配置
HTML标签默认配置
#支持HTML标签
HTML_TAG_SUPPORT = true
#标签以#号开头识别为HTML标签
HTML_TAG_FLAG = #
#自定义标签文件Root目录和后缀
RESOURCE.tagRoot = htmltag
RESOURCE.tagSuffix = tag
如果想修改配置,直接在根目录下的 beetl.properties 当中修改覆盖就行
二、使用
在templates(你定义的模板目录)下新建htmltag,并且新建标签page.tag,定义标签内容:
首页
上一页
= page.totalPage){%>
末尾页
下一页
在需要调用标签的模板中写入:
Beetl自定义标签的传参形式,与HTML习惯保持一致,采用“属性=值”的方式,值必须使用双引号或者单引号,引起来。
三、其他的注意事项
可以在自定义标签里引用标签体的内容,标签体可以是普通文本,beetl模板,以及嵌套的自定义标签等。如上
HTML自定义标签 的属性值均为字符串 如,在input.tag文件里 变量value的类型是字符串
可以在属性标签里引用beetl变量,如,此时在input.tag里,value的类型取决于user.age
在属性里引用beetl变量,不支持格式化,如,如果需要格式化,需要在input.tag文件里自行格式化
在标签属性里传json变量需要谨慎,因为json包含了"}",容易与占位符混合导致解析出错,因此得使用""符号,如
html tag 属性名将作为 其对应模板的变量名。如果属性名包含“-”,则将转为驼峰命名的变量,如data-name,转为dataName
默认机制下,HTMLTagSupportWrapper2 实现了标签(2.8.x以前使用HTMLTagSupportWrapper)
具体请参考视频教程,或者gitee中的源码
自定义定界符与占位符
定界符与占位符在之前的博客中已经介绍过。
定界符就是界定静态代码与Beetl代码的符号。
占位符就是在静态代码中,为Beetl编译的结果占据一个位置,(可以回忆一下el表达式)。
定界符与占位符的默认配置如下:
#占位符开始符号
DELIMITER_PLACEHOLDER_START=${
#占位符的结束符号
DELIMITER_PLACEHOLDER_END=}
#定界符开始符号
DELIMITER_STATEMENT_START=
#定界符结束符号
DELIMITER_STATEMENT_END=%>
自定义配置
在根目录下的 beetl.properties中修改配置,比如
#定界符开始符号
DELIMITER_STATEMENT_START=@
#定界符结束符号
DELIMITER_STATEMENT_END=
@ 和回车换行 (此时,模板配置DELIMITER_STATEMENT_END= 或者 DELIMITER_STATEMENT_END=null 都可以)
结束符留空,或者=null 表示 是以回车作为结尾。
视频地址:下载下来会更清晰,视频比较长,可使用倍速看