Faces 属性参考

这是所有 JSF 组件可能具有的所有属性的列表。

呈示

此组件无可视呈示。不呈示任何 HTML 文件。

呈示

此组件的可视呈示根据所选组件的不同而变化。

设计时的组件

运行时的组件

属性

父标记

此标记用作下列标记的子代:

呈示

此标记由其父标记呈示,请参阅父标记描述以了解更多信息。

“属性”视图

某些组件在选用板上可能处于隐藏状态。要显示选用板中的隐藏组件,请在“选用板”视图中右键单击并选择定制。对于每个要显示在选用板中的组件,请除去隐藏旁边的选取标记。最初处于隐藏状态的组件在下面将用星号(*)表示。组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性;不过,缺省情况下,该视图是打开的。

“属性”视图

全部属性视图

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

“全部属性”视图

属性视图和全部属性视图

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

快速编辑视图

使用“快速编辑”视图配置此组件。要打开“快速编辑”视图,请单击窗口 > 显示视图 > 快速编辑

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

属性名

在“全部属性”视图中表示为

属性名称

在“属性”视图中表示为

描述

用于组件

配置选项

未表示

格式类型

格式选项

添加当单击行时就会执行的操作

允许您创建在单击行时将发生的运行时操作。

添加编辑列,它可以启动对行内容进行就地编辑的表单

允许您在运行时提供行内编辑。

将选择列添加至表

允许您添加具有与表内容相关选项的列。

添加将处理所选标题的操作

允许您创建处理标题信息的操作。

对组中的每个复选框添加选项

允许您指定“复选框组”组件中各个框的名称、值和顺序。可以添加单个或一组选项。

对组中的每个单选按钮添加选项

允许您指定“单选按钮组”组件中各个单选按钮的名称、值和顺序。可以添加单个或一组选项。

对颜色菜单中的每项添加选项

允许您指定 selectOneColor 组件中各种颜色的名称、值和顺序。可以添加单个或一组选项。

对组合框下拉菜单中的每项添加选项

允许您指定组件的下拉菜单中各项的名称、值和顺序。

对组中的每个单选按钮添加选项

允许您指定“单选按钮组”组件中各个按钮的名称、值和顺序。

对列表框中的项添加选项

允许您指定“列表框”组件中各项的名称、值和顺序。

添加参数值以替换值字符串中的每个 {n}

允许您指定“输出消息”参数的名称和值。您还可以使用“除去”按钮除去某些项,并使用“上移”和“下移”按钮来更改这些项在面板中的顺序。

添加控制播放器的参数

指定使用哪些参数来控制媒体播放器组件。

添加传递给操作的参数

指定组件要将哪些参数传递给操作。

对要显示在控件中的每个选项卡添加面板

允许您指定“面板 - 选项卡式”组件中各个选项卡的 ID、标签和顺序。另外,您还可以指定各个选项卡包含预定义的完成和取消命令按钮组件。

添加 Web 样式分页控件

将每个页码添加至页脚区域,以便用户可以单击期望的页码。

分类 > 将列添加到分类表行中

分类 > 除去分类表行中的列

添加具有行分类组件的列,可以在该组件中设置表排序值并将图标或文本添加至该列。一旦添加了该列,“分类”图标就会更改为“除去”。

添加“转至”分页控件

对页脚区域添加一个组件,该组件允许您从下拉列表中选择一页。

添加高级分页控件

对页脚区域添加一个组件,该组件通过使用箭头在页面之间移动。

添加简单分页控件

对页脚添加一个组件,该组件将创建简单下拉菜单以便移至下一页。

添加页面信息

对页脚区域添加一个组件,该组件将显示有关页面的统计信息。

对控件添加项

允许您查看菜单栏中的项,以及添加超链接、命令按钮、子面板和分隔符。您还可以使用“除去”按钮除去某些项,并使用“上移”和“下移”按钮来更改这些项在面板中的顺序。

行为 > 在用户输入 X 个字符后

在最终用户将这么多个字符输入到组件之后制定控制属性。

对指定击键指定操作。

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

背景图像

指定要用作背景的图像。单击“浏览”按钮以选择图像文件或者与数据源绑定。

单击以编写此按钮执行的操作的代码

切换至“快速编辑”视图,以便可以编写命令按钮要执行的操作的代码。另外,还可以根据操作和返回的结果来定义规则。

单击以编写此链接执行的操作的代码

切换至“快速编辑”视图,以便可以编写超链接要执行的操作的代码。另外,还可以根据操作和返回的结果来定义规则。

单击以创建/编辑定制验证代码

切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。

指定页眉或页脚是否要包括在数据表中。使用“添加”和“除去”按钮来添加或删除列。使用“上移”和“下移”按钮来修改各列的顺序。

在错误消息控件中显示验证错误消息

插入与所选组件相关联的错误消息组件。如果验证失败,它将显示错误消息。

单元格内容不折行

指定不应将所选单元格的内容折行。

文件类型

指定组件要使用的文件类型。可以静态定义或链接至数据存储器。

文件名

指定组件要使用的文件名。可以静态定义或链接至数据存储器。

格式

指定组件要处理的数据格式: 有关详细信息,请参阅单独的格式类型表。

String

字符串:指定用户提供的输入应该采用文本字符串格式。

数字

数字:指定用户提供的输入应该采用数字格式。

日期/时间

日期/时间:指定用户提供的输入应该采用日期和/或时间格式。

Mask

掩码:指定通过有选择地包括或排除某些值对用户提供的输入进行过滤。

指定组件要处理的数据格式: 有关详细信息,请参阅单独的格式类型表。

格式:字符串

字符串:指定输出应该采用文本字符串格式。

格式:数字

数字:指定输出应该采用数字格式。

格式:日期/时间

日期/时间:指定输出应该采用日期和/或时间格式。

格式:掩码

掩码:指定通过有选择地包括或排除某些值对输出进行过滤。

隐藏字段

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

水平对齐

指定面板是应该左对齐、居中对齐还是右对齐。

选项

选项 > 打开一个窗口,它将显示可以为此组件设置的定制属性的列表。

面板中各项的顺序

允许您使用“上移”和“下移”按钮来指定面板中各个组件的顺序。

选择此字段的内容

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

显示页眉

选择此框会将页眉区域 f:facet (header)h:panelBox 插入到数据表中,然后可以向该页眉区域中填充其他组件。

显示辅助控件按钮

显示辅助控件按钮 > 指定组件应该对用户显示辅助控件按钮。

显示页脚

选择此框会将页脚区域 f:facet (footer)h:panelBox 插入到数据表中,然后可以向该页脚区域中填充其他组件。

显示提示字符

显示提示字符 > 指定用户可视的符号以便提示用户进行输入。

使用简单验证

使用简单验证 > 允许您输入一个简单的最小和最大范围,组件将针对该范围进行验证。

使用高级验证

使用高级验证 > 允许您指定一个更高级的表达式以使用 EL 语法进行验证。

在浏览器中验证字段值

