JSF的ui标签

浏览数：36 / 时间：2015年06月09日

在使用自己的tag时，首先需要在web.xml里面进行注册，注册方式是在web.xml开头加上：

<context-param>
        <param-name>facelets.LIBRARIES</param-name>
        <param-value>/WEB-INF/facelet-taglibs/echo.taglib.xml</param-value>
    </context-param>

并且tag的模版都要在WEB-INF目录下，不然就会找不到

然后是开始定义这个tag, 建立/WEB-INF/facelet-taglibs/echo.taglib.xml
<?xml version="1.0"?>
<!DOCTYPE facelet-taglib PUBLIC
"-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN"
"http://java.sun.com/dtd/facelet-taglib_1_0.dtd">

<?xml version="1.0"?>
<!DOCTYPE facelet-taglib PUBLIC
"-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN"
"facelet-taglib_1_0.dtd">
<facelet-taglib>
    <namespace>http://www.myfaces.com/facelets/tags</namespace>

<tag>
   <tag-name>tree2</tag-name>
   <source>../../tree2.xhtml</source>
</tag>

<tag>
   <tag-name>datatable</tag-name>
   <source>../../datatable.xhtml</source>
</tag>
</facelet-taglib>
注意的是, <source>tpl/echo.xhtml</source>, source标明的文件也要在WEB-INF里面.namespace可以随便命名, 这是给后来引用的.

最后是/pages/myecho.xhtml
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:tutorial="http://tutorial.facelets">
<body>
<tutorial:echo msg="#{param.message}"/>
</body>
</html>

ui composition
在web.xml添加context-param:

<context-param>
   <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
   <param-value>.xhtml</param-value>
</context-param>

       这里我们可以看到，我们之后使用的都将是xhtml而不是传统的jsp。

        在faces-config.xml里面声明view-handler：

<application>
   <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
</application>

    那么当我们使用导航规则<navigation-rule>的时候，就会导航到.xhtml页面了。

    Ok，配置完成。

  二.如何使用facelet？

    facelet布局强大的地方就是使用了模板，这个模板是一个xhtml文件，我们需要在这个xhtml里面设置一些<ui:insert>，例如我们先建一个template.xhtml:

<?xml version="1.0" encoding="UTF-8"?>

<html xmlns=http://www.w3.org/1999/xhtml

         xmlns:ui="http://java.sun.com/jsf/facelets">

<head><meta> http-equiv="Content-Type" content="text/html;charset=UTF-8"/>

<title><ui:insert name="title">这里我们填写默认title</ui:insert></title>

</head>

<body>

Hi,facelet<br/>

<ui:insert name="content"></ui:insert>

<body>

</html>

这个xhtml很容易理解，首先设置xmlns命名空间，就是jsp的<@taglib>，ui就相当于<@taglib>的prefix，值就相当于<@taglib>的uri。我们使用到了facelet的<ui:insert>标签。这个标签表示使用这个模板的页面需要扩展的位置，位置名就是name属性的值啦。如果使用模板的页面没扩展这个位置，那么就使用默认值。

好，编写使用这个模板的页面composition.xhtml：

<?xml version="1.0" encoding="UTF-8"?>

<html xmlns=http://www.w3.org/1999/xhtml

         xmlns:ui="http://java.sun.com/jsf/facelets"

xmlns:h="http://java.sun.com/jsf/html"

xmlns:f="http://java.sun.com/jsf/core">

<body>

<ui:composition template="template.xhtml">

<ui:define name="content"><h:outputText value="我们在这里扩展content啦" /></ui:define >

</ui:composition>

<body>

</html>

这个页面你可以看到我添加了JSF的自定义标签声明，也就相当于声明了<@taglib>。

然后ui:composition的template属性选择调用那个模板，ui:define的那么属性选择扩展哪个位置。

在这个页面，我没有扩展title位置，仅仅扩展了content位置，然后输出h:outputText的值。

Ok，测试一下，运行项目，然后去到composition.xhtml。

我们会看到页面的title显示“这里我们填写默认title”

页面里面则显示：

Hi,facelet

<ui:composition>是一个模版标签，它将一些可以被其他Facelets页面所包含的共有内容封装起来。

该标签的属性：

template 该属性不一定必需意为：将在标签开始和结束之间显示的模版文件所在的路径

<ui:composition> 指定使用那个模版文件，然后通过<ui:define>对模版文件中每个可以供插入的<ui:insert>锚点进行定义。

在运行期，具体的内容将会被插入到<ui:composition> 中定义的锚点位置。

<ui:define>标签用于将命名的的内容插入到模版中，它在模版标签的（如：composition和decorate）内部使用，define的name属性必须和目标模版中的insert 的name属性相同。

该标签的name属性必须有，必须和insert标签的name属性相同。

define标签的内部的内容将插入到目标中的insert标签的name属性标签处，define标签外部内同将被忽略。

insert标签用于模版中指点的插入点，该点将会被define标签的内容所替代。

<ui:include>标签用来在文件中包含另一个facelets文件，它只要指定被包含的文件的位置，它就可以包含任何拥有<ui:component>或<ui:composition>等标签或简单的xhtml和xml代码片段文件。

该标签有一个必须属性src 属性值可以为简单的的值或EL表达式，用来指定所包含的的facelets文件的位置。可以是相对路径也可以是绝对路径。

郑重声明：本站内容如果来自互联网及其他传播媒体，其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。

JSF的ui标签