虽然只是小版本的升级,但对于希望在JSF应用中使用HTML5技术的开发人员而言,JSF 2.2带来的更新很重要,尤其是pass through能力,它允许在JSF组件不知情的情况下传递HTML属性。
\HTML5中增加了很多新特性,其中有些是在已有的元素上增加了对新属性的支持。例如,input元素的type属性支持text、search、email、url、tel、range、number和date等属性值。另外,它还有一系列的自定义数据属性,用来在HTML元素上关联少量数据。这些数据不会显示,但可以用JavaScript读取。
\对于像JSF这样基于组件的库,上述情况带来一个问题:为了识别新属性,所有已有的组件必须更新。对于需要显式支持这些属性的组件而言,的确如此。但在很多情况下,组件只需要在最终生成的标记中包含这些属性即可。JSF 2.2的pass-through属性就是这样实现的。
\在Facelet页中,pass-through属性可以通过以下三种方法设置:
\1. 通过组件标签的命名空间属性
\\\u0026lt;html xmlns=\"http://www.w3.org/1999/xhtml\"\ xmlns:h=\"http://java.sun.com/jsf/html\"\ xmlns:p=\"http://java.sun.com/jsf/passthrough\"\u0026gt;\ \u0026lt;h:form\u0026gt;\ \u0026lt;h:inputText value=\"#{bean.value}\" p:placeholder=\"Enter text\"/\u0026gt;\ \u0026lt;/h:form\u0026gt;\\u0026lt;/html\u0026gt;\
2. 通过TagHandler f:passThroughAttribute设置单个属性
\\\u0026lt;html xmlns=\"http://www.w3.org/1999/xhtml\"\ xmlns:h=\"http://java.sun.com/jsf/html\"\ xmlns:f=\"http://java.sun.com/jsf/core\"\u0026gt;\ \u0026lt;h:form\u0026gt;\ \u0026lt;h:inputText value=\"#{bean.value}\" \u0026gt;\ \u0026lt;f:passThroughAttribute name=\"placeholder\" value=\"Enter text\" /\u0026gt;\ \u0026lt;/h:outputText\u0026gt;\ \u0026lt;/h:form\u0026gt; \\u0026lt;/html\u0026gt;\
3. 通过TagHandler f:passThroughAttributes设置多个属性
\\\u0026lt;h:outputText value=\"Something\" \u0026gt;\ \u0026lt;f:passThroughAttributes value=\"#{bean.multipleAttributes}\" /\u0026gt;\\u0026lt;/h:outputText\u0026gt;\
#{bean.multipleAttributes}代表一个Map\u0026lt;String,Object\u0026gt;对象。它的值可以是常量,也可以是表达式。
\通过使用Express Language 3(Java EE 7的一部分),多个属性也可以通过EL表达式直接定义。
\\\u0026lt;h:outputText value=\"Something\" \u0026gt;\ \u0026lt;f:passThroughAttributes value=\"{\"one\":1, \"two\":2, \"three\":3}\" /\u0026gt;\\u0026lt;/h:outputText\u0026gt;\
上述改变结果是,开发人员现在可以使用纯HTML来编写JSF视图,这是Wicket等竞争对手框架经常被提及的优势。
\在服务器端,可以使用类UIComponent的新方法getPassThroughAttributes() 和getPassThroughAttributes(boolean create) 来设置属性。
\\UIComponent component = new SomeComponent();\Map passThrough = component.getPassThroughAttributes();\passThrough.put(\"placeholder\