输入辅助行为

对 inputText 字段启用输入辅助和/或输入验证。在启用了输入辅助的情况下,当字段获得焦点时,将在字段中显示提示字符以指示用户可以输入的位置。当用户输入内容时,系统将对光标进行管理,以使其始终定位在用户可以输入内容的位置。如果用户在该位置输入了无效字符,则将忽略该字符。此外,还可能启用了自动进入和 IME 管理。在启用了输入验证的情况下,当字段获得焦点或失去焦点时,将使用一个或多个验证规则来验证字段内容是否正确。如果字段无效,则可能会执行相应的操作,例如,更改字段的显示、显示错误消息或移动焦点/所选项。

呈示

此组件的可视呈示根据所选组件的不同而变化。

快速编辑视图

使用“快速编辑”视图配置此组件。要打开“快速编辑”视图,请单击窗口 > 显示视图 > 快速编辑

下表列示了 <hx:inputHelperAssist> 组件的常用属性。

表 1. 输入辅助行为属性

属性名称

描述

autoSubmit

如果 autoTab 为 true,而且 autoSubmit 为 true,则当用户在当前字段中输入足够字符数时,就可以自动进入下一字段,而不用手工进入下一字段,此时,将提交包含当前字段的表单。此属性主要供尝试仿真某些“老式”输入机制(例如,仿真 3270 终端)的应用程序使用。

autoTab

如果为 false 或省略,则当输入最大字符数时,焦点不会进入下一字段。如果为 true,则当在字段中输入最大字符数时,焦点将进入下一字段。要使 autoadvance(自动进入)正常工作,字段的模式应明确地标识字段中的最大字符数,或者对字段设置最大长度。例如,模式 ##9 就不明确。虽然可以为一个正数输入三个字符,但如果是负数,则应输入四个字符。因此,在这种情况下,应该设置最大长度。

binding

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

errorAction

如果验证已设置为 true,则该值表示 onblur 被触发、字段值验证失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

id

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

imeMode

如果提供,则当字段获得焦点时,CSS imeMode 属性将设置为提供的值。此属性仅适用于支持 CSS imeMode 属性的浏览器,当前,仅 Internet Explorer 支持此属性。

inputAssist

当前不可用。如果启用了 inputAssist,则它将打开字符检查以验证输入的字符是否有效。

onerror

如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript™ 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。

onfocuserror

如果提供,则当 onfocus 触发且字段值转换失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。

onfocussuccess

如果提供,则当 onfocus 触发且字段值通过转换时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。

onfocusErrorAction

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值转换失败时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

onfocusSuccessAction

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

onfocusSuccessClass

如果验证已设置为 true,则该值表示 onfocus 被触发、字段值通过转换时要应用于此字段的 CSS 类的名称。

onsuccess

如果提供,则当 onblur 触发且字段值通过验证时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作,并且处理错误情况。

promptCharacter

如果提供,则字段将被置入辅助方式,在这种情况下,字段中的每个字符位置都将显示带有字段的指定提示字符或当前值。对于日期/时间字段,可以使用所有数字字符来表示日期。只能在每个位置中输入有效字符。在用户输入时,光标会自动前进到相应的位置。

rendered

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

successAction

如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。

successClass

如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要应用于此字段的 CSS 类的名称。

targetErrorAction

该目标与 errorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetOnFocusErrorAction

该目标与 onFocusErrorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetOnfocusSuccessAction

该目标与 onFocusSucessAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

targetSuccessAction

该目标与 successAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。

验证

指定是否启用客户端验证。缺省值为 true(启用)。


反馈