允许运行时在浏览器中验证字段。

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

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

“全部属性”视图属性

accept

允许下列类型的文件

指定组件将允许的各种文件类型,用逗号分隔。

acceptcharset

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

accesskey

char

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。

action

指定当单击组件时返回的值。此值传递至缺省导航处理程序,然后根据在应用程序配置文件中定义的一组导航规则对此值进行匹配。

actionListener

该表达式指向一个带有 ActionEvent 参数和“void”返回类型的方法。

align

对齐

指定组件的对齐方式:
指定组件的对齐方式:

对齐:水平

指定组件是应该向左对齐、居中对齐还是向右对齐。

alt

辅助功能 > 备用文本

指定组件的备用文本。例如,如果元素在不支持表单的浏览器中和在设置为不显示图像的浏览器中不能正常呈示,则显示此备用文本。

archive

与用于呈示“媒体组件”的对象 HTML 标记相关联的属性,用于对包含与对象相关资源的归档指定以空格分隔的 URL 列表。

asis

指定是否除去除掩码输入以外的数据。缺省值为 false。

autoseparate

显示每项之间的分隔符

选择此框将指定操作栏中的各项之间会出现分隔符行。如果 autoseparate 设置为 true,则在呈示时自动在每个包含的组件之间插入分隔符项。如果将它留空,则缺省为 false,不会插入分隔符。

autoStart

自动播放

如果 autostart 设置为 true,则丰富媒体文件将开始在组件中自动播放。选择此项将导致组件在运行时自动启动。

autoTab

自动进入下一字段

在输入了指定的字符数之后自动进入另一个输入字段。缺省值为 false。

指定是启用还是禁用自动跳进。在输入了指定的字符数之后自动将用户带往另一个输入字段。选择此框之后,会将 hx:inputHelperAssist 部分添加至“全部属性”视图并将 autoTab 设置为 True。

backgroundcolor

设置图像窗口的背景色。当某个剪辑包含透明区域时,背景色也会透过这些区域显示出来。

baseURL

指定 Media Player 将用来操作的基本 URL。有关更多信息,请参阅 MSDN 库中 baseURL 的 Windows® Media 文档。

bgcolor

背景色

使用以 # 符号开头的 6 位十六进制 RGB 值指定背景色,或者通过输入颜色名称(例如,黑色、白色或蓝色)来指定背景色。

指定影片本身显示之前影片矩形的颜色。值是用标准的六个十六进制字符 RGB 颜色表示法来表示的,例如,#FFFF00。

binding

expression

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

border

边框

指定表的边框大小(以像素计)。

指定播放器的边框大小(以像素计)。

指定图像的边框大小(以像素计)。

cancelBubble

指定是否取消浏览器管理的事件冒泡:

cellpadding

填充

指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。

指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。

cellspacing

间隔

指定表中各个单元格之间的间隔大小(以像素计)。

指定单元格之间要保留的间隔大小(以像素计)。

center

指定演示内容是否应在图像窗口中居中并按它的原始已编码的大小显示。

charset

超链接所指定的资源的字符编码。

codebase

指定用于解析由组件中其他属性指定的相对 URI 的基本路径。

collapsed

指定类别行的初始折叠状态。值可以是 true 或 false。如果留空,则表示缺省值是 true。

collapsedImage

指定折叠类别时要显示的定制图像。

color

颜色

用以 # 符号开头的 6 位十六进制 RGB 值指定选定组件的颜色,或者通过输入颜色名称(例如,黑色、白色和蓝色等)来指定选定组件的颜色。

columnClasses

列类

为数据表组件的列指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

cols

大小:宽度

指定在运行时显示的列数。

指定在运行时显示的列数。

在表中添加列组件,或从表中除去列组件。可以对每个列设置标签、宽度和 ID,并将它们移到表中。

大小:列数

指定网格中的列数。

confirm

提示文本

指定要显示的文本,此文本在按 commandExButton 时请求确认。如果未对此属性设置值,将不会显示“确认”对话框。

console

当对 Web 页面上的多个控件指定同一个控制台名称时,可使用此参数来允许这些控件管理单个嵌入式表示的回放。例如,如果在同一个页面上有许多“播放”和“停止”按钮,则共享的控制台名称使它们能够控制同一段剪辑。

contentClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

控件

将指定的 RealPlayer 控件嵌入到 Web 页面上。

converter

指定值所转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。

coords

屏幕上热点的位置和形状,在客户端图像映射中使用。

currencyCode

将“输入文本字符串”转换为“输入文本数字”格式。

currencySymbol

货币符号

指定要输入的货币符号。如果您指定货币符号类型,则它将变成活动的。

dateStyle

日期样式

预定义的格式化样式,它确定如何格式化日期字符串的日期部分并对其进行语法分析。仅当类型为日期两者时才适用。允许您从以下几种日期格式中选择一种:

decode

用来指定在 scriptCollector 组件的解码阶段调用的方法。

dimage

类型 > 图像:禁用的图像

指定当组件被禁用时要显示的图像。

dir

ltr 和 rtl

指定当在运行时呈示时组件的方向。值可以是: 如果未指定方向,则使用适合于对组件进行编码的方向。

disabled

boolean

控件被禁用

行为 > 控件被禁用

如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果留空,则缺省值为 false。

disableCancel

如果设置为 true,则在运行时将显示“取消”按钮,但它不起作用。如果留空,则缺省值为 false。

disabledClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

disableFinish

如果设置为 true,则在运行时将显示“完成”按钮,但它不起作用。如果留空,则缺省值为 false。

editStyle

用于编辑窗格的 CSS 样式。

editStyleClass

用于编辑窗格和控件的 CSS 样式类。

enableContextMenu

指定当用户单击鼠标右键时上下文菜单是否出现。缺省值为 true。

enabledClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

enctype

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

errorAction

通过其中一个预定义的操作或 JavaScript™ 函数指定操作,当客户端验证结果产生错误时将调用此操作。

errorClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

指定用于表示错误的 CSS 类。当在输入字段单击有效的键时,样式将被重新设置为 successClass 样式。如果未指定 successClass,则使用 input_text 的 css 类。如果既未指定 errorClass 也未指定 successClass,则不会重新设置该 css 类。可以指定多个用逗号分隔的类,例如:errorClass="class, class2, class3"。

errorStyle

CSS 类的样式修饰符。

escape

指定是对 HTML 格式进行转义(False)还是将 HTML 标记呈示为 HTML(True)。

以 HTML 呈示值

exclude

要排除的 MIME 类型。

exclude

不允许下列文件类型

指定组件将排除的各种文件类型,用逗号分隔。

expandedImage

指定展开类别时要显示的定制图像。

fatalClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

fatalStyle

CSS 类的样式修饰符。

first

要显示的第一行的索引。

footerClass

页脚类

为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

for

标签 ID

指定辅助控件组件要应用于的组件。该值应是所辅助的组件的 ID。

显示有关组件的错误消息

