JSF 辅助

JSF 辅助对象管理特定类型输入字段的键盘和鼠标交互,即,它们支持字段的“输入辅助”交互。对于转换器和验证器而言,这些对象已进行分类。即,日期、掩码和数字各有适用的对象。

这些对象由输入辅助行为创建,因此不适用于公共用途,即,您无法构造这些对象并进行使用。

辅助对象使用了另外三种 JSF 对象 - 进行了适当分类的转换器对象,例如日期时间转换器,以及进行了适当分类的验证器对象(如果要验证字段)和输入状态对象,其中该输入状态对象由行为创建,用于提供通用键盘和鼠标事件。

每个辅助对象支持一组统一的调用,用于处理键盘/鼠标交互。例如,提供了 onfocus 处理程序、onblur 处理程序、keypress 处理程序、cut 处理程序和 paste 处理程序等等。在生成字段的事件时,会将它们发送至该字段的输入状态对象,此对象用于进行通用键盘/鼠标状态管理。接着,输入状态对象调用适当的辅助对象,后者为每个事件提供了特定于类型的支持。例如,用户按下左方向键时,输入状态对象捕获的事件将确定是否按下了控制键,将字段状态设置为“正在处理”,并且将调用相应辅助对象的 onChangeKeyCode 处理程序。然后,键代码处理程序确定如何为此类型的值处理左方向键。将处理该键并更新字段状态。控制权将返回到输入状态管理器,以便确定状态处理过程中的下一个步骤。例如,此管理器可能检查字段是否已填满以及是否应该调用自动跳进功能。

这三个辅助对象的文档对辅助如何作用于每种受支持类型作了概述。

构造函数语法

new hX_5.NameAssist(_elem, _state, _converter, _validator, _promptChar)); 其中

id

指定给此转换器的 ID。此标识在页面(或门户网站)中的所有已创建转换器中都必须唯一。可以将任何字符串值用作此 ID。

名称

JSF 辅助的名称。请参阅下面的内容以获取辅助对象的列表。

_elem

输入字段的 DOM 对象。

_state

与 JSF 行为相关联的输入状态对象。

_converter

定义字段的模式/格式的转换器对象。

_validator

与行为相关联的可选验证器对象。

_promptChar

在此字段的输入辅助中使用的提示字符(单字符)。

API 调用

辅助对象没有常用 API 调用。辅助对象由行为的实现专用。

辅助对象列表

转换器

描述

NumberAssist

管理数字类型输入字段的击键/鼠标事件

DateTimeAssist

管理日期/时间类型输入字段的击键/鼠标事件

MaskAssist

管理辅助类型输入字段的击键/鼠标事件

相关概念
JSF 窗口小部件库(JWL)

反馈