表单

创建其它组件的主容器并在需要时自动添加它们。

设计时的组件

表单组件拖放到页面上:
“表单”组件按钮

表单组件在页面上看起来为如下所示:
设计时的“表单”

运行时的组件

没有表单组件的运行时显示。

“属性”视图和“全部属性”视图

组件的“属性”视图显示可以对组件设置的最常见属性的集合,并且根据组件的不同,您还可以看到用于添加控件、操作或其它组件的选项。要打开“属性”视图,单击窗口 > 显示视图 > 属性;但是,缺省情况下,该视图是打开的。

“表单”组件的这些常见属性显示在“属性”视图中的 h:form键盘辅助隐藏字段选项卡上。要获取完整的属性列表,请参阅全部表单属性表。用于显示和辅助功能的其它配置选项位于 h:form> 键盘辅助h:form> 隐藏字段选项卡上:

表 1. “表单”配置选项

配置选项

描述

对指定击键指定操作。

指定击键、操作以及这些操作在表单组件中的目标。击键和操作是从下拉列表中选择的。而目标也是从一个下拉列表中选择的,并且该下拉列表所填充的内容就是表单中显示的输入字段。每当在表单中按了该键时,就会执行该操作。

隐藏字段

显示表单中所有当前的输入 - 隐藏组件并允许您添加、除去和修改隐藏的字段。

选择此字段的内容

指定选择的具有焦点的字段最初还应该选择它的内容。

当最初显示页面时设置焦点

指定显示页面时将具有初始焦点的字段。可以指定页面中的第一个字段特定字段(由它们的标识来确定)。

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,单击“属性”视图的右上角中的全部属性图标 “全部属性”图标

表 2. 全部“表单”属性

属性名称

在“属性”视图中表示为

描述

accept

未表示

指定组件将允许的各种文件类型(用逗号隔开)。

acceptcharset

未表示

需要响应客户机时使用的字符集。标准 HTML 属性。请参阅 HTML 表单标记:此属性指定处理此表单的服务器接受的输入数据字符编码列表。值是以空格和/或逗号定界的字符集值列表。客户机必须将此列表解释为异或列表,即,对于每个接收到的实体,服务器能够接受任意单字符编码。

binding

未表示

表示此组件的 UIComponent,通常在备份文件中。

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左

enctype

未表示

指定用于提交表单的内容类型。

id

标识

对组件指定一个名称。它应该是 JSP 内的唯一名称。

lang

未表示

指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。

rendered

未表示

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈现组件。

style

样式:属性

指定组件的 CSS 样式信息(例如,style="font-size : 8pt ; color : red")。定义所选组件的属性(例如,字体和颜色)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。

styleClass

样式:类

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须在生成的标记上作为“class”属性传递。定义所选组件的类(例如,样式表)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

target

未表示

指定当单击组件时应将页面装入至的框架集中的目标框架。

title

未表示

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。

相关概念
使用 JavaServer Faces 创建数据访问 Web 应用程序
相关任务
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.