在“选用板”上打开 Faces 组件抽屉后,可以将任何组件添加至 Faces JSP。缺省情况下,某些组件在选用板处于隐藏状态。要显示选用板中的隐藏组件,在“选用板”视图中右键单击并选择定制。对于想要显示在选用板中的每个组件,除去隐藏旁边的选择标记。
组件的“属性”视图显示可以对组件设置的最常见属性的集合,并且根据组件的不同,您还可以看到用于添加控件、操作或其它组件的选项。要打开“属性”视图,单击窗口 > 显示视图 > 属性;但是,缺省情况下,该视图是打开的。
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,单击“属性”视图的右上角中的全部属性图标 。
有关出现在“属性”视图中的所有以字母顺序排列的属性及其描述,参阅 Faces 组件的属性。有关单独的组件的详细信息,单击 Faces 组件及其描述表中的组件名,该表列示可以从选用板添加的所有 Faces 组件。最初处于隐藏状态的组件在表中将用其名称旁边的星号(*)表示。
Faces 组件名 | Faces 标记名 | 描述 |
---|---|---|
复选框 | selectBooleanCheckbox | 显示单个复选框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
复选框组 | selectManyCheckbox | 显示多个复选框。最终用户可以选择多个复选框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
组合框 | selectOneMenu | 显示用户可从中选择一项的下拉组合框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
命令 - 按钮 | commandExButton | 创建可以具有文本或图像的按钮。该按钮可能会运行一个操作。有关操作和导航规则的更多信息,请参阅将导航规则与 Faces JSP 页配合使用。 |
命令 - 超链接 | commandLink | 创建超链接,但也能够执行操作(如更新记录)。有关超链接、操作和导航规则的更多信息,请参阅将超链接添加至 Faces JSP 文件和将导航规则与 Faces JSP 页配合使用。 |
数据表 | dataTable | 创建一个数据表,在该表中,行对应于数据记录,列对应于字段或类别。功能包括分页控件、页眉及页脚和对行选择及操作的支持。有关此数据表的更多信息,请参阅添加和配置数据表。 |
显示错误 | message | 插入发生错误时显示的错误文本。错误是与特定组件相关联的。有关此组件的更多信息,请参阅管理 JavaServer Faces 应用程序中的错误。 |
多处显示错误 | messages | 当在页面上发生错误时插入有条件地显示的错误消息。显示整个页面的错误。有关错误组件的更多信息,请参阅管理 JavaServer Faces 应用程序中的错误。 |
文件上载 | fileupload | 显示用于上载文件的输入字段和相关联的“浏览”按钮。有关文件上载组件的更多信息,请参阅使用文件上载组件。 |
表单 | form | 创建其它组件的主容器。在需要时自动添加。 |
*水平线 | outputSeparator | 创建一条水平线以便可以可视地分隔页上的信息。 |
图像 | graphicImageEx | 在页面上显示图像。还可以显示来自数据源的图像。有关图像的更多信息,请参阅显示图像。 |
输入 | inputText | 允许您为下列类型的数据创建输入字段。当将输入组件添加至页面时,选择输入组件“属性”视图上的下列其中一种格式。有关输入组件的更多信息,请参阅将输入组件添加至 Faces JSP 文件。 |
inputText |
|
|
convertNumber |
|
|
convertDateTime |
|
|
convertMask |
|
|
*输入 - 隐藏 | inputHidden | 插入隐藏的输入组件。此组件通常由开发者用来在页面与页面上的控件之间传递数据。 |
输入 - 密码 | inputSecret | 插入用户用来输入密码的输入字段。 |
输入文本区域 | inputTextarea | 插入显示多行文本的输入组件。 |
标号 | outputLabel | 插入辅助功能选项输出标签。有关标签组件的更多信息,请参阅添加标签组件以方便访问。 |
链接 | outputLinkEx | 创建指向指定 URL 的超链接。 |
列表框 - 多项选择 | selectManyListbox | 插入用户用来选择多项的列表框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
列表框 - 单项选择 | selectOneListbox | 插入用户用来选择一项的列表框。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
媒体播放器 | 在页面上创建媒体组件以便可以在 Web 页面上播放各种媒体文件。有关媒体组件的更多信息,请参阅添加媒体组件。可以从下列媒体组件中进行选择: | |
playerGenericPlayer |
|
|
playerFlash |
|
|
playerMediaPlayer |
|
|
playerShockwave |
|
|
playerRealPlayer |
|
|
输出 | outputText | 创建用户不能修改的输出文本。该文本可以是静态的,也可以绑定至数据源。“输出”组件可以显示数据源中的数据以及显示大部分其它 Faces 组件中的静态文本(例如,输入字段的标注)。
当添加输出组件时,选择输出组件“属性”视图上的下列其中一种格式: |
outputText |
|
|
convertNumber |
|
|
convertDateTime |
|
|
convertMask |
|
|
输出 - 格式化文本 | outputFormat | 将格式化消息输出至页面。消息可以是来自数据存储器的静态文本和动态数据的组合。 |
面板 - 组框 | 创建一个容器,可以在其中对其它组件进行组合。面板的一种用法就是在数据表的列中的应用。当将面板拖至列时,可以控制组织列中多个组件的方式。对于此组件,具有下列选项: | |
panelBox |
|
|
panelGrid |
|
|
panelLayout |
|
|
jspPanel |
|
|
面板 - 菜单栏 | panelActionbar | 插入一个将命令放到菜单栏中的面板。可以将按钮、超链接和水平线拖放到面板上或者从组件的属性中添加它们。还可以在菜单栏中添加子菜单栏。 |
面板 - 选项卡式 | tabbedPanel | 创建一组重叠的选项卡式页面。每个页面可包含一组组件。用户单击选项卡以显示该页面的内容。有关可与选项卡式面板配合使用的事件,请参阅选项卡式面板的事件处理程序。 |
单选按钮组 | selectOneRadio | 显示一组单选按钮。用户只能单击一个单选按钮。有关此组件的更多信息,请参阅将选择列表添加至 Faces JSP 文件。 |
富文本格式区域 | inputRichText | 插入富文本格式编辑器组件。与“输入 - 文本区域”组件一样,此组件可有多行文本。与“输入 - 文本区域”不同的是,此组件可以包含不同的字体和大小、表、链接以及编号列表和符号列表。 |
*逐字 | verbatim | 插入逐字标记,它允许您直接将 HTML 添加至 Faces JSP 页。 |