指定想要捕获的输入字段的 ID 并显示错误消息。

框架

指定表框的哪几条边可视:

指定网格框的哪几条边可视。

globalOnly

显示此页面生成的所有错误消息

只显示不与特定组件相关联的错误消息。

指定组件应该显示哪些错误消息,是显示由页面生成的所有错误消息(False),还是只显示尚不相关联的组件的错误消息(True)。

groupingsUsed

指定格式化的输出是否将包含分组分隔符。

headerClass

标题类

为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。

height

大小:高度

指定组件的高度(以像素或百分比计)。要指定以百分比计,请在值后面追加 %。

指定组件的高度(以像素计)。

hidden

指定是否在 Web 页面上隐藏播放器。

himage

类型 > 图像:鼠标经过时的图像

指定当用户的鼠标指针经过组件时将显示的图像。

此按钮图像的路径。

hreflang

此超链接指定的资源的语言代码。

hspace

页边空白:水平

指定要插入组件左右两边的空格大小(以像素计)。

id

标识

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

imagekey

与“bundle”属性配合使用,imageKey 属性与在束中指定的一组“key=value”对中的键相关,而其中的“值”则为图像文件的 URL/URI。

image

类型 > 图像:正常图像

指定组件中要显示的图像的 URL/URI。

imeMode

此属性仅对 Internet Explorer 有效。指定 IME 方式:

immediate

boolean

如果为 true,则直接跳至生命周期的呈示阶段。

infoClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

infoStyle

CSS 类的样式修饰符。

initialPandelld

指定面板的初始 ID。

inputAssistant

指定是否启用客户端自动格式化。缺省值为 false(未启用)。

integerOnly

指定是否只对值的整数部分进行语法分析。

仅整数

指定将输入到字段中的数目限制为整数。

ismap

如果设置为 true,则图像组件被设置为使用“服务器端”图像映射。注意,图形组件必须包含在超链接组件内。

key

指定键表达式。

label

指定显示的文本。

lang

组件的值和文本内容所用的语言。如果语言被忽略,则它会从包含标记(特别是视图)继承。指定为符合 ISO 标准的语言缩写代码。例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语。
注: 此选项不是“翻译”组件中的文本,而是标识组件的语言以便搜索、排序、整理以及类似操作能够正确完成。

布局

面板方向

面板的布局:方向

指定布局(水平或垂直):

Orientation

方向

指定组件在运行时是水平定向还是垂直定向:

显示错误:布局

指定组件输出的格式为段落或列表样式:

locale

一种语言环境,在格式化或语法分析期间将使用其日期和时间的预定义样式。如果不指定此项,则使用 FacesContext.getViewRoot().getLocale() 返回的语言环境。

一种语言环境,在格式化或语法分析期间将使用其数字的预定义样式。如果不指定此项,则使用 FacesContext.getViewRoot().getLocale() 返回的语言环境。

longdesc

指定指向图像的详细描述的链接。此描述应该是使用 alt 属性提供的简短描述的补充。

loop

指定剪辑的回放是否应该无限持续或循环。缺省值为 true。

指定当影片到达最后一帧时是不断地重复还是停止。缺省值为 true。

掩码

通过使用掩码字符指定输入掩码模式。使用 # 作为数字占位符,使用 ? 作为字母占位符。

Mask

通过使用掩码字符指定输出掩码模式。使用 # 作为数字占位符,使用 ? 作为字母占位符。

maxFractionDigits

输出的小数部分中将被格式化的最大位数。

maxIntegerDigits

输出的整数部分中将被格式化的最大位数。

maxlength

在用户输入 X 个字符后

行为 > 在用户输入 X 个字符后

在最终用户将这么多个字符输入到组件之后制定控制属性。

指定输入组件可允许的最大字符长度。

指定文件名和位置的最大字符长度。

menu

指定显示的菜单类型:

mimeType

类型

用于在将 src 与二进制数据绑定时声明媒体 MIME 类型。

minimum

最小长度

当在服务器上提交时此组件可以包含的最小字符数。

当在服务器上提交时此组件可以包含的最小字符数。将具有 minimum 属性的 f:validateLength 功能添加至“全部属性”视图。

maximum

最大长度

当在服务器上提交时此组件可以包含的最大字符数。

当在服务器上提交时此组件可以包含的最大字符数。将具有 maximum 属性的 f:validateLength 功能添加至“全部属性”视图。

minFractionDigits

输出的小数部分中将被格式化的最小位数。

minIntegerDigits

输出的整数部分中将被格式化的最小位数。

name

指定组件的名称,该名称在 JSP 中应是唯一的。

指定添加的刻面的名称,例如,数据表中的 header

nestedExpanded

最初显示展开的面板

展开或折叠子代 panelActionbar。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。

nestedImagePosition

图像位置

将图像放置在子代 panelActionbar 的标签的前面或后面。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。

nestedIndent

子代 panelActionbar 的子菜单将被缩进的量。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。

nestedTitleText

标签

子代 panelActionbar 的标签。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。

nestedTitleImage

图像

指定要在标签前面或后面显示的图像。字段右边的按钮允许您浏览以搜索图像或者导入图像。

noscript

不要将 JavaScript 与此控件配合使用。

noshade

使用 3-D 加阴影显示

选择此项以便为组件提供加阴影的三维外观。如果 noshade 设置为 true,则组件将以纯色呈示。如果将此属性留空,则所使用的浏览器将按其缺省方式来显示标记。

numOfTabs

在显示 X 个选项卡之后就滚动

要显示在面板上的选项卡数。将组件中可视的选项卡数目限制为输入到字段中的数目。可以通过使用插入的滚动控件来访问其他选项卡。

pattern

模式

如果您选择定制类型号字段则它将变成活动的。确定应如何对字符串进行语法分析的定制格式化模式。

pimage

类型 > 图像:鼠标经过时的图像

指定当用户单击组件时要显示的图像。

playCount

指定剪辑播放的次数。

playerAttributes

要添加一列其他播放器属性/参数,列表应为以逗号分隔的名值对的列表。

pluginsPage

指定包含用于下载的播放器代码的 URL。如果尚未安装播放器,则将显示此属性。

pluginUrl

指定包含播放器代码的 Java™ 归档(JAR)文件的位置以进行下载。如果尚未安装播放器,则将显示此属性。

preRender

用来指定要在编码开始时调用的方法。scriptCollector 的开始阶段,即,正好在呈示组件之前调用该方法。

postRender

用来指定要在编码结束时调用的方法。scriptCollector 的结束阶段,即,呈示组件之后立即调用该方法。

promptCharacter

下划线字符(_)是此属性的缺省字符值。PromptChar 属性只能设置为一个字符。

提示字符

指定提示用户输入所要显示的字符。

quality

指定播放质量:

选项:质量

指定组件的图片质量级别。注意,高质量级别会影响性能。

readonly

boolean

控件是只读的

行为 > 控件是只读的

指定组件的初始值不可更改。

redisplay

