JSF 1.1 口令字段组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择口令字段组件 时,将显示该组件的“属性”窗口。
此组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中的口令字段组件的名称。
外观
columns。 类型:字符串
字段的字符宽度。缺省值为 20。
label。 类型:字符串
在字段旁边显示的字段描述性标签。
label 属性不像标签组件 那样灵活。如果要对标签的外观进行更多控制(如相对于组件定位标签),则可以使用标签组件。
labelLevel。 类型:整型
影响标签外观的数值。1(强),较大并以粗体显示。2(中),为缺省值,较小并以粗体显示。3(弱),较小并正常显示(非粗体)。仅当设置了标签属性时,该属性才会生效。
password。 类型:对象
用户输入的口令,该口令将被发送到服务器。可以单击省略号按钮 (...) 并将此属性绑定到接收该值的对象或数据提供器。如果输入此属性的文本值,则最初显示口令字段时,将使用星号或圆点来表示每个字母。
style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串 呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
数据
converter。 类型:转换器
为 password 属性生成正确类型的值的 JavaServer Faces 转换器。组件将为 password 属性选择正确的转换器(如果可用),从而不必在大多数情况下都设置此属性。如果与 password 属性绑定的值的类型未列在转换器列表中,则必须提供您自己的转换器,并设置此属性。
required。 类型:布尔型
如果选定,则用户必须在字段中输入一个值,然后才能提交页面。如果将消息组件 添加到页面并将其 for 属性链接到此组件,则当用户尝试在不输入口令的情况下提交页面时,屏幕将显示一条错误消息。
validator。 类型:方法绑定
指示提交值时将调用 JavaServer Faces 验证器。可以从下拉列表中选择一个验证器。如果选择 (null),则不会调用任何验证器。
如果您定义了自己的 validate 方法,例如,通过右键单击该组件,然后选择“编辑事件处理程序”> "validate",则您在此属性中可能设置的任何值都将被覆盖。
事件
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称> "。
validate。 表示为验证组件值而调用的方法的名称。如果要编写 validate 方法代码,而不是为 validator 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id _validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。
设置此属性时,还将设置 validator 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validator 属性的值,否则可能会断开 validate 方法连接。
valueChangeListener 表示在更改组件值时调用的组件值更改侦听程序方法的名称。要在页面 Bean 中定义此方法,通常可以在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "processValueChange"。该方法的缺省名称为 component-id _processValueChange,其中 component-id 是组件的 id 属性的值。
行为
disabled。 类型:布尔型
如果选定,则表示该组件应从不接收焦点或包含在提交中。当该组件不适用于页面时,可以使用此属性。请参见 readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。
maxLength。 类型:整型
可在此字段中输入的最多字符数。
readOnly。 类型:布尔型
如果选定,则用户无法输入值。当该组件适用但不可更改时,可以使用此属性。
toolTip。 类型:字符串
呈现为组件的 HTML title 属性,可以由屏幕阅读器读取并显示为工具提示。
如果禁用该组件,则在大多数浏览器中将不显示工具提示。
trim。 类型:布尔型
如果选定,在转换为目标数据类型之前,将去掉任何前导空格或结尾空格。缺省情况下,将选定此属性。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在提交表单时仍然可以处理组件,而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
辅助功能
tabIndex。 类型:字符串
(可选)按文档的 Tab 键顺序指定组件的位置,从而确定当用户使用 Tab 键在文档中移动时组件成为焦点的时间。该值必须为 0 至 32767 之间的整数。相当于 HTML <input> 标记的 tabindex 属性。
JavaScript
onBlur。 类型:字符串
组件失去焦点时执行的 JavaScript。
onChange。 类型:字符串
组件失去焦点以及获得焦点后其值被修改时执行的 JavaScript。
onClick。 类型:字符串
用户单击组件时执行的 JavaScript。
onDblClick。 类型:字符串
用户双击组件时执行的 JavaScript。
onFocus。 类型:字符串
组件获得焦点时执行的 JavaScript。
onKeyDown。 类型:字符串
组件具有焦点并按下某个键时执行的 JavaScript。
onKeyPress。 类型:字符串
组件具有焦点并按下及释放某个键时执行的 JavaScript。
onKeyUp。 类型:字符串
组件具有焦点并释放某个键时执行的 JavaScript。
onMouseDown。 类型:字符串
在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
onMouseMove。 类型:字符串
用户在组件中移动鼠标光标时执行的 JavaScript。
onMouseOut。 类型:字符串
在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
onMouseOver。 类型:字符串
用户将鼠标光标移动到组件上方时执行的 JavaScript。
onMouseUp。 类型:字符串
鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
onSelect。 类型:字符串
用户选择组件中的文本时执行的 JavaScript。
高级
immediate。 类型:布尔型
如果选定此属性,当用户提交页面时,将先执行页面 Bean 中的代码,然后再执行验证、更新模型值等操作。实际上,代码在服务器中立即执行,然后返回该页面。获取此功能的一种更简单的方法是,将组件与虚拟表单 关联起来。
immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可能会执行其他操作,例如,应用程序可能会记录用户取消当前操作的情况。
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理组件。如果未选定该属性,则组件将不出现在页面中,甚至不作为隐藏组件出现。可以将此属性绑定到确定何时呈现该组件的 JavaBeans 属性中。要绑定此属性,请单击属性右侧的省略号按钮 (...),然后在对话框中选择“使用绑定”。
valueChangeListener。 类型:方法绑定
请参见上述“事件”类别的 valueChange 属性,它可提供更简便的方法来设置此属性的值。valueChangeListener 属性是作为 valueChange 事件属性基础的 MethodBinding 属性。为 valueChange 事件属性设置该方法时,将会更新 valueChangeListener 属性。
在单击 valueChange 属性旁边的省略号按钮时,可以使用该属性的属性编辑器来选择要绑定的现有方法,也可以创建新方法或取消绑定现有方法。如果您是这方面的专家,则可以在此 valueChangeListener 属性中直接键入 MethodBinding 表达式,而不是使用 valueChange 属性(例如,如果要调用不在页面 Bean 中的方法)。
另请参见
口令字段组件
使用组件
组件任务:快速参考
法律声明