JSF 1.1 标签组件
另请参见
标签
组件是标签集组件的一部分。
-
此组件是 JavaServer Faces 1.1 组件。当项目使用 J2EE 1.4 或 J2EE 1.3 时,您会看到使用此 JavaServer Faces 版本的组件。
您可以通过两种方式将新标签添加到标签集中:右键单击标签集组件并选择“添加标签”,或者将新的标签组件从组件面板的“布局”类别拖放到标签集或另一个标签组件上。此外,也可以将标签从组件面板拖放到“导航”窗口的标签集节点上。
- 如果将标签组件放在现有标签的左侧或右侧,则会将其添加到同一行的标签中。
- 如果将标签组件放在现有标签上,则放置的标签将成为该现有标签的子标签,除非现有标签是第三级别的标签。标签集中最多只能包含三个级别的标签。
- 不能将子标签添加到在其布局面板中包含组件的标签中。将标签放在布局面板为空的现有标签组件上时,空的布局面板将被删除,以便为放置的标签腾出空间。
缺省情况下,标签组件下面有一个布局面板,您可以将组件放在该面板中(用户选择标签时,屏幕会显示该面板)。缺省情况下,布局面板的 panelLayout 属性设置为“网格式布局”,表示放在该面板中的组件将在其放置的位置进行排列。通过将 panelLayout 属性设置为“流式布局”(在行中按从左到右的顺序排列放置的组件),可以更改布局行为。有关布局面板属性的详细信息,请参见布局面板组件属性窗口。
要在标签集中选择一个标签,请单击页面中的标签组件,或在“导航”窗口中选择标签组件的节点。要选择整个标签集,请在页面上单击标签集组件的边框,或在“导航”窗口中选择标签集的节点。或者,选择一个标签组件,然后按 Esc 键或单击鼠标右键并选择“选择父组件”以选择其父组件。
- 如果在可视设计器的页面中选择一个标签,则该标签会变为一个选定的标签。如果您不希望如此,请在“导航”窗口中选择该标签以便设置其属性。
可以在“导航”窗口中拖动标签以更改其在标签集中的位置和级别。
标签通常用于:
- 可以将组件放在标签下的布局面板组件中,以便可以在每个标签下显示一组组件。用户选择标签时,只会看到与该标签关联的组件,而不必更改页面。
- 可以使用标签集在一组页面中进行导航。每个标签组件都链接到 Web 应用程序中的 Visual Web JSF 页。应使用页面流编辑器来定义每个标签以显示应用程序中的页面,并将当前页面的标签设置为选定的标签。如果要使用标签集进行页面导航,请确保删除每个标签组件的布局面板。
也可以右键单击该标签组件,然后选择以下某个选项:
- 编辑 action 事件处理程序。对 action 事件处理程序进行编码,用户单击标签时将调用该方法。此方法确定根据指定条件打开的页面或资源。操作方法通常用于处理鼠标的单击操作,并返回指示页面导航条件名称的字符串(应用程序下一个显示的页面)。该方法的缺省名称为
tab-id_action,其中 tab-id 是标签的 id 属性的值。
- 绑定到数据。动态设置标签上显示的文本。您可以将组件的
text 属性绑定到对象或数据提供器,如“绑定到数据”对话框主题所述。
- 属性绑定。打开一个对话框,通过该对话框可以将
text 属性之外的组件属性绑定到其他对象或 Bean 属性,这些对象或属性将自动更新此组件的属性。
- 添加绑定属性。该选项用于在组件中添加绑定属性。
- 注意:如果您打算使用 Java 代码编写组件脚本,则必须手动添加绑定属性,可使用值绑定表达式将该属性绑定到支持页面 Bean 的属性上。
- 删除绑定属性。该选项用于从组件中删除绑定属性。
- 另请参见
- 标签组件属性窗口
- 布局面板组件属性窗口
- 绑定组件属性
- 使用组件
- 组件任务:快速参考
- 关于 Visual Web 组件面板
法律声明