输入组件

Java™ 窗口小部件库(JWL)输入组件用于与用户进行交互并将交互结果提交回到服务器以进行处理。

提供了以下输入标记:

选用板上最初处于隐藏状态的组件在表中将用其名称旁边的星号(*)表示。

表 1. 输入组件
组件 标记名 描述
输入 <h:inputText> 创建单行输入控件,此控件用于输入文本或格式化文本,例如数字、日期、时间或格式化字符串。可以通过击键管理、预先输入支持和辅助控件按钮等各种类型的输入辅助组件对此控件进行扩充。有关输入组件的更多信息,请参阅对 Faces JSP 文件添加输入组件。可以为下列数据类型创建输入字段:
  • inputText
  • convertNumber
  • convertDateTime
  • convertMask
输入 - 文本区域 <h:inputTextarea> 创建多行输入控件,此控件用于输入较长的未格式化文本。
输入 - 丰富文本格式区域 <r:inputRichText> 插入丰富文本编辑器组件。与“输入 - 文本区域”组件相同,此组件可以包含多行文本。与“输入文本区域”不同,此组件可以包含不同的字体和大小、表、链接以及编号列表和无序列表。
辅助控件 - 日期拾取器 <hx:inputHelperDatePicker> 对 inputText 字段添加日期拾取器辅助控件按钮。单击该辅助控件按钮将显示一个弹出窗口,该弹出窗口包含可用于选择日期的日历。
辅助控件 - 滑块 <hx:inputHelperSlider> 对 inputText 字段添加数字滑块辅助控件按钮。单击该辅助控件按钮将显示一个弹出窗口,该弹出窗口包含可用于选择数字的“滑块”。
辅助控件 - 微调框 <hx:inputHelperSpinner> 对 inputText 字段添加一对向上/向下微调框按钮。单击微调框按钮将增大/减小数字或时间值。
*输入 - 隐藏 <h:inputHidden> 插入隐藏的输入组件。此组件通常由开发者用来在页面之间或页面上的控件之间传递数据。
输入 - 密码 <h:inputSecret> 在页面中添加密码输入字段。 ???在此字段中输入的文本将以经过修改的形式(通常是星号)回送给用户, 浏览器将尝试对密码进行保护,以避免其作为明文供其他程序访问。 Text entered into the field is echoed back to the user in a modified form (usually as asterisks) and the browser tries to protect the password from being accessible as clear text to other programs.
文件上载 <hx:fileupload> 显示用于上载文件的输入字段和相关联的“浏览”按钮。有关文件上载组件的更多信息,请参阅使用文件上载组件
选择 - 日历 <h:inputMiniCalendar> 在页面中添加小型的日历。用户可以通过在该日历中单击日期来进行选择。
复选框 <h:selectBooleanCheckbox> 创建不带标签的布尔复选框。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
复选框组 <h:hx:selectManyCheckbox> 创建一组带标签的复选框。用户可以从按钮列表中选择零个或多个选项。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
单选按钮组 <h:selectOneRadio> 创建一组带标签的单选按钮。用户可以从按钮列表中选择一个选项。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
组合框 <h:selectOneMenu> 显示允许用户选择一个选项的下拉组合框。您不能直接对组合框输入字段进行编辑。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
选择颜色 <h:selectOneColor> 显示供用户选择颜色的下拉组合框。您不能直接对组合框输入字段进行编辑。
列表框 - 多选 <h:selectManyListbox> 插入允许用户选择多个项的列表框。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
列表框 - 单选 <h:selectOneListbox> 插入允许用户选择一个项的列表框。有关此组件的更多信息,请参阅对 Faces JSP 文件添加选择列表
相关概念
异步 JavaScript 和 XML(AJAX)组件
JavaServer Faces(JSF)概述
JSF 窗口小部件库(JWL)
使用 JavaServer Faces(JSF)开发 Web 应用程序
相关任务
定义输入字段的定制模式

反馈