如果在运行时设置为 true,则在提交包含密码字段的表单之后,密码星号将重新显示在相同的指定密码字段中。

regex

约束

限制可以输入至组件中的字符的类型,例如,仅数字或仅 ASCII 字母。将具有 regex 属性的 hx:validateConstraint 添加至“全部属性”视图。

rel

从当前文档至此超链接指定的锚点的关系。此属性的值是以空格分隔的链接类型列表。

renderButton

将按钮作为辅助功能挂钩呈示以进行键盘导航。

rendered

boolean

可设置为 true 或 false:

required

值是必需的

验证 > 值是必需的

必须指定组件。选择此项以要求用户输入值。

rev

从此超链接指定的锚点至当前文档的反向链接。此属性的值是以空格分隔的链接类型列表。

rowClasses

行类

在显示行时循环出现的一组类。这可以手工定义,也可以通过单击按钮并从窗口中选择期望的类来定义。

rows

每页的行数

指定在运行时显示的行数。

规则

指定哪些规则将出现在表的单元格之间:

salign

指定对齐:

scale

指定比例:

separatorSize

大小(各项之间的像素)

指定组件中各项之间的大小(以像素计)。

指定包含分隔符的已呈示表单元格的宽度(以像素计)。

separatorStyle

Style

对分隔符指定已定义的 CSS 样式表样式,例如,实线或空格。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。

shape

设置链接的形状:

showFinishCancelButton

显示完成取消按钮。

showBackNextButton

显示下一个上一个按钮。

选择此框将插入一对按钮,这对按钮可以用来在组件中的各个选项卡之间循环。

指定在面板之间浏览时是否显示上一个下一个按钮。

showDetail

指定是否显示错误的详细部分。

showSummary

指定是否显示消息的总结。

showTabs

隐藏选项卡

选择此框将指定应该对用户隐藏的组件。

一次仅显示这么多选项卡并显示用来查看未显示的选项卡的滑块按钮。

shuffle

指定演示内容中所有未播放的剪辑是否应以随机顺序回放。此参数可用于只包含一系列剪辑的多剪辑 RAM 文件(.ram 或 .rpm)或 SMIL 文件。

size

控件的宽度(以字符计)。可以通过 CSS 更精确地指定宽度。

大小:高度

指定组件的高度,用行数、像素或占屏幕的百分比来表示。

大小:宽度

指定组件的初始宽度。除文本输入组件外,宽度以像素数给出。对于文本输入组件,这个值表示字符数。

指定组件的初始宽度,其值指的是字符数。

slantActiveLeft

选择的选项卡左上方压印线的宽度。

slantActiveRight

选择的选项卡右上方边框曲线的宽度(以像素计)。

slantInactiveLeft

未选择的选项卡左上方压印线的宽度。

slantInactiveRight

未选择的选项卡右上方压印线的宽度。

选项卡边框曲线(以像素计)

选项卡左边或右边的压印线的宽度。可以设置活动和不活动选项卡的宽度。

srcFirst

表示第一个按钮的图像的 URL。

srcLast

表示最后一个按钮的图像的 URL。

srcNext

表示下一个按钮的图像的 URL。

srcPrevious

表示上一个按钮的图像的 URL。

srcSelected

当选择时要显示的图像的 URL。

srcUnselected

当取消选择时要显示的图像的 URL。

src

文件

要播放的媒体文件。指定组件要使用的文件。

standby

指定装入组件的实现和数据时浏览器可能会呈示的消息。

stretchToFit

指定是否维持要播放的视频的最初宽高比。缺省值为 false。

样式

string

样式:属性

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

styleClass

string

样式:类

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

successAction

通过其中一个预定义的操作或 JavaScript 函数指定操作,当客户端验证结果成功时将调用此操作。

successClass

指定用于表示客户端验证成功的 CSS 类。可以指定多个类。

summary

指定详细总结字符串,供用户代理呈示非可视媒体。

swRemote

控制所有 Shockmachine 功能并具有单独的子参数。有关详细信息,请参阅 Macromedia Director Support Center 中的 Shockmachine 参数。

swStretchHAlign

当 swStretchStyle 设置为 meetstage 时,指定水平对齐方式:

swStretchStyle

指定用于 Shockwave 媒体的扩展样式:

swStretchVAlign

当 swStretchStyle 设置为 meetstage 时,指定垂直对齐方式:

tabindex

integer

辅助功能 > 跳进顺序索引

指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的某个数。

tabindexStartAt

指定类别 tabindex 属性的起始编号。缺省值为 0。

target

指定当单击超链接时应将页面装入至的框架集中的目标框架:

通常,行为适用于父标记。目标可用于将行为指定给其他标记。注意,此值可识别 HTML(非 JSF)标记。可以提供 #body 以将行为应用于整个页面。

根据标记标识来指定操作目标。当未指定目标但设置了操作时,缺省目标为事件源对象。

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

targetAction

指定预定义的操作。

textStyleClass

应用于文本字段的 CSS 类。这样使得当在 CSS 中使用 ELEMENT.className 表示法时能区别 input type=submit 和 input type=text。

timeStyle

时间样式

预定义的格式化样式,它确定如何格式化日期字符串的时间部分并对其进行语法分析。仅当类型是“时间”或“时间和日期”时此属性才起作用。当选择日期/时间时就会出现。允许您从以下几种时间格式中选择一种:

timeZone

用来解释日期字符串中的任何时间信息的时区

title

string

辅助功能 > 标题

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。

tooltip

指定是否以工具提示的形式显示消息的详细信息部分。

类型

类型

指定按钮类型,如提交复位纯文本

指定组件应该使用数据库中的一项

指定组件将使用的数字类型:
对话框的类型。模态对话框阻止使用键盘或鼠标在对话框下面的窗口中进行输入,必须填充该对话框并单击“确定”或“取消”,然后才能在页面中执行任何其他操作。非模态对话框:不是以块方式在对话框“下面”的窗口中输入。
注: 一次可能可以显示多个非模态对话框。如果同时显示了多个模态对话框,则这些对话框将叠放,只有最前面的对话框才是活动的。

指定输出字段中是显示日期、时间还是两者都显示。

uiMode

指定嵌入式 Windows Media Player 的外观:

url

指定组件应使用的 URL。

useButtons

呈示文本按钮而不是图像。

usemap

指定要与组件配合使用的图像映射。该图像映射是由 MAP 元素定义的。usemap 的值必须与相关联 MAP 元素 name 属性的值相匹配。

验证

指定是否启用客户端验证。缺省值为 true(启用)。

validator

要实例化的验证器的类名。

接受 FacesContext、UIComponent 和 Object 参数的方法(由 MethodBinding 表达式表示)。在验证过程中将调用它以确保组件值正确。

valign

对齐:垂直

指定单元格中数据的垂直位置:

value

