Faces 组件参考

在“选用板”上打开 Faces 组件抽屉后,可以将下列任何组件添加至 Faces JSP 页。

某些组件在选用板上可能处于隐藏状态。要显示选用板中的隐藏组件,在“选用板”视图中右键单击并选择定制。对于想要显示在选用板中的每个组件,除去隐藏旁边的选择标记。

每个组件都有一些属性,可在该组件的“属性”视图中设置这些属性。如果在选择组件的时候 Faces 组件的“属性”视图未打开,则选择窗口 > 显示视图 > 属性。有关出现在“属性”视图中的所有以字母顺序排列的属性及其描述,参阅 Faces 组件的属性Faces 媒体组件的属性

注意,有些子组件不是从选用板添加的。而是从父组件的“属性”视图添加的。例如,在将数据表组件添加至页面之后,就可以从数据表的“属性”视图添加行编辑组件了。

下表列示了可从选用板添加的 Faces 组件。

Faces 组件 描述 标记
复选框 显示单个复选框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectBooleanCheckbox
复选框组 显示多个复选框。最终用户可以选择多个复选框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectManyCheckbox
组合框 显示用户可从中选择一项的下拉组合框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectOneMenu
命令 - 按钮 创建可以具有文本或图像的按钮。该按钮可能会运行一个操作。有关操作和导航规则的更多信息,请参阅将导航规则与 Faces JSP 页配合使用 commandExButton
命令 - 超链接 创建超链接,但也能够执行操作(如更新记录)。有关超链接、操作和导航规则的更多信息,请参阅将超链接添加至 Faces JSP 文件将导航规则与 Faces JSP 页配合使用 commandLink
数据表 创建一个数据表,在该表中,行对应于数据记录,列对应于字段或类别。功能包括分页控件、页眉及页脚和对行选择及操作的支持。有关此数据表的更多信息,请参阅添加和配置数据表 dataTable
显示错误 插入发生错误时显示的错误文本。错误是与特定组件相关联的。有关此组件的更多信息,请参阅管理 JavaServer Faces 应用程序中的错误 message
显示错误 当在页面上发生错误时插入有条件地显示的错误消息。显示整个页面的错误。有关错误组件的更多信息,请参阅管理 JavaServer Faces 应用程序中的错误 messages
文件上载 显示用于上载文件的输入字段和相关联的“浏览”按钮。有关文件上载组件的更多信息,请参阅使用文件上载组件 fileupload
表单 创建其它组件的主容器。在需要时自动添加。 form
水平线 创建一条水平线以便可以可视地分隔页上的信息。 outputSeparator
图像 在页面上显示图像。还可以显示来自数据源的图像。有关图像的更多信息,请参阅显示图像 graphicImageEx
输入 允许您为下列类型的数据创建输入字段。当将输入组件添加至页面时,选择输入组件“属性”视图上的下列其中一种格式。有关输入组件的更多信息,请参阅将输入组件添加至 Faces JSP 文件 inputText
 
  • 字符串 - 仅有一行的简单文本字段。这是缺省值。
inputText
 
  • 数字 - 可以设置样式和格式的数字字段。
convertNumber
 
  • 日期/时间 - 可以设置格式的日期和时间字段。
convertDateTime
 
  • 掩码 - 有选择地包括或排除某些值的过滤器。
convertMask
输入 - 隐藏 插入隐藏的输入组件。此组件通常由开发者用来在页面与页面上的控件之间传递数据。 inputHidden
输入 - 密码 插入用户用来输入密码的输入字段。 inputSecret
输入文本区域 插入显示多行文本的输入组件。 inputTextarea
标注 插入辅助功能选项输出标注。有关标签组件的更多信息,请参阅添加标签组件以方便访问 outputLabel
链接 创建指向指定 URL 的超链接。 outputLinkEx
列表框 - 多个选择 插入用户用来选择多项的列表框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectManyListbox
列表框 - 单个选择 插入用户用来选择一项的列表框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectOneListbox
媒体播放器 在页面上创建媒体组件以便可以在 Web 页面上播放各种媒体文件。有关媒体组件的更多信息,请参阅添加媒体组件。可以从下列媒体组件中进行选择:  
 
  • Generic A/V Player - 在 Web 页面上创建媒体播放器并播放文件。
