某些组件在选用板上可能处于隐藏状态。要显示选用板中的隐藏组件,请在“选用板”视图中右键单击并选择定制。对于每个要显示在选用板中的组件,请除去隐藏旁边的选取标记。最初处于隐藏状态的组件在下面将用星号(*)表示。组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性;不过,缺省情况下,该视图是打开的。
允许您指定“复选框组”组件中各个框的名称、值和顺序。可以添加单个或一组选项。
允许您指定“单选按钮组”组件中各个单选按钮的名称、值和顺序。可以添加单个或一组选项。
允许您指定 selectOneColor 组件中各种颜色的名称、值和顺序。可以添加单个或一组选项。
允许您指定“输出消息”参数的名称和值。您还可以使用“除去”按钮除去某些项,并使用“上移”和“下移”按钮来更改这些项在面板中的顺序。
允许您指定“面板 - 选项卡式”组件中各个选项卡的 ID、标签和顺序。另外,您还可以指定各个选项卡包含预定义的完成和取消命令按钮组件。
添加具有行分类组件的列,可以在该组件中设置表排序值并将图标或文本添加至该列。一旦添加了该列,“分类”图标就会更改为“除去”。
对页脚添加一个组件,该组件将创建简单下拉菜单以便移至下一页。
指定击键、操作以及这些操作在表单组件中的目标。击键和操作是从下拉列表中选择的。而目标也是从下拉列表中选择的,并且该下拉列表所填充的内容就是表单中显示的输入字段。每当在表单中按下该键时,就会执行此操作。
指定要用作背景的图像。单击“浏览”按钮以选择图像文件或者与数据源绑定。
切换至“快速编辑”视图,以便可以编写超链接要执行的操作的代码。另外,还可以根据操作和返回的结果来定义规则。
切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。
指定页眉或页脚是否要包括在数据表中。使用“添加”和“除去”按钮来添加或删除列。使用“上移”和“下移”按钮来修改各列的顺序。
插入与所选组件相关联的错误消息组件。如果验证失败,它将显示错误消息。
掩码:指定通过有选择地包括或排除某些值对用户提供的输入进行过滤。
选项 > 打开一个窗口,它将显示可以为此组件设置的定制属性的列表。
允许您使用“上移”和“下移”按钮来指定面板中各个组件的顺序。
选择此框会将页眉区域 f:facet (header) 和 h:panelBox 插入到数据表中,然后可以向该页眉区域中填充其他组件。
使用简单验证 > 允许您输入一个简单的最小和最大范围,组件将针对该范围进行验证。
使用高级验证 > 允许您指定一个更高级的表达式以使用 EL 语法进行验证。
指定显示页面时将具有初始焦点的字段。可以指定页面中的第一个字段或特定字段,由它们的标识来确定。
“全部属性”视图属性
需要响应客户机时使用的字符集。标准 HTML 属性。请参阅 HTML 表单标记:此属性指定处理此表单的服务器接受的输入数据字符编码列表。此值是空格分隔和/或逗号分隔的字符集值列表。客户机必须将此列表解释为异或列表,即,对于每个接收到的实体,服务器能够接受任意单字符编码。
将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。
指定当单击组件时返回的值。此值传递至缺省导航处理程序,然后根据在应用程序配置文件中定义的一组导航规则对此值进行匹配。
该表达式指向一个带有 ActionEvent 参数和“void”返回类型的方法。
指定组件的备用文本。例如,如果元素在不支持表单的浏览器中和在设置为不显示图像的浏览器中不能正常呈示,则显示此备用文本。
与用于呈示“媒体组件”的对象 HTML 标记相关联的属性,用于对包含与对象相关资源的归档指定以空格分隔的 URL 列表。
选择此框将指定操作栏中的各项之间会出现分隔符行。如果 autoseparate 设置为 true,则在呈示时自动在每个包含的组件之间插入分隔符项。如果将它留空,则缺省为 false,不会插入分隔符。
如果 autostart 设置为 true,则丰富媒体文件将开始在组件中自动播放。选择此项将导致组件在运行时自动启动。
在输入了指定的字符数之后自动进入另一个输入字段。缺省值为 false。
指定是启用还是禁用自动跳进。在输入了指定的字符数之后自动将用户带往另一个输入字段。选择此框之后,会将 hx:inputHelperAssist 部分添加至“全部属性”视图并将 autoTab 设置为 True。
设置图像窗口的背景色。当某个剪辑包含透明区域时,背景色也会透过这些区域显示出来。
指定 Media Player 将用来操作的基本 URL。有关更多信息,请参阅 MSDN 库中 baseURL 的 Windows® Media 文档。
使用以 # 符号开头的 6 位十六进制 RGB 值指定背景色,或者通过输入颜色名称(例如,黑色、白色或蓝色)来指定背景色。
指定影片本身显示之前影片矩形的颜色。值是用标准的六个十六进制字符 RGB 颜色表示法来表示的,例如,#FFFF00。
该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。
指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。
指定单元格边框与单元格内容之间的间隔距离。如果此属性的值是一个像素长度,则内容与四个边的距离都应是这一距离。
指定演示内容是否应在图像窗口中居中并按它的原始已编码的大小显示。
指定用于解析由组件中其他属性指定的相对 URI 的基本路径。
指定类别行的初始折叠状态。值可以是 true 或 false。如果留空,则表示缺省值是 true。
用以 # 符号开头的 6 位十六进制 RGB 值指定选定组件的颜色,或者通过输入颜色名称(例如,黑色、白色和蓝色等)来指定选定组件的颜色。
为数据表组件的列指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。
在表中添加列组件,或从表中除去列组件。可以对每个列设置标签、宽度和 ID,并将它们移到表中。
指定要显示的文本,此文本在按 commandExButton 时请求确认。如果未对此属性设置值,将不会显示“确认”对话框。
当对 Web 页面上的多个控件指定同一个控制台名称时,可使用此参数来允许这些控件管理单个嵌入式表示的回放。例如,如果在同一个页面上有许多“播放”和“停止”按钮,则共享的控制台名称使它们能够控制同一段剪辑。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
将指定的 RealPlayer 控件嵌入到 Web 页面上。
指定值所转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。
指定要输入的货币符号。如果您指定货币符号类型,则它将变成活动的。
用来指定在 scriptCollector 组件的解码阶段调用的方法。
如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果留空,则缺省值为 false。
如果设置为 true,则在运行时将显示“取消”按钮,但它不起作用。如果留空,则缺省值为 false。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
如果设置为 true,则在运行时将显示“完成”按钮,但它不起作用。如果留空,则缺省值为 false。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
通过其中一个预定义的操作或 JavaScript™ 函数指定操作,当客户端验证结果产生错误时将调用此操作。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
指定用于表示错误的 CSS 类。当在输入字段单击有效的键时,样式将被重新设置为 successClass 样式。如果未指定 successClass,则使用 input_text 的 css 类。如果既未指定 errorClass 也未指定 successClass,则不会重新设置该 css 类。可以指定多个用逗号分隔的类,例如:errorClass="class, class2, class3"。
指定是对 HTML 格式进行转义(False)还是将 HTML 标记呈示为 HTML(True)。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
指定辅助控件组件要应用于的组件。该值应是所辅助的组件的 ID。
指定组件应该显示哪些错误消息,是显示由页面生成的所有错误消息(False),还是只显示尚不相关联的组件的错误消息(True)。
为数据表组件的列标题指定已定义的 CSS 样式表样式。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。这可以手工输入,也可以通过单击按钮并从窗口中选择期望的类来输入。
指定组件的高度(以像素或百分比计)。要指定以百分比计,请在值后面追加 %。
与“bundle”属性配合使用,imageKey 属性与在束中指定的一组“key=value”对中的键相关,而其中的“值”则为图像文件的 URL/URI。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
指定是否启用客户端自动格式化。缺省值为 false(未启用)。
如果设置为 true,则图像组件被设置为使用“服务器端”图像映射。注意,图形组件必须包含在超链接组件内。
一种语言环境,在格式化或语法分析期间将使用其日期和时间的预定义样式。如果不指定此项,则使用 FacesContext.getViewRoot().getLocale() 返回的语言环境。
一种语言环境,在格式化或语法分析期间将使用其数字的预定义样式。如果不指定此项,则使用 FacesContext.getViewRoot().getLocale() 返回的语言环境。
指定指向图像的详细描述的链接。此描述应该是使用 alt 属性提供的简短描述的补充。
指定当影片到达最后一帧时是不断地重复还是停止。缺省值为 true。
通过使用掩码字符指定输入掩码模式。使用 # 作为数字占位符,使用 ? 作为字母占位符。
通过使用掩码字符指定输出掩码模式。使用 # 作为数字占位符,使用 ? 作为字母占位符。
用于在将 src 与二进制数据绑定时声明媒体 MIME 类型。
当在服务器上提交时此组件可以包含的最小字符数。将具有 minimum 属性的 f:validateLength 功能添加至“全部属性”视图。
当在服务器上提交时此组件可以包含的最大字符数。将具有 maximum 属性的 f:validateLength 功能添加至“全部属性”视图。
展开或折叠子代 panelActionbar。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。
将图像放置在子代 panelActionbar 的标签的前面或后面。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。
子代 panelActionbar 的子菜单将被缩进的量。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。
子代 panelActionbar 的标签。只有在一个 panelActionbar 嵌套在另一个 panelActionbar 里面时适用。
指定要在标签前面或后面显示的图像。字段右边的按钮允许您浏览以搜索图像或者导入图像。
选择此项以便为组件提供加阴影的三维外观。如果 noshade 设置为 true,则组件将以纯色呈示。如果将此属性留空,则所使用的浏览器将按其缺省方式来显示标记。
要显示在面板上的选项卡数。将组件中可视的选项卡数目限制为输入到字段中的数目。可以通过使用插入的滚动控件来访问其他选项卡。
如果您选择定制类型号字段则它将变成活动的。确定应如何对字符串进行语法分析的定制格式化模式。
要添加一列其他播放器属性/参数,列表应为以逗号分隔的名值对的列表。
指定包含用于下载的播放器代码的 URL。如果尚未安装播放器,则将显示此属性。
指定包含播放器代码的 Java™ 归档(JAR)文件的位置以进行下载。如果尚未安装播放器,则将显示此属性。
用来指定要在编码开始时调用的方法。scriptCollector 的开始阶段,即,正好在呈示组件之前调用该方法。
用来指定要在编码结束时调用的方法。scriptCollector 的结束阶段,即,呈示组件之后立即调用该方法。
下划线字符(_)是此属性的缺省字符值。PromptChar 属性只能设置为一个字符。
如果在运行时设置为 true,则在提交包含密码字段的表单之后,密码星号将重新显示在相同的指定密码字段中。
限制可以输入至组件中的字符的类型,例如,仅数字或仅 ASCII 字母。将具有 regex 属性的 hx:validateConstraint 添加至“全部属性”视图。
从当前文档至此超链接指定的锚点的关系。此属性的值是以空格分隔的链接类型列表。
从此超链接指定的锚点至当前文档的反向链接。此属性的值是以空格分隔的链接类型列表。
在显示行时循环出现的一组类。这可以手工定义,也可以通过单击按钮并从窗口中选择期望的类来定义。
对分隔符指定已定义的 CSS 样式表样式,例如,实线或空格。必须先将 CSS 样式表文件链接到组件的 JSP 中,然后才能使用。
选择此框将插入一对按钮,这对按钮可以用来在组件中的各个选项卡之间循环。
一次仅显示这么多选项卡并显示用来查看未显示的选项卡的滑块按钮。
指定演示内容中所有未播放的剪辑是否应以随机顺序回放。此参数可用于只包含一系列剪辑的多剪辑 RAM 文件(.ram 或 .rpm)或 SMIL 文件。
控件的宽度(以字符计)。可以通过 CSS 更精确地指定宽度。
指定组件的初始宽度。除文本输入组件外,宽度以像素数给出。对于文本输入组件,这个值表示字符数。
选项卡左边或右边的压印线的宽度。可以设置活动和不活动选项卡的宽度。
指定是否维持要播放的视频的最初宽高比。缺省值为 false。
指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。
当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。
通过其中一个预定义的操作或 JavaScript 函数指定操作,当客户端验证结果成功时将调用此操作。
控制所有 Shockmachine 功能并具有单独的子参数。有关详细信息,请参阅 Macromedia Director Support Center 中的 Shockmachine 参数。
指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的某个数。
通常,行为适用于父标记。目标可用于将行为指定给其他标记。注意,此值可识别 HTML(非 JSF)标记。可以提供 #body 以将行为应用于整个页面。
根据标记标识来指定操作目标。当未指定目标但设置了操作时,缺省目标为事件源对象。
应用于文本字段的 CSS 类。这样使得当在 CSS 中使用 ELEMENT.className 表示法时能区别 input type=submit 和 input type=text。
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。
指定组件应该使用数据库中的一项
指定要与组件配合使用的图像映射。该图像映射是由 MAP 元素定义的。usemap 的值必须与相关联 MAP 元素 name 属性的值相匹配。
接受 FacesContext、UIComponent 和 Object 参数的方法(由 MethodBinding 表达式表示)。在验证过程中将调用它以确保组件值正确。
指定链接所连接至的文档。此值可以是包含文档文件名的字符串,也可以是文档的二进制数据。指定二进制数据是结合设置 MIME 类型属性来完成的。此值可以是字符串(用基本 64 位编码)、byte[] 或 java.io.InputStream 对象。指定二进制数据时,绑定表达式的值必须能够在浏览器发送回至服务器以获取文档的后续请求中进行自行计算。
指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。
指定组件要使用的文件。此值可以是字符串(文件内容将是基本 64 位编码的)、byte[] 或对象。
指定组件链接至的页面。当在页面上创建了链接时,可以手工指定该页面;也可以通过单击按钮并从窗口中选择页面来完成。
指定音量,范围从 –10,000 至 0(以百分之一分贝为单位)。缺省值是 –600。
与组件相关联的备用 CSS 类名。使用这些类名的情况可根据名称来确定。
指定组件的宽度(以像素计或以百分比计)。要指定要使用百分比,请在值后面追加 %。
当鼠标指针在组件上时,如果单击鼠标按键,则将调用 JavaScript 事件处理程序。在各个 mousedown 和 mouseup 事件后触发。如果移动了鼠标指针,例如,在指针处于组件外部时松开按键,则将不会触发。
当鼠标指针在组件上时,如果双击鼠标按键,则将调用 JavaScript 事件处理程序。在各个 mousedown 和 mouseup 事件后触发。在这种情况下,不会触发 click 事件。
由于按下键盘键而形成字符时将调用 JavaScript 事件处理程序。按下“功能”键或“控制”键时是否触发事件取决于浏览器。
当鼠标指针在组件上时,如果按下鼠标按键,则将调用 JavaScript 事件处理程序。
当鼠标指针在组件上时,如果移动鼠标指针,则将调用 JavaScript 事件处理程序。虽然每次指针至少移动一个像素时该事件应该触发,但是各种浏览器在有关构成移动的间隔方面有所不同。
当鼠标指针在组件外部(远离组件)时,将调用 JavaScript 事件处理程序。在此事件之前应该已触发 mouseover 事件。
当鼠标指针初始移到组件上面时,将调用 JavaScript 事件处理程序。
当鼠标指针在组件上时,如果释放鼠标按键,则将调用 JavaScript 事件处理程序。
将 JWL 操作和/或 JavaScript 指定给 DOM 事件处理程序。
当组件或组件的内容具有焦点时,将 JWL 操作和/或 JavaScript 指定给按下功能/控制键这一操作。
在组件或组件的内容上单击鼠标右键时,对这一操作指定 JWL 操作和/或 JavaScript。
如果重新取回内容的请求包括的参数可用于改变面板的内容,则将该面板标记为可执行 AJAX 操作。
如果重新取回内容的请求会提交包含表单的内容,以便使用这些表单内容来改变面板的内容,则将该面板标记为可执行 AJAX 操作。
如果重新取回内容的请求被定向至的页面不是一个包含面板的页面,例如,定向至“外部数据源”,则将该面板标记为可执行 AJAX 操作。
如果设置为 true 或省略,则当您将鼠标指针悬停在包含子菜单的顶级菜单中的菜单项上时,将显示子菜单。如果设置为 false,则必须单击包含子菜单的顶级菜单中的菜单项,才能看到子菜单。
如果设置为 true 或省略,则当您将鼠标指针悬停在包含子菜单的顶级菜单中的菜单项上时,将显示子菜单。如果设置为 false,则必须单击包含子菜单的顶级菜单中的菜单项,才能看到子菜单。
菜单项的 ID 初始显示为“已选中”,它是 CSS 定义的另一可视状态。
如果提供了初始所选项或通过 JavaScript 设置了所选项,则指定是仅将子菜单项显示为“已选中”(false 或省略),还是将从包含的父菜单向下到子菜单项的所有菜单项都显示为“已选中”。
如果为 true,则将垂直显示顶级菜单。如果为 false 或省略,则将水平绘制。
如果为 true 或省略,则将垂直显示子菜单,即顶级菜单之外的所有菜单。如果为 false,则将水平绘制。
如果为 true,则将通过“替代类”CSS 类来设置此菜单项的样式。如果为 false 或省略,则将通过“普通”CSS 类来设置此菜单项的样式。
如果为 true,则将禁用此菜单项。如果为 false 或省略,则不会禁用此菜单项。
如果为 true,则单击此菜单项将同时执行与其相关联的标记(例如,执行 requestLink)和显示与其相关联的子菜单。仅当应用于标题构面中的子标记时,即应用于包含相关联子菜单的菜单项时,此属性才有意义。缺省情况下,如果单击没有任何子菜单项的菜单项,则将执行该菜单项。同样地,如果单击任何包含相关联子菜单的菜单项,则将仅显示该子菜单。在某些情况下,通常是在构建导航结构时,单击包含相关联子菜单的菜单项需要同时执行操作(例如,获取指向不同框架的页面) 和显示该子菜单。
缺省值为 true。如果为 true,则日历的标题区域将显示在两行中,一行显示年份,一行显示月份。如果为 false,则在一行中显示标题区域。
要与此组件配合使用的定制转换器的 ID 或类名。如果定制转换器是在 TLD 中定义的,则它也可以通过将该转换器标记用作组件的子标记来指定。
这个类是 CSS 类集的基类,描述下拉弹出菜单的可视外观。注意,此名称不包括后缀,例如,它是 inputColor1,而不是 inputColor1_ColorPicker。
如果为 true,则进度条是自定时的,并且在启动后,它将自动以指定时间间隔进行更新。如果省略或为 false,则必须手工更新进度条。在进行 JavaScript 调用后,它将重新绘制进度条以指定当前状态。如果 auto 为 true,则进度条不会显示已完成百分比。如果为 false,则它会显示已完成百分比。
如果为 true,则当页面初始显示时,进度条是隐藏的。应该使用此选项取代在进度条的样式中设置“display:none”。
该消息显示在进度条的上方。在进度条正在运行时,可以通过 JavaScript 来更改消息。
如果为 true,则进度条将从中心向外绘制。如果省略或为 false,则进度条将从左到右绘制。
如果 auto 为 true(可选,缺省值为 5),则该值为每当进度条更新时进度条增加的大小,即进度条宽度的百分比。例如,如果值为 10,则意味着每增加一次,将使进度条的宽度增加总宽度的 10%。如果 auto 为 false 或者未设置(可选,缺省值为 0),则该值为进度条初始显示的大小(百分比)。例如,如果值为 15,则意味着进度条显示起始值为 15%。
如果 auto 为 false 或者未设置(可选,缺省值为 0),则该值为进度条初始显示的大小(百分比)。例如,如果值为 15,则意味着进度条显示起始值为 15%。
如果 auto 为 true,则该值为进度条的更新时间间隔(频率)。以毫秒指定,例如,值为 5000 表示进度条每隔 5 秒改变一次。
如果省略或为 true,则在可移动对话框中的某一项具有焦点时,可以通过在键盘上按下 Ctrl+Shift+箭头键来移动该对话框。如果为 false,则不能通过键盘来移动可移动对话框。
如果为 true,则当装入页面时,将显示对话框,调用 onshow 处理程序,禁用主窗口。如果为 false,则开始时不显示该对话框。
如果提供了 ID,则将显示对话框,开始时焦点将设置在此字段中,必要时选择字段的内容。如果省略或为 false,则将显示对话框,焦点将设置在对话框中第一个可以获得焦点的字段中。
如果提供了 ID,并且 align 或 valign 已设置为“相对对齐”,则将根据所标识的标记进行对齐。
如果为 true,则当对话框显示时,将对对话框中所有“表单”字段内的值进行备份,例如,保存输入和文本区域的值。为对话框编写的事件处理程序可以按程序方式获得已保存的值,而且在单击“取消”后,将使用这些值来恢复值的状态。如果为 false,则不保存值,而且在单击“取消”后,不会将值恢复为它们在对话框首次显示时的状态。
如果为 true 或省略,则将在对话框顶部显示标题栏。如果为 false,则不会显示标题栏。
要用作“关闭”按钮的图像的 URL。(也可以通过 CSS 指定。)
显示对话框时要运行的 JavaScript 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发显示的事件。
不显示对话框时要运行的 JavaScript 函数。此函数的特征符是 function(thisObj, thisEvent),其中 thisObj 指向对话框,而 thisEvent 是触发隐藏的事件。如果因为单击对话框中的“确定”或“取消”按钮(或等效于“取消”按钮的“关闭”按钮)而隐藏了对话框,则 thisEvent.dialogAction 的值将根据被单击的按钮而为 确定或取消。
如果设置为 false,则该部分初始呈示为“展开”。如果设置为 true 或省略,则它呈示为“折叠”。
定义是以内联方式作为一个可导致表展开/收缩的表单元格,还是作为一个根据表单项内容进行绝对定位的 div 来显示与面板包含的所有 formItems 相关联的帮助和/或错误文本。弹出菜单的相对位置(左、右、下和上)由 labelPosition 定义。弹出菜单以大于基本值的 z 顺序来显示,并定位在内容之上。
如果提供,则指定显示标签的列的宽度(以像素或百分比计)。注意,列宽也可以使用 panelFormBox_Label-Cell 类来设置。
当 formItem 中字段的值无效时将显示的文本。如果省略,则当字段无效时,将使用“系统提供的”错误文本。提交包含该 formItem 的表单时,将在服务器上验证字段。如果任何字段的值无效,则将再次显示该页面,并显示该 formItem 的 errorText,它取决于 showHelp 属性。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示服务器上为此字段生成的消息(h:message)。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。此外,字段可以启用客户端验证,如果字段为必需,则客户端验证始终是启用的。当字段失去焦点(onblur 触发)时,将运行客户端验证。如果字段验证失败,则将显示错误。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示来自 hxclient 字符串资源文件的适当消息。如果提供了 errorText,则当字段无效时,将显示一致的错误消息,而与错误的标记方式或标记位置无关。不管错误是由客户端验证标记还是由服务器端验证标记,都将在同一位置显示同一错误。
要与此项一起显示的其他参考或帮助文本。例如,它可以提供有关用户应输入的内容的详细信息,也可以描述字段的计量单位。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。对于 errorText 和标签,HTML 可以嵌入在字符串中。
面板中 formItem 的内容根据面板的 labelPosition 和 helpPosition 属性在表列中进行对齐。例如,所有标签放在一列中,而所有内容放在邻近的列中。设置 releaseMargin 会将此项从该规则中“释放”。设置 releaseMargin 后,此 formItem 的内容将合并在子表中,该子表已插入在面板的表中。因此,子表的内容是单独对齐的。如果一项的标签(或内容)明显宽于或窄于其他项的标签(或内容),则往往使用 releaseMargin。通过“释放”此项,此项的元素可以单独对齐,而不会强制面板中的所有其他项变得“太宽”。注意,仅当标签和/或消息显示在字段的左边/右边时,releaseMargin 才有意义。如果标签和/或消息显示在字段的上方/下方,则 releaseMargin 基本不起什么作用。
确定对此项显示 infoText 和 errorText 的方式(时间)。如果为“始终”,则信息文本将始终显示,除非发生错误,在发生错误的情况下,错误将显示在信息文本所在的位置。如果为“根据需要”,则当此字段具有焦点时将显示信息文本,除非发生错误。如果发生错误,则将始终显示该错误。如果为“信息”,则将始终显示信息文本。从不显示错误文本。如果为“错误”,则从不显示信息文本。如果发生错误,则显示错误文本。如果为“无”,则不管是信息文本还是错误文本,都从不显示。
要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。
行为所连接至的事件的名称。例如,“onclick”。它必须包括“on”前缀。
要执行的 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理。
要运行的操作的目标。缺省情况下,操作的目标是对其指定(作为子代或通过目标)行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。
通常,行为适用于父标记。targetFacet 可用于将行为指定给已命名构面的内容。
如果 autoTab 为 true,而且 autoSubmit 为 true,则当用户在当前字段中输入足够字符数时,就可以自动进入下一字段,而不用手工进入下一字段,此时,将提交包含当前字段的表单。此属性主要供尝试仿真某些“老式”输入机制(例如,仿真 3270 终端)的应用程序使用。
如果为 false 或省略,则当输入最大字符数时,焦点不会进入下一字段。如果为 true,则当在字段中输入最大字符数时,焦点将进入下一字段。要使 autoadvance(自动进入)正常工作,字段的模式应明确地标识字段中的最大字符数,或者对字段设置最大长度。例如,模式 ##9 就不明确。虽然可以为一个正数输入三个字符,但如果是负数,则应输入四个字符。因此,在这种情况下,应该设置最大长度。
如果验证已设置为 true,则该值表示 onblur 被触发、字段值验证失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。
如果提供,则当字段获得焦点时,CSS imeMode 属性将设置为提供的值。此属性仅适用于支持 CSS imeMode 属性的浏览器,当前,仅 Internet Explorer 支持此属性。
当前不可用。如果启用了 inputAssist,则它将打开字符检查以验证输入的字符是否有效。
如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。
如果提供,则当 onfocus 触发且字段值转换失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。
如果提供,则当 onfocus 触发且字段值通过转换时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。
如果验证已设置为 true,则该值表示 onfocus 被触发、字段值转换失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。
如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。
如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要应用于此字段的 CSS 类的名称。
如果提供,则当 onblur 触发且字段值通过验证时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。
如果提供,则字段将被置入辅助方式,在这种情况下,字段中的每个字符位置都将显示带有字段的指定提示字符或当前值。对于日期/时间字段,可以使用所有数字字符来表示日期。只能在每个位置中输入有效字符。在用户输入时,光标会自动前进到相应的位置。
如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。
如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要应用于此字段的 CSS 类的名称。
该目标与 errorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。
该目标与 onFocusErrorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。
该目标与 onFocusSucessAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。
该目标与 successAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。
如果为 true,则获得焦点的字段的内容在开始时已选中。如果省略或为 false,则开始时获得焦点的字段的内容未选中。
如果为 true,则建议下拉菜单与输入字段一样宽。如果为 false,则其宽度由下拉菜单的 CSS 来确定。
提出建议之前的延迟时间(以毫秒计),即,如果用户在 startDelay 毫秒内输入第二个字符,则不会对第一个字符提出建议。
如果请求成功,则替换面板的内容后,将执行此 JavaScript 函数。此函数没有任何有意义的参数。
当行为开始执行时,将执行此 JavaScript 函数。此函数没有任何有意义的参数。如果它返回 false,则将中止执行。此函数可以与 oncomplete 配合使用来定制执行请求过程中所显示的内容。
这些标记的值将检索并作为 params 追加至用于获取新内容的 URL。param 的名称将是提供的简单 ID。例如,如果 ID 是“text1”,则 param 将命名为“text1”而不是“form1:text1”。
对请求作出响应的 JSP 的 URL。对此组件发出 JWL Get 操作时,将使用指定 URL 检索与该组件相关联的面板的新内容。
目标 URL 中标记的 ID,该标记的内容将替换此组件所关联的容器的内容。如果未指定 ID,或者在 URL 所引用的页面中找不到该 ID,则将使用容器的 ID。如果在 URL 所引用的页面中找不到此 ID,则将使用主体内容。
预定义的格式化样式,它确定如何格式化日期字符串的日期组件并对其进行语法分析。仅当类型为“日期”或“日期和时间”时适用。
预定义的格式化样式,它确定如何格式化日期字符串的时间组件并对其进行语法分析。仅当类型为“时间”或“日期和时间”时适用。
时区,用来解释日期字符串中的任何时间信息。值必须是根据 java.util.TimeZone 实例来计算的 VB 表达式,或者是作为时区 ID 的字符串,如 java.util.TimeZone.getTimeZone() 的 javadocs 中所述。
该正则表达式描述在掩码模式中标有 # 字符的位置处所允许的字符。如果省略,则将使用表达式 [0-9],允许使用数字 0 至 9。
该正则表达式描述在掩码模式中标有 ? 字符的位置处所允许的字符。如果省略,则将使用表达式 [a-zA-Z],允许使用 ASCII 字母字符。
该正则表达式描述在掩码模式中标有 ! 字符的位置处所允许的字符。如果省略,则将 ! 字符视为模式中的文字。
该正则表达式描述在掩码模式中标有 ~ 字符的位置处所允许的字符。如果省略,则将 ~ 字符视为模式中的文字。
保护“标记”位置中的字符免遭更改(或验证),例如,您可以“保护”字符串中包含标记(#、?、! 和 ~)的位置以便用户不能输入此字符,取而代之的是按程序方式来设置该位置的值,该值通常在初始值中。这可以有效地将值中的字符转换为文字。仅当此掩码在 inputText 字段中使用并且该字段启用了输入辅助时,此属性才有用。如果提供了 protectMask,则它与掩码应该是长度相同的字符串。如果位置中有 X(大写 X),则此位置已标记为“受保护”。不保护没有 X 的位置。
标志,指定格式化的输出是否包含分组分隔符。缺省值为 true。
最大日期,指定方式为 yyyy/mm/dd hh:mm:ss。
最小日期,指定方式为 yyyy/mm/dd hh:mm:ss。
表达式语言(EL)表达式,返回布尔值,其中 true 表示值有效,而 false 表示值无效。
指定要使用的 IBM® 模数算法 - 模数 10 公式或模数 11 公式。缺省情况下,使用模数 10 公式。
<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 标记设置初始值,即未选择任何选项。这是因为无法找到与该无效值相匹配的选项。
即使在列表框或单选按钮组中选择了内容,但由于假定您正尝试强制用户选择值,所以浏览器不会显示任何所选内容。提交页面时,如果所作选择无效,则不会提交值,即,不提交任何所选内容。如果字段标记为“必填”,则将生成错误。
如果是组合框,则即使操作相同,浏览器行为也不尽相同。如果组合框所选项无效,则浏览器将使第一个值成为所选项。因此,提交页面时,将始终提交一个有效的值。