指定链接所连接至的文档。此值可以是包含文档文件名的字符串,也可以是文档的二进制数据。指定二进制数据是结合设置 MIME 类型属性来完成的。此值可以是字符串(用基本 64 位编码)、byte[] 或 java.io.InputStream 对象。指定二进制数据时,绑定表达式的值必须能够在浏览器发送回至服务器以获取文档的后续请求中进行自行计算。

指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。

文件

指定组件要使用的文件。此值可以是字符串(文件内容将是基本 64 位编码的)、byte[] 或对象。

输入 > 文本:按钮标签

指定在命令按钮中要显示的文本。

URL

指定组件链接至的页面。当在页面上创建了链接时,可以手工指定该页面;也可以通过单击按钮并从窗口中选择页面来完成。

valueChangeListener

当组件的值更改时要通知的方法。

var

使用 value 属性指定可用数据的引用变量名。

variableTabLength

指定选项卡是否根据它们的名称具有不同的长度。

variableTableLength

选项卡布局:按统一宽度显示选项卡

指定按相同宽度来显示组件中的所有选项卡。

volume

指定音量,范围从 –10,000 至 0(以百分之一分贝为单位)。缺省值是 –600。

vspace

页边空白:垂直

指定要插入组件上下两边的空格大小(以像素计)。

warnClass

与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。

warnStyle

CSS 类的样式修饰符。

width

宽度

大小:宽度

指定组件的宽度(以像素计或以百分比计)。要指定要使用百分比,请在值后面追加 %。

wmode

指定 Flash 影片的“窗口方式”属性以确定影片在浏览器中的透明效果、分层和定位:

onblur

日期更改时将调用 JavaScript 事件处理程序。

onclick

当鼠标指针在组件上时,如果单击鼠标按键,则将调用 JavaScript 事件处理程序。在各个 mousedown 和 mouseup 事件后触发。如果移动了鼠标指针,例如,在指针处于组件外部时松开按键,则将不会触发。

onblclick

当鼠标指针在组件上时,如果双击鼠标按键,则将调用 JavaScript 事件处理程序。在各个 mousedown 和 mouseup 事件后触发。在这种情况下,不会触发 click 事件。

onfocus

组件获得焦点时将调用 JavaScript 事件处理程序。

onkeydown

按下键盘键时将调用 JavaScript 事件处理程序。

onkeypress

由于按下键盘键而形成字符时将调用 JavaScript 事件处理程序。按下“功能”键或“控制”键时是否触发事件取决于浏览器。

onkeyup

释放键盘键时将调用 JavaScript 事件处理程序。

onmousedown

当鼠标指针在组件上时,如果按下鼠标按键,则将调用 JavaScript 事件处理程序。

onmousemove

当鼠标指针在组件上时,如果移动鼠标指针,则将调用 JavaScript 事件处理程序。虽然每次指针至少移动一个像素时该事件应该触发,但是各种浏览器在有关构成移动的间隔方面有所不同。

onmouseout

当鼠标指针在组件外部(远离组件)时,将调用 JavaScript 事件处理程序。在此事件之前应该已触发 mouseover 事件。

onmouseover

当鼠标指针初始移到组件上面时,将调用 JavaScript 事件处理程序。

onmouseup

当鼠标指针在组件上时,如果释放鼠标按键,则将调用 JavaScript 事件处理程序。

<hx:behavior>

将 JWL 操作和/或 JavaScript 指定给 DOM 事件处理程序。

<hx:behaviorKeyPress>

当组件或组件的内容具有焦点时,将 JWL 操作和/或 JavaScript 指定给按下功能/控制键这一操作。

<hx:behaviorRightMouse>

在组件或组件的内容上单击鼠标右键时,对这一操作指定 JWL 操作和/或 JavaScript。

<hx:ajaxRefreshRequest>

如果重新取回内容的请求包括的参数可用于改变面板的内容,则将该面板标记为可执行 AJAX 操作。

<hx:ajaxRefreshSubmit>

如果重新取回内容的请求会提交包含表单的内容,以便使用这些表单内容来改变面板的内容,则将该面板标记为可执行 AJAX 操作。

<hx:ajaxExternalRequest>

如果重新取回内容的请求被定向至的页面不是一个包含面板的页面,例如,定向至“外部数据源”,则将该面板标记为可执行 AJAX 操作。

flyOpen

boolean

如果设置为 true 或省略,则当您将鼠标指针悬停在包含子菜单的顶级菜单中的菜单项上时,将显示子菜单。如果设置为 false,则必须单击包含子菜单的顶级菜单中的菜单项,才能看到子菜单。

flyOpenBody

boolean

如果设置为 true 或省略,则当您将鼠标指针悬停在包含子菜单的顶级菜单中的菜单项上时,将显示子菜单。如果设置为 false,则必须单击包含子菜单的顶级菜单中的菜单项,才能看到子菜单。

initialSelection

string

菜单项的 ID 初始显示为“已选中”,它是 CSS 定义的另一可视状态。

openInPlace

boolean

如果为 false 或省略,则将在“单独窗口”中显示子菜单,即,子菜单悬停在页面内容上。如果为 true,则子菜单将“就地”打开,即,将在菜单栏中父菜单项后面打开一个空间,然后子菜单显示在该空间中。这允许菜单成为“树形的”,类似于 Windows 资源管理器。在菜单树的各个级别,只有一个子菜单“就地”显示。如果显示其他子菜单,则将“关闭”(隐藏)任何其他“就地”显示的菜单,然后才显示新的菜单。如果菜单是 openInPlace,则它也是粘滞的。
注: 如果在水平菜单中使用了 openInPlace,则它可能无法正常呈示。
注意:

openSticky

boolean

如果省略或为 false,则子菜单将显示为“弹出菜单”,且仅在处于“活动”(指针悬停在它们的父菜单项上或它们的父菜单项已被单击)状态时才显示。如果为 true,则对于顶级菜单下面的各个级别来说,仅该级别中最后一个“活动”(指针悬停在其上/被单击)子菜单才会留在屏幕上。
注: 顶级菜单始终为粘滞的。此属性仅影响子菜单。

selectAll

boolean

如果提供了初始所选项或通过 JavaScript 设置了所选项,则指定是仅将子菜单项显示为“已选中”(false 或省略),还是将从包含的父菜单向下到子菜单项的所有菜单项都显示为“已选中”。

vertical

boolean

如果为 true,则将垂直显示顶级菜单。如果为 false 或省略,则将水平绘制。

verticalBody

boolean

如果为 true 或省略,则将垂直显示子菜单,即顶级菜单之外的所有菜单。如果为 false,则将水平绘制。

onchange

JavaScript

如果提供,则每当执行操作时将调用此函数。

altClass

boolean

如果为 true,则将通过“替代类”CSS 类来设置此菜单项的样式。如果为 false 或省略,则将通过“普通”CSS 类来设置此菜单项的样式。

itemDisabled

boolean

如果为 true,则将禁用此菜单项。如果为 false 或省略,则不会禁用此菜单项。

actionClick

boolean

