面板 - 表单框

panelFormBox 将子输入标记组织成面板(组框),在此面板中,每个子项都由标签以及相关的字段组成。这些字段可以有相关联的错误消息和参考消息,并且,这些消息的显示由系统自动管理。整个面板可以包含页眉和页脚以及与子项相关联的错误的摘要。

属性视图和全部属性视图

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

“表单框”组件的这些常用属性显示在“属性”视图中的 hx:panelFormBox选项卡上。要获取属性列表,请参阅“面板 - 表单框”属性表。面板项的其他配置选项显示在 hx:panelForm Box> 项选项卡上:

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

表 1. 面板 - 表单框属性

属性名称

描述

binding

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

escape

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

helpPosition

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

id

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

interItemSpacing

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

label

指定显示的文本。

labelPosition

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

rendered

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

showInPopup

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

样式

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

styleClass

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

title

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

widthContent

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

widthHelp

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

widthLabel

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


反馈