Table 2.29. Form 对象
方法 类别 参数 描述
serialize(form) instance form: 表单元素或id 返回url参数格式的项目名和值的列表， 如'field1=value1&field2=value2&field3=value3'。
getElements(form) instance form: 表单元素或id 返回包含所有在表单中输入项目的 Array 对象。
getInputs(form [, typeName [, name]]) instance form: 表单元素或id, typeName: 输入项目的类型, name: 输入项目的名称 返回一个 Array 包含所有在表单中的 <input> 元素。 另外， 这个列表可以对元素的类型或名字属性进行过滤。
disable(form) instance form: 表单元素或id 使表单中的所有输入项目无效。
enable(form) instance form: 表单元素或id 使表单中的所有输入项目有效。
focusFirstElement(form) instance form: 表单元素或id 激活第一个表单中可视的，有效的输入项目。
reset(form) instance form: 表单元素或id 重置表单。和调用表单对象的 reset() 方法一样。

2.28. Form.Element 对象

这个对象提供表单对象中的可视和非可视元素的功能性方法。

Table 2.30. Form.Element 对象
方法 类别 参数 描述
serialize(element) instance element: 表单元素或id 返回元素的 名称=值 对, 如 &apos;elementName=elementValue&apos;。
getValue(element) instance element: 表单元素或id 返回元素的值。

2.29. Form.Element.Serializers 对象

这个对象提供了内部使用的用来协助解析出表单元素的当前值功能性方法。

Table 2.31. Form.Element.Serializers 对象
方法 类别 参数 描述
inputSelector(element) instance element: 一个带有checked属性的表单元素或id， 如 radio 或 checkbox。 返回带有元素名称和值的 Array , 如 [&apos;elementName&apos;, &apos;elementValue&apos;]
textarea(element) instance element: 一个带有value属性的表单元素或id， 如 textbox, button 或 password 项目。 返回带有元素名称和值的 Array , 如 [&apos;elementName&apos;, &apos;elementValue&apos;]
select(element) instance element: 一个<select> 元素对象或id。 返回带有元素名称和所有被选择的选项的值或文本的 Array , 如 [&apos;elementName&apos;, &apos;selOpt1 selOpt4 selOpt9&apos;]

2.30. Abstract.TimedObserver 类

这个类是用于其它监听一个元素的值(或者任何类中涉及的属性)变化的类的基类，这个类像一个抽象类一样被使用。

子类可以被创建来监听如输入项目值，或style属性，或表格的行数，或者其他任何对跟踪变化相关的东西。

子类必须实现这个方法来决定什么才是被监听的元素的当前值。

Table 2.32. Abstract.TimedObserver 类
方法 类别 参数 描述
[ctor](element, frequency, callback) constructor element: 元素对象或id, frequency: 以秒为单位的间隔, callback: 当元素改变的时候调用的方法。 创建一个监听元素的对象。
registerCallback() instance (none) 这个方法通常不会被外部调用。 被这个对象自己调用来开始监听那个元素。
onTimerEvent() instance (none) 这个方法通常不会被外部调用。 被这个对象自己调用来周期性的检查那个元素。

Table 2.33. Abstract.TimedObserver 类
属性 类型 描述
element Object 被监听的元素对象。
frequency Number 每次检查中的以秒为单位的时间间隔。
callback Function(Object, String) 只要元素改变这个方法就会被调用。 会接收到元素对象和新值作为参数。
lastValue String 元素被核实的最后一个值。

2.31. Form.Element.Observer 类

继承自 Abstract.TimedObserver

Abstract.TimedObserver 的一个实现类用来监听表单输入项目的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。否则的话使用 Form.Element.EventObserver 类代替。

Table 2.34. Form.Element.Observer 类
方法 类别 参数 描述
[ctor](element, frequency, callback) constructor element: 元素对象或id, frequency: 以秒为单位的间隔, callback: 当元素改变的时候调用的方法。 继承自 Abstract.TimedObserver. 创建一个监听元素值属性的对象。
getValue() instance (none) 返回元素的值。

2.32. Form.Observer 类

继承自 Abstract.TimedObserver

Abstract.TimedObserver 的一个实现类用来监听表单中任何数据项的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。 否则的话使用类 Form.EventObserver 代替。

Table 2.35. Form.Observer 类
方法 类别 参数 描述
[ctor](form, frequency, callback) constructor form: 表单对象或id, 继承自 Abstract.TimedObserver. 创建一个监听表单变化的对象。
getValue() instance (none) 返回所有表单数据的一系列值。

2.33. Abstract.EventObserver 类

这个类被用作其他一些类的基类，这些类具有在一个元素的值改变事件发生的时候执行一个回调方法这样的功能。

类 Abstract.EventObserver 的多个对象可以绑定到一个元素上，不是一个帮其他的擦出了，而是按照他们付给元素的顺序执行这些回调方法。

单选按钮和复选框的触发事件是 onclick ，而文本框和下拉列表框/下拉列表框的是 onchange 。

子类必须实现这个方法来决定什么才是被监听的元素的当前值。