添加至 Faces JSP 页的输入组件为用户提供创建和更新 Web 应用程序数据的方法。选用板的“Faces 组件”抽屉上的输入组件有“输入”、“输入文本区域”、“丰富文本格式区域”、“输入 - 密码”和“输入 - 隐藏”。
要将“输入”组件添加至页面:
- 将“输入”组件从选用板拖至页面。 “属性”视图将显示“输入”组件的属性。
- 在“输入”组件(inputText)的“属性”视图中,可以设置下列属性。还可以将组件绑定至值字段中的记录。要绑定控件,可以单击“属性”视图基本选项卡上的值字段旁边的“绑定至”按钮,或者将属性从“页数据”视图直接拖动到控件上。只有已经定义了数据源,这两种方法才起作用。
- (可选)更改为输入组件自动生成的标识。
- 设置样式属性(字体、字体大小、布局、颜色)和样式类(样式表)。
- 在值字段中,将组件绑定至记录。要绑定组件,可以单击值字段旁边的“绑定至”按钮,或者可以将属性直接从“页数据”视图拖动到组件上。请注意,只有已经定义了数据源,这两种方法才起作用。
- 从列表中选择“格式”:
格式 |
描述 |
字符串 |
这是缺省格式。允许用户输入字母数字文本字符串。 |
数字 |
允许用户输入数字。如果选择“数字”,则可以在面板上设置下列数字属性:
|
日期/时间 |
允许用户输入日期和/或时间。如果选择“日期/时间”,则可设置下列属性:- 类型:从列表中选择日期和/或时间。
- 日期样式:设置日期的样式。例如,2004 年 4 月 2 日。如果选择
“定制”,则可以在模式字段中设置定制日期样式模式。
- 时间样式:设置时间的样式。例如:11:29:48 PM。如果选择“定制”,则可以在模式字段中设置定制时间样式模式。
- 输入辅助:选择显示辅助控件按钮以为用户添加日历辅助控件(如果选择日期)或时钟辅助控件(如果选择时间)。如果添加时钟辅助控件,则还可以设置增量。
- 显示提示字符:在浏览器上启用自动格式化输入日期。例如,输入日期可显示为“__/__/____”。在用户输入日期时,下划线字符(_)会被替换。
- 提示字符 - 在这里指定的字符会替换缺省的下划线字符(_)。
|
掩码 |
设置掩码以过滤用户输入的字母数字输入。如果选择“掩码”,则可以设置下列属性:- 掩码:选择预定义的掩码或输入您自己的掩码。磅字符(#)表示一个数字,而问号字符(?)表示一个字母。掩码可以帮助用户输入诸如电话号码或编号(可能混合了字母和数字)之类的输入。
- 输入辅助 - 显示提示字符:在浏览器上启用自动格式化输入日期。例如,如果指定格式为“###-##-####”的“掩码”,则输入字段显示为“___-__-____”。在用户输入数字时,下划线字符(_)会被替换。
|
- 在验证选项卡(inputText 下面)上,当提交用户输入时可以在服务器上设置验证。通过选择值是必需的,可以要求用户进行输入。可以设置最小值和最大值。对于字符串,可以设置约束以便只允许字母字符串或只允许数字字符串。选择在错误消息控件中显示验证错误消息,以便在输入组件验证失败时可以自动创建显示错误消息的“显示错误”组件。单击单击以创建/编辑定制验证代码以切换至“快速编辑”视图并创建定制代码。
- 在行为选项卡(inputText 下面)上,可以对客户机上的“输入”组件设置行为和验证。可以对用户禁用该组件、使该组件对于用户是只读的、当用户完成输入时进至下一个组件或在将组件提交给服务器时设置组件的最大长度。还可以在客户机上启用验证并选择验证成功或验证失败时要执行的操作。例如,可以在用户成功时禁用输入字段。(注意,如果想要“自动进至下一个控件”对于“日期/时间”组件起作用,则还必须选择验证选项卡上的“在字段中显示原型掩码”。)
- 在辅助功能选项卡(inputText 下面)上,可以将某个键盘键设置为访问键(在运行时单击此键会使组件具有焦点)、组件的跳进顺序和标题(在运行时它可以给用户提示)。
- 除了将“输入”组件添加至页面之外,还可以将下列输入组件拖放至页面:
组件 |
描述 |
输入 - 文本区域 |
一个多行的文本输入字段。可以在“属性”面板上设置行数。其它属性大都类似于“输入”组件的属性。 |
丰富文本格式区域 |
一个丰富文本格式字段,允许用户创建和编辑丰富文本格式文档。 |
输入 - 密码 |
一个用户可输入密码的文本输入字段。 |
输入 - 隐藏 |
一个隐藏的输入字段。“输入 - 隐藏”组件通常由开发者用来在页面与页面上的控件之间传递数据。 |