将输入组件添加至 Faces JSP 页面

添加至 Faces JSP 页面的输入组件为用户提供创建和更新 Web 应用程序数据的方法。选用板的“Faces 组件”抽屉上的输入组件有“输入”、“输入文本区域”、“丰富文本格式区域”、“输入 - 密码”和“输入 - 隐藏”。
要将“输入”组件添加至页面:
  1. 将“输入”组件从选用板拖至该页面。 “属性”视图将显示“输入”组件的属性。
  2. 在“输入”组件(inputText)的“属性”视图中,设置属性。
    • (可选)更改为输入组件自动生成的标识
    • 设置样式属性(字体、字体大小、布局、颜色)和样式类(样式表)。
    • 字段中,将该组件与数据对象绑定。要绑定该组件,可以单击字段旁边的“浏览”按钮,也可以将属性从“页数据”视图直接拖放到 Page Designer 中的组件上。
      注: 只有已经定义了数据源,这两种方法才起作用。
  3. 从列表中选择“格式”:
    格式 描述
    String 这是缺省格式。允许用户输入字母数字文本字符串。
    数字 允许用户输入数字。如果选择“数字”,则可以在面板上设置下列数字属性:
    • 类型:选择“十进制”、“货币”、“百分比”或“定制”。如果选择“定制”,则可以定制数字样式。例如,0.00%,您可以在百分数中使用小数。
    • 输入辅助 - 显示辅助控件按钮:如果您想要添加微调框或滑块以帮助用户选择数字,则选择显示辅助控件按钮。微调框使用户能够通过使用箭头增大值或减小值来选择一个值。滑块使用户能够输入一定范围内的值。对于这两种辅助控件,还可以指定“增量”。例如,如果输入 10 作为增量,则滑块或微调框以 10 为增量增大数字。如果具有很大的数字,此项就很有用。还可以为微调框和滑块指定上限和下限。
    • 显示提示字符 - 对浏览器启用自动格式化输入数字。例如,如果用户输入一个数字,例如,1234567,则会在适当的位置自动插入逗号:1,234,567。可以从几个提示字符中进行选择。选择此属性还能够使得在服务器上运行时显示提示字符。
      注: 自动格式化功能不适用于使用指数表示法进行的定制格式化。
      注: 当创建定制数字模式和选择“行为”选项卡上的自动进入下一字段选项时,输入数字的最大位数与数字的符号(正号或负号)无关。自动进入功能假定该数字可能为负数,并且附加位数被输入之前不会自动进入。例如,如果定制数字模式设置为 ####,则用户可以输入 1234(位数为 4 位的正数)或 -1234(位数为 4 位的负数)。因此,如果用户输入位数为 4 位的正数,则在输入第 4 位数字之前将不会自动进入下一字段。如果这不是预期的行为,则单击“属性”视图的“输入文本”选项卡上的显示提示字符
    日期/时间 允许用户输入日期和/或时间。如果选择“日期/时间”,则可设置下列属性:
    • 类型:从列表中选择日期和/或时间。
    • 日期样式:设置日期的样式。例如,2004 年 4 月 2 日。如果选择 “定制”,则可以在模式字段中设置定制日期样式模式。
    • 时间样式:设置时间的样式。例如:11:29:48 PM。如果选择“定制”,则可以在模式字段中设置定制时间样式模式。
    • 输入辅助:选择显示辅助控件按钮以为用户添加日历辅助控件(如果选择日期)或时钟辅助控件(如果选择时间)。如果添加时钟辅助控件,则还可以设置增量。
    • 显示提示字符:在浏览器上启用自动格式化输入日期。例如,输入日期可显示为“__/__/____”。在用户输入日期时,下划线字符(_)会被替换。
    • 提示字符 - 在这里指定的字符会替换缺省的下划线字符(_)。
    Mask 设置掩码以过滤用户输入的字母数字输入。如果选择“掩码”,则可以设置下列属性:
    • 掩码:选择预定义的掩码或输入您自己的掩码。磅字符(#)表示一个数字,而问号字符(?)表示一个字母。掩码可以帮助用户输入诸如电话号码或编号(可能混合了字母和数字)之类的输入。
    • 输入辅助 - 显示提示字符:在浏览器上启用自动格式化输入日期。例如,如果指定格式为“###-##-####”的“掩码”,则输入字段显示为“___-__-____”。在用户输入数字时,下划线字符(_)会被替换。
  4. 验证选项卡(inputText 下面)上,当提交用户输入时可以在服务器上设置验证。通过选择值是必需的,可以要求用户进行输入。可以设置最小值和最大值。对于字符串,可以设置约束以便只允许字母字符串或只允许数字字符串。选择在错误消息控件中显示验证错误消息,以便在输入组件验证失败时自动创建用于显示错误消息的“显示错误”组件。单击单击以创建/编辑定制验证代码以切换至“快速编辑”视图,然后创建该值更改时要执行的定制代码。
  5. 行为选项卡(inputText 下面)上,可以对客户机上的“输入”组件设置行为和验证。可以对用户禁用该组件、使该组件对于用户是只读的、当用户完成输入时进至下一个组件或在将组件提交给服务器时设置组件的最大长度。还可以在客户机上启用验证并选择验证成功或验证失败时要执行的操作。例如,可以在用户成功时禁用输入字段。
  6. 辅助功能选项卡(inputText 下面)上,可以将某个键盘键设置为访问键、组件的跳进顺序和标题。在运行时单击访问键会使组件具有焦点,而标题在运行时可以给用户提示。
  7. 除了将“输入”组件添加至页面之外,还可以将下列输入组件拖放至页面:
    组件 描述
    输入 - 文本区域 一个多行的文本输入字段。可以在“属性”面板上设置行数。其他属性大都类似于“输入”组件的属性。
    丰富文本格式区域 一个富文本格式字段,允许用户创建和编辑富文本格式文档。
    输入 - 密码 一个用户可输入密码的文本输入字段。
    输入 - 隐藏 一个隐藏的输入字段。“输入 - 隐藏”组件通常由开发者用来在页面与页面上的控件之间传递数据。
相关任务
创建连接至数据源的输入表单
对 Faces JSP 文件添加选择列表
对 Faces JSP 文件添加超链接
使用带有 Faces JSP 页的导航规则
使用文件上载组件
管理 JavaServer Faces 应用程序中的错误
创建 Faces JSP 文件
相关参考
输入
日期/时间转换器
掩码转换器
数字转换器

反馈