在“选用板”上打开 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 页面上播放各种媒体文件。有关媒体组件的更多信息,请参阅添加媒体组件。可以从下列媒体组件中进行选择: | |
|
playerGenericPlayer | |
|
playerFlash | |
|
playerMediaPlayer | |
|
playerShockwave | |
|
playerRealPlayer | |
输出 | 创建用户不能修改的输出文本。该文本可以是静态的,也可以绑定至数据源。“输出”组件可以显示数据源中的数据以及显示大部分其它 Faces 组件中的静态文本(例如,输入字段的标注)。
当添加输出组件时,选择输出组件“属性”视图上的下列其中一种格式: |
outputText |
|
outputText | |
|
convertNumber | |
|
convertDateTime | |
|
convertMask | |
输出 - 格式化文本 | 将格式化消息输出至页面。消息可以是来自数据存储器的静态文本和动态数据的组合。 | outputFormat |
面板 - 组框 | 创建一个容器,可以在其中对其它组件进行组合。面板的一种用法就是在数据表的列中的应用。当将面板拖至列时,可以控制组织列中多个组件的方式。对于此组件,具有下列选项: | |
|
panelBox | |
|
panelGrid | |
|
panelLayout | |
|
jspPanel | |
面板 - 菜单栏 | 插入一个将命令放到菜单栏中的面板。可以将按钮、超链接和水平线拖放到面板上或者从组件的属性中添加它们。还可以在菜单栏中添加子菜单栏。 | panelActionbar |
面板 - 选项卡式 | 创建一组重叠的选项卡式页面。每个页面可包含一组组件。用户单击选项卡以显示该页面的内容。有关可与选项卡式面板配合使用的事件,请参阅选项卡式面板的事件处理程序。 | tabbedPanel |
单选按钮组 | 显示一组单选按钮。用户只能单击一个单选按钮。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 | selectOneRadio |
丰富文本格式区域 | 插入丰富文本格式编辑器组件。与“输入 - 文本区域”组件一样,此组件可有多行文本。与“输入 - 文本区域”不同的是,此组件可以包含不同的字体和大小、表、链接以及编号列表和符号列表。 | inputRichText |
逐字 | 插入逐字标记,它允许您直接将 HTML 添加至 Faces JSP 页。 | verbatim |