选择 - 颜色

显示“组合框”以允许您选择颜色。可供用户选择的颜色列表(选用板)像组合框中的选项一样可以配置。

属性视图和全部属性视图

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

“选择 - 颜色”组件的这些常见属性显示在“属性”视图中的 h:selectOneColor验证行为辅助功能选项卡上。请参阅下表以获取属性列表。

配置选项

描述

对颜色菜单中的每项添加选项

允许您指定 selectOneColor 组件中各种颜色的名称、值和顺序。可以添加单个或一组选项。

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

表 1. 选择 - 颜色属性

属性名称

描述

buttonBorder

控制如何根据输入字段来绘制按钮。缺省情况下,以一种适合于浏览器的操作系统的方式来绘制按钮,以便该按钮看起来像组合框按钮。例如,在 Windows® 2000 或 Windows 9X 中,按钮是作为边框的一部分来绘制的。在 WindowsXP 中,按钮是在输入字段右边单独绘制的。可以设置以下值:
  • -1 - 绘制按钮以匹配浏览器的操作系统。
  • +1 - 在输入字段的右边绘制按钮。

buttonColor

指定按钮的背景色。缺省情况下,背景色与输入字段的边框颜色相匹配。此属性的使用属于限制值,它当前只是一个占位符,用于将来扩展以允许提供备用按钮背景图形。

converter

要与此组件配合使用的定制转换器的 ID 或类名。如果定制转换器是在 TLD 中定义的,则它也可以通过将该转换器标记用作组件的子标记来指定。

dropdownClass

这个类是 CSS 类集的基类,描述下拉弹出菜单的可视外观。注意,此名称不包括后缀,例如,它是 inputColor1,而不是 inputColor1_ColorPicker。

onchange

如果提供,则每当执行操作时将调用此函数。

onselect

颜色更改时将调用 JavaScript™ 事件处理程序。

required

必须指定组件。选择此项以要求用户输入值。

showLabels

如果指定(true),则当前所选颜色的名称将显示在输入字段中该颜色样品的上面。如果省略(或 false),则名称不显示,并且输入字段将仅显示一种颜色样品,指示当前所选颜色。
注: 确保颜色拾取器的宽度设置为足够大的值,可以容纳最大的名称,否则颜色拾取器可能无法正常显示。

size

控件的宽度(以字符计)。可以通过 CSS 更精确地指定宽度。

validator

接受 FacesContext、UIComponent 和 Object 参数的方法(由 MethodBinding 表达式表示)。在验证过程中将调用它以确保组件值正确。

value

指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。

valueChangeListener

当组件的值更改时要通知的方法。

相关任务
定义输入字段的定制模式

反馈