facelets标签.doc

Facelets标签 标签在 JSF 组件树中插入一个 UIComponet 实例，并作为所有它所包含的组件或内容片断的根节点。表格 1-4 列出它的属性。表格 1-4: 标签属性属性名称必需描述id否和所有的组件一样，可以这它提供一个 id, 如果没有设置， Facelets 将按照 JSF 的规则为它创建一个。binding否按照 JSF 的规范 , 这个属性的作用是通过指向 Managed Bean 的一个属性来引用 UIComponet 的实例 , 如果 Managed Bean 的这个个属性没有事先初始化， UIComponet 实例将惰性 (lazily) 被创建 .这个标签以外的内容将被编译器忽略 , 因此不会显示在视图中。这里以及这里以前的内容将被忽略The directory contains #totalBirds birds!这里以及这里后的内容将被忽略产生的 Html 输出为：The directory contains #totalBirds birds! 标签相似，不同的是 标签外部的内容不会被忽略。下列表格列出它的属性。表格 : 标签属性属性名称必需描述id否和所有的组件一样，可以这它提供一个 id, 如果没有设置， Facelets 将按照 JSF 的规则为它创建一个。binding否按照 JSF 的规范 , 这个属性的作用是通过指向 Managed Bean 的一个属性来引用 UIComponet 的实例 , 如果 Managed Bean 的这个个属性没有事先初始化， UIComponet 实例将惰性 (lazily) 被创建 . 标签在 JSF 组件树中插入一个 UIComponet 实例，并作为标签内部所有它所包含的组件或内容片断的根节点 , 标签外部的内容编译时会被包含进来。举例：This will not be ignoredThis will not be ignored产生输出：This will not be ignoredI want 3 eagles.This will not be ignored 标签是一个模板标签，它将一些可以被其它 Facelets 页面所包含的内容封装起来。表格 1-5 列出它的属性。表格 1-5: 标签属性属性名称必需描述template否将在标签开始和结束之间显示的模板文件所在的路径 指定使用哪个模版文件，然后通过 对模版文件中每个可供插入的“ 锚点”进行定义。 在运行期，具体的内容将会被插入到 中定义的锚点位置。和 ui:component 一样，这个标签以外的内容将被编译器忽略 , 不会显示在视图中 , 和 ui:component 不同的是， ui:composition 不会在组件树上创建节点。这里以及这里以前的内容将被忽略这里以及这里后的内容将被忽略例如 :Input Name 34 Facelets Essentials这样 composition 标签内的内容按 bird-template.xhtml 模板文件的定义显示 , 模板文件中中必须有 和 的定义。创建一个组合视图主要使用 ui:composition, ui:define 和 ui:insert 标签。 标签和 标签相似，唯一不同的是它不忽略标签外部的内容。表格 1-6 列出它的属性。表格 1-6: 标签属性属性名称必需描述template否将在标签开始和结束之间显示的模板文件所在的路径例子：Listing 1-10. box-template.xhtml 36 Facelets EssentialsListing 1-11. decorate-example.xhtmlDecorate exampleThese are the birds in todays menu:Happy ParrotHow many parrots do you want?Mighty EagleEagles are not available now.html 输出内容 :Decorate exampleThese are the birds in todays menu:Happy ParrotHow many parrots do you want?Mighty EagleEagles are not available now.ui:define 标签用于将命名的内容插入到模板中 , 它在模板标签（如 composition 和 decorate ）的内部使用。 Define 的 name 属性必须和目标模板中 ui:insert 标签的 name 属性一致。表格 1-7 列出它的属性。表格 1-7: 标签属性属性名称必需描述name是必须和目标模板中 ui:insert 标签的 name 属性一致举例 1:Happy Parrotthis will be removedHow many parrots do you want?define 标签内部的内容将被插入到目标模板中 name 相同的 insert 标签处。 define 标签外部的内容将被忽略。举例 2:Listing 1-12. define-template.xhtmldefine-example.xhtmlThis will be ignored这个例子输出 :Which bird sings like this? cock-a-doodle-dooui:insert 标签用来在模板中指定一个插入点，可以被客户端模板中 ui:define 定义的内容所代替。 表格 1-8 列出它的属性。表格 1-8: 标签属性属性名称必需描述name否用来和客户端模板中 ui:define 标签的 name 属性相一致 , 如果没有指定，整个客户端模板将被插入。如果模板中某个 insert 标签在客户端模板中没有定义对应的 define ，则使用模板中的默认值。Listing 1-13. insert-template.xhtmlNo titleNo content is defined我们需要一个客户端模板 , 如下：Listing 1-14. insert-client.xhtmlThe Parrot Quest我们只定义了 title 的内容，所以 content 使用默认值。输出如下：The Parrot QuestNo content is definedname 属性是可选的，如果没有被指定，整个客户端模板将被插入。也没必须要客户端模板定义 define 。如下：Listing 1-15. insert-template2.xhtmlOne story of BirdsListing 1-16. insert-client2.xhtmlOne day I decided to start countingthe number of parrots in the world,just to find that.输出如下：One story of BirdsOne day I decided to start countingthe number of parrots in the world,just to find that. 标签用来在文件中包含另外一个 Facelets 文件 , 它只需要指定被包含文件的位置。它可以包含任何拥有 ui:component 或 ui:composition 等标签或是简单的 XHTML 或 XML 代码片断的文件。下列表格列出它的属性。表格 : 标签属性属性名称必需描述src是属性的值可以是简单的值或是 EL 表达式，用来指定被包含的 Faclets 文件的位置 , 可以是相对路径也可以是绝对路径。举例：这标签是开发程序时很有用的工具。在 launched 的时候通过按组合健 Ctrl + Shift + ( 默认是 D) ，将显示一个弹出窗口，在里面显示组件树和局部变量，表格 1-6 列出它的属性。表格 1-6: 标签属性通常，可以在页面的末尾找到 debug 标签 , 但它可以定义在任何位置，可以定义 如下 : hxzon:在firefox中被查找快捷键覆盖，不成功。这样 , 按 Ctrl + Shift + G 就可以弹出调试窗口，在 initParamapress.DEBUG_MODE 中指定是否显示。 用来在 Facelets 之间用名字变量传递对象。 下列表格列出它的属性。表格 : 标签属性举例：Listing 1-17. param-details.xhtml#birdNameOrder: #birdOrderFamily: #birdFamily在下面文件中引用前面定义的模板文件Listing 1-18. param-example.xhtml产生如下输出：ParrotOrder: PsittaciformesFamily: PsittacidaeEagleOrder: FalconiformesFamily: Accipitridae 用来在在编译时移除代码块，它没有属性，可