如何创建自定义Facelets标记?

时间:2013-02-07 12:55:03

标签: jsf jsf-2 facelets custom-tags tagfile

我正在使用JSF 2.0。我使用tagfiles创建了自定义JSTL标记,并且在JSP中运行良好。但我也想在Facelets中使用自定义JSTL标签。是否可以在Facelets中创建标记文件?

1 个答案:

答案 0 :(得分:11)

“自定义JSTL标签”老实说没有意义。这个词完全没有意义。 JSTL已经已经一个taglib。请仔细阅读our JSTL wiki page的介绍性段落,了解JSTL的真正含义。你或许实际上意味着“Custom JSP tags”。当然,它们不会在Facelets中工作,因为这是一种与JSP完全不同的视图技术,实际上是不推荐使用的JSP的后续版本。

嗯,“自定义JSP标记”的类比是“自定义Facelets标记”,或者更常见的是“Facelets标记文件”。它非常简单,您可以使用与包含文件相同的语法。

/WEB-INF/tags/some.xhtml

<ui:composition xmlns:ui="http://java.sun.com/jsf/facelets">
    Hello World
    ...
    <ui:insert /> <!-- This inserts tag body, if necessary. -->
</ui:composition>

并在/WEB-INF/example.taglib.xml中注册,如下所示:

<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib 
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
    version="2.0">
    <namespace>http://example.com/jsf/facelets</namespace>
    <tag>
        <tag-name>some</tag-name>
        <source>tags/some.xhtml</source>
    </tag>
</facelet-taglib>

又在/WEB-INF/web.xml中注册如下:

<context-param>
    <param-name>javax.faces.FACELETS_LIBRARIES</param-name>
    <param-value>/WEB-INF/example.taglib.xml</param-value>
</context-param>

(请注意,当web.xml文件位于*.taglib.xml中的JAR的/META-INF文件夹中时,无需在/WEB-INF/lib中注册

最后在模板中使用它,如下所示:

<html ... xmlns:my="http://example.com/jsf/facelets">
...
<my:some />

另见: