PlayFramework 1 自定义标签 -- FastTags

最早是用 HTML 来自定义标签,现在觉得 HTML 写有关逻辑的代码就有点不伦不类了,HTML 里着重是显示代码。前有一篇 PlayFramework 1 模板应用 -- Java 对象扩展 学习了对 Java 对象扩展的方式,如果不是基于已有对象类型进行方法扩展来进行调用,就可以自定义 FastTags 的方式。

Java 对象扩展的使用是 ${obj.abc()}, FastTags 标签是 #{abc}...${/abc}。

FastTags 标签类继承自 play.templates.FastTags,标签对应方法的原型是

public static void _tagName(Map<?, ?> args, Closure body, PrintWriter out,     ExecutableTemplate template, int fromLine)

这些都是得益约定优于配置,下面来几个例子,分别说明默认参数,命名参数,及多参数,标签体的处理。

上面定义了一个 hello 标签,标签参数从 args 中获取,默认参数名是 arg,标签体用 body 获得。在 HTML 页面中应用

#{hello 'Yanbin'}Good Morning#{/hello}
#{hello arg:'Yanbin'}Good Morning#{/hello}

多个参数时

页面中写成,用逗号分隔

#{hello name:'Yanbin', greeting:'Good Morning'/}

默认参数名和命名参数同时使用

#{hello 'Yanbin', greeting:'Good Morning'/}

没指定名字的参数名是 arg。

最后,无论是在自定义标签还是在扩展的 Java 对象方法中都可以直接使用 request, params, flash, session, play, messages, errors, lang, out 对象,见 Implicit objects available in a template

FastTags 标签可以有自己的命名空间,如为了避免与默认命名空间里的 play.templates.FastTags 中定义的标签冲突,可以为自己的标签类 @FastTags.Namespace("my.tags") 加标注,如

这样,使用该标签就用

#{my.tags.hello 'Yanbin'/}

@FastTags.Namespace  就像是命名包一样,随便你指定什么样的层次。

类别: PlayFramework. 标签: . 阅读(967). 订阅评论. TrackBack.

Leave a Reply

Be the First to Comment!

avatar