如果为 true,则单击此菜单项将同时执行与其相关联的标记(例如,执行 requestLink)和显示与其相关联的子菜单。仅当应用于标题构面中的子标记时,即应用于包含相关联子菜单的菜单项时,此属性才有意义。缺省情况下,如果单击没有任何子菜单项的菜单项,则将执行该菜单项。同样地,如果单击任何包含相关联子菜单的菜单项,则将仅显示该子菜单。在某些情况下,通常是在构建导航结构时,单击包含相关联子菜单的菜单项需要同时执行操作(例如,获取指向不同框架的页面) 和显示该子菜单。

multiLine

boolean

缺省值为 true。如果为 true,则日历的标题区域将显示在两行中,一行显示年份,一行显示月份。如果为 false,则在一行中显示标题区域。

border

要在包含选项列表的表周围绘制的边框宽度(以像素计)。

converter

要与此组件配合使用的定制转换器的 ID 或类名。如果定制转换器是在 TLD 中定义的,则它也可以通过将该转换器标记用作组件的子标记来指定。

onselect

颜色更改时将调用 JavaScript 事件处理程序。

buttonBorder

控制如何根据输入字段来绘制按钮。缺省情况下,以一种适合于浏览器的操作系统的方式来绘制按钮,以便该按钮看起来像组合框按钮。例如,在 Windows 2000 或 Windows 9X 中,按钮是作为边框的一部分来绘制的。在 WindowsXP 中,按钮是在输入字段右边单独绘制的。可以设置以下值:

buttonColor

指定按钮的背景色。缺省情况下,背景色与输入字段的边框颜色相匹配。此属性的使用属于限制值,它当前只是一个占位符,用于将来扩展以允许提供备用按钮背景图形。

dropdownClass

这个类是 CSS 类集的基类,描述下拉弹出菜单的可视外观。注意,此名称不包括后缀,例如,它是 inputColor1,而不是 inputColor1_ColorPicker。

showLabels

如果指定(true),则当前所选颜色的名称将显示在输入字段中该颜色样品的上面。如果省略(或 false),则名称不显示,并且输入字段将仅显示一种颜色样品,指示当前所选颜色。
注: 确保颜色拾取器的宽度设置为足够大的值,可以容纳最大的名称,否则颜色拾取器可能无法正常显示。

auto

如果为 true,则进度条是自定时的,并且在启动后,它将自动以指定时间间隔进行更新。如果省略或为 false,则必须手工更新进度条。在进行 JavaScript 调用后,它将重新绘制进度条以指定当前状态。如果 auto 为 true,则进度条不会显示已完成百分比。如果为 false,则它会显示已完成百分比。

initHidden

如果为 true,则当页面初始显示时,进度条是隐藏的。应该使用此选项取代在进度条的样式中设置“display:none”。

message

该消息显示在进度条的上方。在进度条正在运行时,可以通过 JavaScript 来更改消息。

outward

如果为 true,则进度条将从中心向外绘制。如果省略或为 false,则进度条将从左到右绘制。

proportion

如果 auto 为 true(可选,缺省值为 5),则该值为每当进度条更新时进度条增加的大小,即进度条宽度的百分比。例如,如果值为 10,则意味着每增加一次,将使进度条的宽度增加总宽度的 10%。如果 auto 为 false 或者未设置(可选,缺省值为 0),则该值为进度条初始显示的大小(百分比)。例如,如果值为 15,则意味着进度条显示起始值为 15%。

initValue

如果 auto 为 false 或者未设置(可选,缺省值为 0),则该值为进度条初始显示的大小(百分比)。例如,如果值为 15,则意味着进度条显示起始值为 15%。

timeInterval

如果 auto 为 true,则该值为进度条的更新时间间隔(频率)。以毫秒指定,例如,值为 5000 表示进度条每隔 5 秒改变一次。

enableMoveKey

如果省略或为 true,则在可移动对话框中的某一项具有焦点时,可以通过在键盘上按下 Ctrl+Shift+箭头键来移动该对话框。如果为 false,则不能通过键盘来移动可移动对话框。

initiallyShow

如果为 true,则当装入页面时,将显示对话框,调用 onshow 处理程序,禁用主窗口。如果为 false,则开始时不显示该对话框。

initialFocus

如果提供了 ID,则将显示对话框,开始时焦点将设置在此字段中,必要时选择字段的内容。如果省略或为 false,则将显示对话框,焦点将设置在对话框中第一个可以获得焦点的字段中。

movable

指定是否可以通过在标题栏上按鼠标光标并将对话框拖到不同位置,或使用键盘等效键将对话框拖到不同位置,来移动对话框。如果为 false,则不能移动对话框。
注: 如果对话框可移动,但没有标题栏,则它只能使用键盘加速键来移动。

relativeTo

如果提供了 ID,并且 align 或 valign 已设置为“相对对齐”,则将根据所标识的标记进行对齐。

saveState

如果为 true,则当对话框显示时,将对对话框中所有“表单”字段内的值进行备份,例如,保存输入和文本区域的值。为对话框编写的事件处理程序可以按程序方式获得已保存的值,而且在单击“取消”后,将使用这些值来恢复值的状态。如果为 false,则不保存值,而且在单击“取消”后,不会将值恢复为它们在对话框首次显示时的状态。

showTitleBar

如果为 true 或省略,则将在对话框顶部显示标题栏。如果为 false,则不会显示标题栏。

showTitleCloseButton

如果为 true 或省略,则将在标题栏(如果显示)中显示“关闭”按钮。如果为 false,则不会显示“关闭”按钮。
注: 单击“关闭”按钮和单击“取消”按钮一样。

titleCloseButtonImage

要用作“关闭”按钮的图像的 URL。(也可以通过 CSS 指定。)

onshow

显示对话框时要运行的 JavaScript 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发显示的事件。

onhide

不显示对话框时要运行的 JavaScript 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发隐藏的事件。如果因为单击对话框中的“确定”或“取消”按钮(或等效于“取消”按钮的“关闭”按钮)而隐藏了对话框,则 thisEvent.dialogAction 的值将根据被单击的按钮而为 确定取消

initClosed

如果设置为 false,则该部分初始呈示为“展开”。如果设置为 true 或省略,则它呈示为“折叠”。

helpPosition

定义与面板包含的所有 formItem 相关联的帮助和/错误文本位置:上和下位置帮助/错误文本在 formItem 值的正上方/正下方(与值的左边缘对齐);左和右位置帮助/错误文本在值的左边/右边。
注: helpPositionshowInPopup 影响。如果 showInPopup 为 false,则与每一项相关联的帮助/错误文本将显示在其自己的表单元格中,会对表添加行或列以容纳帮助/错误文本。如果 showInPopup 为 true,则帮助/错误文本将显示在绝对定位 div 中,即,不会占用可视的行/单元格。不管文本是显示在单元格中还是显示在 div 中,labelPosition 都参照 formItem 的值来定义单元格/div 的位置。

interItemSpacing

