此组件的可视呈示根据所选组件的不同而变化。
使用“快速编辑”视图配置此组件。要打开“快速编辑”视图,请单击
。下表列示了 <hx:inputHelperAssist> 组件的常用属性。
属性名称 |
描述 |
---|---|
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:
|
successAction |
如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要运行的操作的名称。如果提供了多个操作名称,则应使用分号来分隔。 |
successClass |
如果验证已设置为 true,则该值表示 onblur 被触发、字段值通过验证时要应用于此字段的 CSS 类的名称。 |
targetErrorAction |
该目标与 errorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。 |
targetOnFocusErrorAction |
该目标与 onFocusErrorAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。 |
targetOnfocusSuccessAction |
该目标与 onFocusSucessAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。 |
targetSuccessAction |
该目标与 successAction 参数相关联。缺省情况下,该目标是对其指定此行为的标记。如果提供了多个操作,则可以提供用分号分隔的多个目标。 |
验证 |
指定是否启用客户端验证。缺省值为 true(启用)。 |