输入

允许您为下列类型的数据创建输入字段:字符串、数字、日期/时间和掩码。当将输入组件添加至页面时,选择输入组件“属性”视图上的其中一种格式。

设计时的组件

输入组件拖放到页面上:
“输入”组件按钮

设计时页面上的输入组件:
设计时的“输入”

运行时的组件

运行时页面上的输入组件:
运行时的“输入”

“属性”视图和“全部属性”视图

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

“输入”组件的这些常见属性显示在“属性”视图中的 h:inputText验证行为辅助功能选项卡上。要获取完整的属性列表,请参阅全部输入属性表。用于验证输入、修改行为和配置输入格式类型的其它配置选项位于 h:inputText> 验证h:inputText> 行为h:inputText 选项卡上:

表 1. “输入”配置选项

配置选项

描述

自动前进到下一个字段

指定是否启用自动跳进。在输入了指定的字符数之后自动进入另一个输入字段。选择了此框之后,会将 hx:inputHelperAssist 部分添加至“全部属性”视图并将 autoTab 设置为 True。

单击以创建/编辑定制验证代码

切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。

约束

限制可以输入组件中的字符类型(例如 -“仅数字”和“仅 ASCII 字母”等等)将具有 regex 属性的 hx:validateConstraint 添加至“全部属性”视图。

在错误消息控件中显示验证错误消息

插入与所选组件相关联的错误消息控件组件。如果验证失败,它将显示错误消息。

格式

指定组件要处理的数据的格式:
  • 字符串 - 指定输出应该采用文本字符串的格式。
  • 数字 - 指定输出应采用数字格式。
  • 日期/时间 - 指定输出应该采用日期和/或时间的格式。
  • 掩码 - 指定以有选择性地包含或排除某些值的方式来对输出进行过滤。
有关详细信息,参阅单独的格式类型表。

最大长度

当在服务器上提交时此组件可以包含的最大字符数。将具有 maximum 属性的 f:validateLength 功能添加至“全部属性”视图。

最小长度

当在服务器上提交时此组件可以包含的最小字符数。将具有 minimum 属性的 f:validateLength 功能添加至“全部属性”视图。

在浏览器中验证字段值

允许运行时在浏览器中验证字段。

表 2. 格式类型配置选项

格式类型

格式选项

字符串

h:inputText 选项卡:
  • 标识
  • 样式:属性
  • 样式:类
  • 大小:宽度
“验证”选项卡:
  • 值是必需的
  • 最大长度
  • 最小长度
  • 约束
  • 单击以创建/编辑定制验证代码
  • 在错误消息控件中显示验证错误消息
“行为”选项卡:
  • 控件被禁用
  • 控件是只读的
  • 自动进入下一字段
  • 在用户输入 X 个字符后
  • 在浏览器中验证字段值
  • onBlur 和 onFocus 操作

数字

h:inputText 选项卡:
  • 标识
  • 样式:属性
  • 样式:类
  • 大小:宽度
  • 类型:十进制
  • 选项
  • 仅整数
  • 显示辅助控件按钮
  • 类型
  • 增量
  • 显示提示字符
  • 提示字符
  • 类型:货币
  • 选项
  • 货币符号
  • 仅整数
  • 显示辅助控件按钮
  • 类型
  • 增量
  • 显示提示字符
  • 提示字符
  • 类型:百分比
  • 选项
  • 仅整数
  • 显示辅助控件按钮
  • 类型
  • 增量
  • 显示提示字符
  • 提示字符
  • 类型:定制
  • 选项
  • 模式
  • 显示辅助控件按钮
  • 类型
  • 增量
  • 显示提示字符
  • 提示字符
“验证”选项卡:
  • 值是必需的
  • 使用简单验证
  • 最小值
  • 最大值
  • 使用高级验证
  • 高级验证表达式
  • 单击以创建/编辑验证代码
  • 在错误消息控件中显示验证错误消息
“行为”选项卡:
  • 控件被禁用
  • 控件是只读的
  • 自动进入下一字段
  • 在用户输入 X 个字符后
  • 在浏览器中验证字段
  • onblur 操作
  • onfocus 操作

日期/时间

h:inputText 选项卡:
  • 标识
  • 样式:属性
  • 样式:类
  • 大小:宽度
  • 类型:仅日期
  • 选项
  • 日期样式
  • 显示辅助控件按钮
  • 显示提示字符
  • 提示字符
  • 类型:仅时间
  • 选项
  • 时间样式
  • 显示辅助控件按钮
  • 增量
  • 显示提示字符
  • 提示字符
  • 类型:日期和时间
  • 选项
  • 日期样式
  • 时间样式
  • 显示提示字符
  • 提示字符
“验证”选项卡:
  • 值是必需的
  • 使用简单验证
  • 最小值
  • 最大值
  • 使用高级验证
  • 高级验证表达式
  • 单击以创建/编辑验证代码
  • 使用 yyyy/dd/mm 或 hh:mm:ss 或“现在”,根据适合的选项。
  • 在错误消息控件中显示验证错误消息
“行为”选项卡:
  • 控件被禁用
  • 控件是只读的
  • 自动进入下一字段
  • 在浏览器中验证字段
  • onblur 操作
  • onfocus 操作

掩码

h:inputText 选项卡:
  • 标识
  • 样式:属性
  • 样式:类
  • 大小:宽度
  • 选项
  • 掩码
  • 显示提示字符
  • 提示字符
“验证”选项卡:
  • 值是必需的
  • 最小长度
  • 最大长度
  • 单击以创建/编辑定制验证代码
  • 在错误消息控件中显示验证错误消息
“行为”选项卡:
  • 控件被禁用
  • 控件是只读的
  • 自动进入下一字段
  • 在用户输入 X 个字符后
  • 在浏览器中验证字段值
  • onblur 操作
  • onfocus 操作

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

表 3. 全部“输入”属性

属性名称

在“属性”视图中表示为

描述

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键就可以使此组件具有焦点。

alt

未表示

指定组件的备用文本。当不能正常呈示元素时将显示此备用文本;例如,在不支持表单的浏览器中或设置为不显示图像的浏览器中。

binding

未表示

表示此组件的 UIComponent,通常在备份文件中。

converter

未表示

指定要将值转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左

disabled

行为 > 控件被禁用

如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果保留为空白,则缺省值为 false。

id

标识

对组件指定一个名称。它应该是 JSP 内的唯一名称。

immediate

未表示

如果为 true,则直接跳至生命周期的呈示阶段。

lang

未表示

指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。

maxlength

行为 > 在用户输入 X 个字符后

在最终用户将这么多个字符输入到组件之后制定控制属性。

readonly

行为 > 控件是只读的

指定组件的初始值不可更改。

rendered

未表示

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈现组件。

required

验证 > 值是必需的

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

size

大小:宽度

指定组件的初始宽度,其值指的是字符数。

style

样式:属性

指定组件的 CSS 样式信息(例如,style="font-size : 8pt ; color : red")。定义所选组件的属性(例如,字体和颜色)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。

styleClass

样式:类

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须在生成的标记上作为“class”属性传递。定义所选组件的类(例如,样式表)。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

tabindex

辅助功能 > 跳进顺序索引

指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的数。

title

辅助功能 > 标题

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。

validator

未表示

要实例化的验证器的类名。

value

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

valueChangeListener

未表示

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

相关概念
使用 JavaServer Faces 创建数据访问 Web 应用程序
相关任务
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
输入 - 隐藏
输入 - 密码
输入 - 文本区域
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.