playerGenericPlayer
 
  • Macromedia Flash Player - 创建 Macromedia Flash Player 的实例以在 Web 页面上播放 Flash 文件。
playerFlash
 
  • Microsoft® Windows® Media Player - 创建 Microsoft Windows Media Player 的实例以便在 Web 页面上播放媒体文件。
playerMediaPlayer
 
  • Macromedia Shockwave Player - 在 Web 页面上播放 Macromedia Shockwave Player 文件。
playerShockwave
 
  • Real Network RealOne Player - 在 Web 页面上播放 Real Network RealOne Player 文件。这些文件可以是音频文件或视频文件。
playerRealPlayer
输出 创建用户不能修改的输出文本。该文本可以是静态的,也可以绑定至数据源。“输出”组件可以显示数据源中的数据以及显示大部分其它 Faces 组件中的静态文本(例如,输入字段的标注)。

当添加输出组件时,选择输出组件“属性”视图上的下列其中一种格式:

outputText
 
  • 字符串 - 简单文本字段。这是缺省格式。
outputText
 
  • 数字 - 可以设置样式和格式的数字字段。
convertNumber
 
  • 日期/时间 - 可以设置格式的日期和时间字段。
convertDateTime
 
  • 掩码 - 有选择地包括或排除某些值的过滤器。
convertMask
输出 - 格式化文本 将格式化消息输出至页面。消息可以是来自数据存储器的静态文本和动态数据的组合。 outputFormat
面板 - 组框 创建一个容器,可以在其中对其它组件进行组合。面板的一种用法就是在数据表的列中的应用。当将面板拖至列时,可以控制组织列中多个组件的方式。对于此组件,具有下列选项:  
 
  • 列表 - 以垂直或水平列表方式组织组件。
panelBox
 
  • 网格 - 以网格方式组织组件。可以指定网格中的列数。
panelGrid
 
  • 对齐边框 - 沿着面板的边组织组件。
panelLayout
 
  • HTML - 插入一个面板,它可以包括任何其它 HTML、JSP 或 Faces 组件。大部分 Faces 组件都可以包含其它 Faces 标记,但不能包含 HTML 标记。然而,此 jspPanel 组件既可以包含 Faces 标记又可以包含 HTML 标记。例如,通常不能在 Faces 数据表的列中创建 HTML 表。然而,如果将此组件拖至列,就可以在列中创建 HTML 表。另外,HTML 表也可以包含 Faces 标记。
jspPanel
面板 - 菜单栏 插入一个将命令放到菜单栏中的面板。可以将按钮、超链接和水平线拖放到面板上或者从组件的属性中添加它们。还可以在菜单栏中添加子菜单栏。 panelActionbar
面板 - 选项卡式 创建一组重叠的选项卡式页面。每个页面可包含一组组件。用户单击选项卡以显示该页面的内容。有关可与选项卡式面板配合使用的事件,请参阅选项卡式面板的事件处理程序 tabbedPanel
单选按钮组 显示一组单选按钮。用户只能单击一个单选按钮。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件 selectOneRadio
富文本格式区域 插入富文本格式编辑器组件。与“输入 - 文本区域”组件一样,此组件可有多行文本。与“输入 - 文本区域”不同的是,此组件可以包含不同的字体和大小、表、链接以及编号列表和符号列表。 inputRichText
逐字 插入逐字标记,它允许您直接将 HTML 添加至 Faces JSP 页。 verbatim
相关概念
JavaServer Faces
Faces components
相关任务
Using Faces components
相关参考
Faces 组件的属性
Faces 媒体组件的属性
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.