如果提供,则定义所呈示的表中各行之间的间隔。此值可以是任意 HTML 宽度规格,例如,“4px”、“1em”或“4%”。如果未指定宽度,则使用像素(px)。如果指定了百分比,则此值是有效宽高的百分比,例如,150% 表示行高的 1.5 倍。
注: 间隔也可以使用 panelFormBox_Spacer-Cell 类来设置。

labelPosition

定义与面板包含的所有 formItem 相关联的标签位置:上和下位置标签在 formItem 值的正上方/正下方(与值的左边缘对齐);左和右位置标签在值的左边/右边。
注: 此属性不会影响 panelFormBox 标记的标签属性。但此属性会影响与包含的 formItem 标记相关联的标签。

showInPopup

定义是以内联方式作为一个可导致表展开/收缩的表单元格,还是作为一个根据表单项内容进行绝对定位的 div 来显示与面板包含的所有 formItems 相关联的帮助和/或错误文本。弹出菜单的相对位置(左、右、下和上)由 labelPosition 定义。弹出菜单以大于基本值的 z 顺序来显示,并定位在内容之上。

widthContent

如果提供,则指定显示值(内容)的列的宽度(以像素或百分比计)。
注: 列宽也可以使用 panelFormBox_Content-Cell 类来设置。

widthHelp

如果提供,则指定显示帮助的列的宽度(以像素或百分比计)。
注: 列宽也可以使用 panelFormBox_Help-Cell 类来设置。

widthLabel

如果提供,则指定显示标签的列的宽度(以像素或百分比计)。注意,列宽也可以使用 panelFormBox_Label-Cell 类来设置。

errorText

formItem 中字段的值无效时将显示的文本。如果省略,则当字段无效时,将使用“系统提供的”错误文本。提交包含该 formItem 的表单时,将在服务器上验证字段。如果任何字段的值无效,则将再次显示该页面,并显示该 formItem 的 errorText,它取决于 showHelp 属性。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示服务器上为此字段生成的消息(h:message)。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。此外,字段可以启用客户端验证,如果字段为必需,则客户端验证始终是启用的。当字段失去焦点(onblur 触发)时,将运行客户端验证。如果字段验证失败,则将显示错误。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示来自 hxclient 字符串资源文件的适当消息。如果提供了 errorText,则当字段无效时,将显示一致的错误消息,而与错误的标记方式或标记位置无关。不管错误是由客户端验证标记还是由服务器端验证标记,都将在同一位置显示同一错误。

infoText

要与此项一起显示的其他参考或帮助文本。例如,它可以提供有关用户应输入的内容的详细信息,也可以描述字段的计量单位。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。对于 errorText 和标签,HTML 可以嵌入在字符串中。

releaseMargin

面板中 formItem 的内容根据面板的 labelPosition 和 helpPosition 属性在表列中进行对齐。例如,所有标签放在一列中,而所有内容放在邻近的列中。设置 releaseMargin 会将此项从该规则中“释放”。设置 releaseMargin 后,此 formItem 的内容将合并在子表中,该子表已插入在面板的表中。因此,子表的内容是单独对齐的。如果一项的标签(或内容)明显宽于或窄于其他项的标签(或内容),则往往使用 releaseMargin。通过“释放”此项,此项的元素可以单独对齐,而不会强制面板中的所有其他项变得“太宽”。注意,仅当标签和/或消息显示在字段的左边/右边时,releaseMargin 才有意义。如果标签和/或消息显示在字段的上方/下方,则 releaseMargin 基本不起什么作用。

showHelp

确定对此项显示 infoText 和 errorText 的方式(时间)。如果为“始终”,则信息文本将始终显示,除非发生错误,在发生错误的情况下,错误将显示在信息文本所在的位置。如果为“根据需要”,则当此字段具有焦点时将显示信息文本,除非发生错误。如果发生错误,则将始终显示该错误。如果为“信息”,则将始终显示信息文本。从不显示错误文本。如果为“错误”,则从不显示信息文本。如果发生错误,则显示错误文本。如果为“无”,则不管是信息文本还是错误文本,都从不显示。

behaviorAction

要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

event

行为所连接至的事件的名称。例如,“onclick”。它必须包括“on”前缀。

onActionFunction

要执行的 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理。

targetAction

要运行的操作的目标。缺省情况下,操作的目标是对其指定(作为子代或通过目标)行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetFacet

通常,行为适用于父标记。targetFacet 可用于将行为指定给已命名构面的内容。

autoSubmit

如果 autoTab 为 true,而且 autoSubmit 为 true,则当用户在当前字段中输入足够字符数时,就可以自动进入下一字段,而不用手工进入下一字段,此时,将提交包含当前字段的表单。此属性主要供尝试仿真某些“老式”输入机制(例如,仿真 3270 终端)的应用程序使用。

autoTab

如果为 false 或省略,则当输入最大字符数时,焦点不会进入下一字段。如果为 true,则当在字段中输入最大字符数时,焦点将进入下一字段。要使 autoadvance(自动进入)正常工作,字段的模式应明确地标识字段中的最大字符数,或者对字段设置最大长度。例如,模式 ##9 就不明确。虽然可以为一个正数输入三个字符,但如果是负数,则应输入四个字符。因此,在这种情况下,应该设置最大长度。

errorAction

如果验证已设置为 true,则该值表示 onblur 被触发、字段值验证失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

imeMode

如果提供,则当字段获得焦点时,CSS imeMode 属性将设置为提供的值。此属性仅适用于支持 CSS imeMode 属性的浏览器,当前,仅 Internet Explorer 支持此属性。

inputAssist

当前不可用。如果启用了 inputAssist,则它将打开字符检查以验证输入的字符是否有效。

onerror

如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。

onfocuserror

如果提供,则当 onfocus 触发且字段值转换失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。

onfocussuccess

如果提供,则当 onfocus 触发且字段值通过转换时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。

onfocusErrorAction

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值转换失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

onfocusSuccessAction

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

onfocusSuccessClass

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要应用于此字段的 CSS 类的名称。

onsuccess

如果提供,则当 onblur 触发且字段值通过验证时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。

promptCharacter

如果提供,则字段将被置入辅助方式,在这种情况下,字段中的每个字符位置都将显示带有字段的指定提示字符或当前值。对于日期/时间字段,可以使用所有数字字符来表示日期。只能在每个位置中输入有效字符。在用户输入时,光标会自动前进到相应的位置。

successAction

如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

successClass

如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要应用于此字段的 CSS 类的名称。

targetErrorAction

该目标与 errorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetOnFocusErrorAction

该目标与 onFocusErrorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetOnfocusSuccessAction

该目标与 onFocusSucessAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetSuccessAction

该目标与 successAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

select

如果为 true,则获得焦点的字段的内容在开始时已选中。如果省略或为 false,则开始时获得焦点的字段的内容未选中。

inProgress

属性尚不可用。

matchWidth

如果为 true,则建议下拉菜单与输入字段一样宽。如果为 false,则其宽度由下拉菜单的 CSS 来确定。

