创建一个输入字段,用户将看不到此字段中输入的文本。输入的所有字符都将替换为星号或句点,这样做对于在登录页面上输入密码是很有用的。通常将该输入控件绑定至数据存储器,例如,数据库或 bean。当提交具有“输入”控件的页面时,会将输入字段的内容存储在指定位置(例如,数据库中的列或 bean 的属性)。
将输入 - 密码组件拖放到页面上:
输入 - 密码组件在页面上看起来为如下所示:
在运行时,输入 - 密码组件在页面上看起来为如下所示:
组件的“属性”视图显示可以对组件设置的最常见属性的集合,并且根据组件的不同,您还可以看到用于添加控件、操作或其它组件的选项。要打开“属性”视图,单击窗口 > 显示视图 > 属性;但是,缺省情况下,该视图是打开的。
“输入 - 密码”组件的这些常见属性显示在“属性”视图中的 h:inputSecret、验证、行为和辅助功能选项卡上。要获取完整的属性列表,请参阅全部输入 - 密码属性表。用于验证输入和更改行为的其它配置选项位于 h:inputSecret> 验证和 h:inputSecret> 行为选项卡上:
配置选项 |
描述 |
---|---|
自动前进到下一个字段 |
指定是否启用自动跳进。在输入了指定的字符数之后自动进入另一个输入字段。选择了此框之后,会将 hx:inputHelperAssist 部分添加至“全部属性”视图并将 autoTab 设置为 True。 |
单击以创建/编辑定制验证代码 |
切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。 |
约束 |
限制可以输入组件中的字符类型(例如 -“仅数字”和“仅 ASCII 字母”等等)将具有 regex 属性的 hx:validateConstraint 添加至“全部属性”视图。 |
在错误消息控件中显示验证错误消息 |
插入与所选组件相关联的错误消息控件组件。如果验证失败,它将显示错误消息。 |
最大长度 |
当在服务器上提交时此组件可以包含的最大字符数。将具有 maximum 属性的 f:validateLength 功能添加至“全部属性”视图。 |
最小长度 |
当在服务器上提交时此组件可以包含的最小字符数。将具有 minimum 属性的 f:validateLength 功能添加至“全部属性”视图。 |
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,单击“属性”视图的右上角中的全部属性图标 。
属性名称 |
在“属性”视图中表示为 |
描述 |
---|---|---|
accesskey |
辅助功能 > 访问键 |
将单个键盘键指定为访问键。在运行时按指定的访问键就可以使此组件具有焦点。 |
alt |
未表示 |
指定组件的备用文本。当不能正常呈示元素时将显示此备用文本;例如,在不支持表单的浏览器中或设置为不显示图像的浏览器中。 |
binding |
未表示 |
表示此组件的 UIComponent,通常在备份文件中。 |
converter |
未表示 |
指定要将值转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。 |
dir |
未表示 |
指定当在运行时呈示时组件的方向。值可以是:
|
disabled |
行为 > 控件被禁用 |
如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果保留为空白,则缺省值为 false。 |
id |
标识 |
对组件指定一个名称。它应该是 JSP 内的唯一名称。 |
immediate |
未表示 |
如果为 true,则直接跳至生命周期的呈示阶段。 |
lang |
未表示 |
指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。 |
maxlength |
行为 > 在用户输入 X 个字符后 |
在最终用户将这么多个字符输入到组件之后制定控制属性。 |
readonly |
行为 > 控件是只读的 |
指定组件的初始值不可更改。 |
rendered |
未表示 |
可设置为 true 或 false:
|
required |
验证 > 值是必需的 |
必须指定组件。选择此项以要求用户输入值。 |
size |
大小:宽度 |
指定组件的初始宽度,其值指的是字符数。 |
style |
样式:属性 |
指定组件的 CSS 样式信息(例如,style="font-size : 8pt ; color : red")。定义所选组件的属性(例如,字体和颜色)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。 |
styleClass |
样式:类 |
当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须在生成的标记上作为“class”属性传递。定义所选组件的类(例如,样式表)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。 |
tabindex |
辅助功能 > 跳进顺序索引 |
指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的数。 |
title |
辅助功能 > 标题 |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。 |
validator |
未表示 |
要实例化的验证器的类名。 |
value |
值 |
指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。 |
valueChangeListener |
未表示 |
当组件的值更改时要通知的方法。 |