组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击
。“表单项”组件的这些常见属性显示在“属性”视图中的 hx:FormItem、辅助功能和样式选项卡上。要获取属性列表,请参阅表单项属性表。
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 。
属性名称 |
描述 |
---|---|
accesskey |
将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。 |
binding |
该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。 |
errorText |
当 formItem 中字段的值无效时将显示的文本。如果省略,则当字段无效时,将使用“系统提供的”错误文本。提交包含该 formItem 的表单时,将在服务器上验证字段。如果任何字段的值无效,则将再次显示该页面,并显示该 formItem 的 errorText,它取决于 showHelp 属性。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示服务器上为此字段生成的消息(h:message)。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。此外,字段可以启用客户端验证,如果字段为必需,则客户端验证始终是启用的。当字段失去焦点(onblur 触发)时,将运行客户端验证。如果字段验证失败,则将显示错误。如果提供了 errorText,则将显示提供的文本。如果未提供 errorText,则将显示来自 hxclient 字符串资源文件的适当消息。如果提供了 errorText,则当字段无效时,将显示一致的错误消息,而与错误的标记方式或标记位置无关。不管错误是由客户端验证标记还是由服务器端验证标记,都将在同一位置显示同一错误。 |
escape |
指定是对 HTML 格式进行转义(False)还是将 HTML 标记呈示为 HTML(True)。 |
id |
对组件指定一个名称。它在 JSP 内应该是唯一名称。 |
infoText |
要与此项一起显示的其他参考或帮助文本。例如,它可以提供有关用户应输入的内容的详细信息,也可以描述字段的计量单位。显示文本的控件在 panelFormBox 上指定。控件是否显示文本是由如下所述的 showHelp 属性控制的。对于 errorText 和标签,HTML 可以嵌入在字符串中。 |
label |
指定显示的文本。 |
releaseMargin |
面板中 formItem 的内容根据面板的 labelPosition 和 helpPosition 属性在表列中进行对齐。例如,所有标签放在一列中,而所有内容放在邻近的列中。设置 releaseMargin 会将此项从该规则中“释放”。设置 releaseMargin 后,此 formItem 的内容将合并在子表中,该子表已插入在面板的表中。因此,子表的内容是单独对齐的。如果一项的标签(或内容)明显宽于或窄于其他项的标签(或内容),则往往使用 releaseMargin。通过“释放”此项,此项的元素可以单独对齐,而不会强制面板中的所有其他项变得“太宽”。注意,仅当标签和/或消息显示在字段的左边/右边时,releaseMargin 才有意义。如果标签和/或消息显示在字段的上方/下方,则 releaseMargin 基本不起什么作用。 |
rendered |
可设置为 true 或 false:
|
showHelp |
确定对此项显示 infoText 和 errorText 的方式(时间)。如果为“始终”,则信息文本将始终显示,除非发生错误,在发生错误的情况下,错误将显示在信息文本所在的位置。如果为“根据需要”,则当此字段具有焦点时将显示信息文本,除非发生错误。如果发生错误,则将始终显示该错误。如果为“信息”,则将始终显示信息文本。从不显示错误文本。如果为“错误”,则从不显示信息文本。如果发生错误,则显示错误文本。如果为“无”,则不管是信息文本还是错误文本,都从不显示。 |
样式 |
指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。 |
styleClass |
当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。 |
title |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。 |