maxSuggestions

显示的最大建议数目。

startCharacters

在提出建议之前输入字段中必须具有的最小字符数。

startDelay

提出建议之前的延迟时间(以毫秒计),即,如果用户在 startDelay 毫秒内输入第二个字符,则不会对第一个字符提出建议。

oncomplete

如果请求成功,则替换面板的内容后,将执行此 JavaScript 函数。此函数没有任何有意义的参数。

onstart

当行为开始执行时,将执行此 JavaScript 函数。此函数没有任何有意义的参数。如果它返回 false,则将中止执行。此函数可以与 oncomplete 配合使用来定制执行请求过程中所显示的内容。

params

这些标记的值将检索并作为 params 追加至用于获取新内容的 URL。param 的名称将是提供的简单 ID。例如,如果 ID 是“text1”,则 param 将命名为“text1”而不是“form1:text1”。

允许作为子标记

此标记可用作下列标记的子代
  • <hx:panelActionbar>
  • <hx:panelBox>
  • <hx:panelDialog>
  • <hx:panelFormBox>
  • <h:panelGrid>
  • <h:panelGroup>
  • <hx:panelLayout>
  • <hx:panelMenu>
  • <hx:panelSection>

允许的内容

此标记将重建面板标记(如上所列的允许标记)的内容。正在重建的面板可包含任何 JSF 标记,下列标记除外
  • <hx:scriptCollector>
  • <f:subview>
  • <f:view>
  • <hx:viewFragment>
  • <hx:inputHelperFormTracker>
  • <hx:inputHelperSetFocus>
  • <r:inputRichText>
  • <odc:tabbedPanel>
  • <odc:bfPanel>
  • <odc:buttonPanel>
  • <odc:tree>
  • <odc:treeNodeAttr>
  • <odc:graphDraw>
  • <odc:graphDrawData>
  • <odc:graphDrawDataSeries>
  • <odc:graphDrawLabels>

href

对请求作出响应的 JSP 的 URL。对此组件发出 JWL Get 操作时,将使用指定 URL 检索与该组件相关联的面板的新内容。

source

目标 URL 中标记的 ID,该标记的内容将替换此组件所关联的容器的内容。如果未指定 ID,或者在 URL 所引用的页面中找不到该 ID,则将使用容器的 ID。如果在 URL 所引用的页面中找不到此 ID,则将使用主体内容。

dateStyle

预定义的格式化样式,它确定如何格式化日期字符串的日期组件并对其进行语法分析。仅当类型为“日期”或“日期和时间”时适用。

timeStyle

预定义的格式化样式,它确定如何格式化日期字符串的时间组件并对其进行语法分析。仅当类型为“时间”或“日期和时间”时适用。

timeZone

时区,用来解释日期字符串中的任何时间信息。值必须是根据 java.util.TimeZone 实例来计算的 VB 表达式,或者是作为时区 ID 的字符串,如 java.util.TimeZone.getTimeZone() 的 javadocs 中所述。

calendar

要用于表示日期/时间的日历系统。缺省为格里高利日历。可用日历包括:

char1RegEx

该正则表达式描述在掩码模式中标有 # 字符的位置处所允许的字符。如果省略,则将使用表达式 [0-9],允许使用数字 0 至 9。

char2RegEx

该正则表达式描述在掩码模式中标有 ? 字符的位置处所允许的字符。如果省略,则将使用表达式 [a-zA-Z],允许使用 ASCII 字母字符。

char3RegEx

该正则表达式描述在掩码模式中标有 ! 字符的位置处所允许的字符。如果省略,则将 ! 字符视为模式中的文字。

char4RegEx

该正则表达式描述在掩码模式中标有 ~ 字符的位置处所允许的字符。如果省略,则将 ~ 字符视为模式中的文字。

掩码

描述值的文字和字符的模式。

protectMask

保护“标记”位置中的字符免遭更改(或验证),例如,您可以“保护”字符串中包含标记(#、?、! 和 ~)的位置以便用户不能输入此字符,取而代之的是按程序方式来设置该位置的值,该值通常在初始值中。这可以有效地将值中的字符转换为文字。仅当此掩码在 inputText 字段中使用并且该字段启用了输入辅助时,此属性才有用。如果提供了 protectMask,则它与掩码应该是长度相同的字符串。如果位置中有 X(大写 X),则此位置已标记为“受保护”。不保护没有 X 的位置。

currencyCode

ISO 4217 货币代码,仅适用于对货币进行格式化。

currencySymbol

货币符号,仅适用于对货币进行格式化。

groupingUsed

标志,指定格式化的输出是否包含分组分隔符。缺省值为 true。

integerOnly

标志,指定是否仅对值的整数部分进行格式化和语法分析。

maxFractionDigits

输出的小数部分中将被格式化的最大位数。

maxIntegerDigits

输出的整数部分中将被格式化的最大位数。

minFractionDigits

输出的小数部分中将被格式化的最小位数。

minIntegerDigits

输出的整数部分中将被格式化的最小位数。

itemDescription

此选项的描述,在开发工具中使用。

itemLabel

此选项的标签,向用户显示。

itemValue

在用户选择了此选项时,向服务器返回的值。

maximum

最大日期,指定方式为 yyyy/mm/dd hh:mm:ss。

minimum

最小日期,指定方式为 yyyy/mm/dd hh:mm:ss。

expression

表达式语言(EL)表达式,返回布尔值,其中 true 表示值有效,而 false 表示值无效。

modulus

指定要使用的 IBM® 模数算法 - 模数 10 公式或模数 11 公式。缺省情况下,使用模数 10 公式。

对于 selectOne 组件无效的值
注:
根据 JSF 标准,对页面进行初始呈示时,JSF 生命周期不会验证值。例如:
<h:inputText id="text2" styleClass="inputText" value="#{pc_Sa_RATLC00298618.myBean.myBigDecimal04}">
	<hx:convertNumber/>
	<f:validateDoubleRange minimum="10.0" maximum="99.0">
	</f:validateDoubleRange>
</h:inputText>
开始时,如果对值进行解析,发现解析后的内容不在指定范围之内,则 JSF 工具不会在 <h:message> 标记中对此错误进行标记。此时,将假定有意使用无效值,以便用户可以对其进行更正或显示输入消息。

如果包含此无效值的标记是一个 selectOne 组件,例如,组合框、列表框或单选按钮组,则在呈示页面时,不会对 HTML 标记设置初始值,即未选择任何选项。这是因为无法找到与该无效值相匹配的选项。

即使在列表框或单选按钮组中选择了内容,但由于假定您正尝试强制用户选择值,所以浏览器不会显示任何所选内容。提交页面时,如果所作选择无效,则不会提交值,即,不提交任何所选内容。如果字段标记为“必填”,则将生成错误。

如果是组合框,则即使操作相同,浏览器行为也不尽相同。如果组合框所选项无效,则浏览器将使第一个值成为所选项。因此,提交页面时,将始终提交一个有效的值。


反馈