输入 - 隐藏

在页面上创建隐藏字段。隐藏字段可以包含一些数据,但是用户是看不到的。通常用它来在页面之间传递信息和存储系统信息。

设计时的组件

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

输入 - 隐藏组件在页面上看起来为如下所示:
设计时的“输入 - 隐藏”

运行时的组件

输入 - 隐藏组件在运行时没有显示。

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

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

“输入 - 隐藏”组件的这些常见属性显示在“属性”视图中的 h:inputHidden验证选项卡上。要获取完整的属性列表,请参阅全部输入 - 隐藏属性表。用于验证输入的其它配置选项位于 h:inputHidden> 验证选项卡上:

表 1. “输入 - 隐藏”配置选项

配置选项

描述

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

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

约束

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

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

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

最大长度

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

最小长度

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

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

表 2. 全部“输入 - 隐藏”属性

属性名称

在“属性”视图中表示为

描述

binding

未表示

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

converter

未表示

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

id

标识

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

immediate

未表示

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

rendered

未表示

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

required

验证 > 值是必需的

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

validator

未表示

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

value

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

valueChangeListener

未表示

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

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