JSF 1.2 菜单组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择菜单组件
时,将显示该组件的“属性”窗口。该组件的大多数属性既是 JSP 属性,又是页面 Bean 中 Menu Java 组件的属性。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
- id。
类型:字符串
页面 Bean 和 JSP 文件中的菜单组件的名称。
外观
- style。
类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
- 此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
- styleClass。
类型:字符串
呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器。
- 有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的
style 属性描述。
- 如果将当前主题中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
数据
- items。
类型:字符串
指定 Web 应用程序用户可以选择的项。该值必须为数组、映射或集合之一,其成员为 com.sun.webui.jsf.model.Option 的所有子类。
行为
- immediate。
类型:布尔型
immediate 标志。
- submitForm。
类型:布尔型
如果将 submitForm 属性设置为 true,在用户更改菜单中的选择内容时,将会立即提交表单。
- visible。
类型:布尔型
使用 visible 属性可指示用户在呈现的 HTML 页中能否看见组件。如果设置为 false,则页面上将包含组件的 HTML 代码,但会使用样式属性将组件隐藏起来。缺省情况下,将 visible 设置为 true,因此页面上既包含组件 HTML,又可向用户显示组件。如果组件不可见,由于包含 HTML,因此仍然可以在后续表单提交期间对其进行处理。
JavaScript
- onChange。
类型:字符串
更改此组件的元素值时执行的脚本代码。
- onClick。
类型:字符串
用鼠标单击此组件时执行的脚本代码。菜单元素具有一个名为 getSelectedOption 的函数,onClick 函数处理程序可以调用该函数以了解所选的选项。这将返回单击的选项名称。
- onDblClick。
类型:字符串
用鼠标双击此组件时执行的脚本代码。
- onKeyDown。
类型:字符串
当组件具有焦点且用户按下某个键时执行的脚本代码。
- onKeyPress。
类型:字符串
当组件具有焦点且用户按下并释放某个键时执行的脚本代码。
- onKeyUp。
类型:字符串
当组件具有焦点且用户释放某个键时执行的脚本代码。
- onMouseDown。
类型:字符串
当鼠标指针位于组件上且用户按下鼠标按钮时执行的脚本代码。
- onMouseMove。
类型:字符串
当用户将鼠标指针移动到组件上时执行的脚本代码。
- onMouseOut。
类型:字符串
将鼠标指针从此组件上移开时执行的脚本代码。
- onMouseOver。
类型:字符串
当用户将鼠标指针移入此组件的边界内时执行的脚本代码。
- onMouseUp。
类型:字符串
当鼠标指针位于组件上且用户释放鼠标按钮时执行的脚本代码。
高级
- phaseId。
类型:字符串
应在其中广播事件的 PhaseId。缺省值为 PhaseId.INVOKE_APPLICATION 或 PhaseId.ANY(如果 Immediate 返回 true)。 - rendered。
类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理组件。如果未选定该属性,则组件将不出现在页面中,甚至不作为隐藏组件出现。如果需要隐藏组件但在提交页面时仍然可以对其进行处理,请取消选择 visible 属性,而不是此属性。
事件
- 另请参见
- 菜单组件
- 菜单组件属性窗口
- 使用组件
- 组件任务:快速参考
法律声明