在使用可视设计器编辑的某个页面上选择下拉列表组件
时(在将该组件添加到页面上后),将显示该组件的“属性”窗口。
此组件具有以下属性。
类型:字符串id 属性的值。在页面 Bean 中,该属性的值是 DropDown 对象的名称。类型:布尔型navigateToValue 属性通过导航至其他页面来响应用户选择,请选择此属性。 类型:字符串label 属性不像标签组件那样灵活。如果要对标签的外观进行更多控制(如相对于组件定位标签),则可以使用标签组件。类型:整型label 属性时,此属性才会生效。 类型:布尔型类型:布尔型com.sun.rave.web.ui.model.OptionGroup 类的子类。缺省情况下,将选定此属性。 类型:字符串 position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
类型:字符串style 属性描述。 此组件的缺省主题 CSS 样式类为:
css_master.css
.MnuJmpOptGrp, .MnuStdOptGrp
{color:#000}
.MnuStdOpt, .MnuStdOptSel, .MnuStd
{color:#333}
.MnuJmpOptSep, .MnuJmpOptDis, .MnuStdOptSep,
.MnuStdOptDis, .MnuJmpDis, .MnuStdDis
{color:#848687}
.MnuJmp
{color:#035899;
border-bottom-color:#666;
border-right-color:#666}
.MnuJmpDis, .MnuStdDis
{background-color:#E1E4E5;color:#848687}
.MnuJmpOpt, .MnuJmpOpt:hover
{color:#035899}
.MnuJmpOpt:hover
{text-decoration:underline}
.MnuStd
{border-bottom-color:#666;
border-right-color:#666}
类型:转换器selected 属性生成正确类型的值的 JavaServer Faces 转换器。类型:对象com.sun.rave.web.ui.model.Option 的所有子类)。类型:布尔型for 属性链接到此组件,则当用户尝试在不选择项的情况下提交页面时,屏幕将显示一条错误消息。
类型:对象null。
类型:方法绑定(null),则不会调用任何验证器。如果选择验证器,应同时选择 required 属性,以确保使用该验证器。
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
validator 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。如果定义验证器,应同时选择 required 属性,以确保使用该验证器。
validator 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validator 属性的值,否则会断开 validate 方法连接。component-id_processValueChange,其中 component-id 是组件的 id 属性的值。
类型:布尔型readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。类型:布尔型disabled 属性,JavaServer Faces 根本检测不到提交的任何值。类型:字符串类型:布尔型rendered 属性。类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:布尔型类型:布尔型visible 属性,而不是此属性。
可以将此属性绑定到确定何时呈现该组件的 JavaBeans 属性中。例如,机票预订表单可能只为经常乘坐飞机的人显示组件,而不为一般大众显示它。要绑定此属性,请单击属性右侧的省略号按钮 (...),然后在对话框中选择“使用绑定”。
类型:方法绑定valueChange 属性,它可提供更简便的方法来设置此属性的值。valueChangeListener 属性是作为 valueChange 事件属性基础的 MethodBinding 属性。为 valueChange 事件属性设置该方法时,将会更新 valueChangeListener 属性。
在单击 valueChange 属性旁边的省略号按钮时,可以使用该属性的属性编辑器来选择要绑定的现有方法,也可以创建新方法或取消绑定现有方法。如果您是这方面的专家,则可以在此 valueChangeListener 属性中直接键入 MethodBinding 表达式,而不是使用 valueChange 属性(例如,如果要调用不在页面 Bean 中的方法)。