Form.Element

这是一个用于协助处理表单控件的方法集合。对于表单控件的焦点、串行化、启用/禁用或是获取当前值,它们均提供了相应的处理方法。

在 Prototype 中,Form.Element 也被称为 Field,并且,对于已被扩展(参见 “Prototype 如何扩展 DOM”)的 INPUT、SELECT 和 TEXTAREA 元素,Form.Element 中的所有方法都可以直接使用。因此,下面的语句是等价的:

Form.Element.activate('myfield') 
Field.activate('myfield')
$('myfield').activate() 

当然,你应该根据应用的场景选择合适而简捷的写法。为支持链式编程,大多数 Form.Element 的方法都返回元素自身(除非明确指出返回类型)。

方法

activate

activate(element) -> HTMLElement

使表单控件获得焦点,如果控件是一个文本输入框,还会选取输入框中的内容。

clear

clear(element) -> HTMLElement

清除一个文本输入框的内容。

disable

disable(element) -> HTMLElement

禁用表单控件。控件被禁用后,不能再修改它的值,除非再次启用它。

enable

enable(element) -> HTMLElement

启用一个先前被禁用的表单控件。

focus

focus(element) -> HTMLElement

设置键盘焦点到指定的元素。

getValue

getValue(element) -> string | array

返回表单控件当前的值。除多选框会返回一个数组外,其它的控件均返回一个字符串。该方法的全局访问捷径是 $F()

present

present(element) -> boolean

如果一个文本输入框包含内容,返回 true,否则返回 false

select

select(element) -> HTMLElement

选取文本输入框中包含的文本。

serialize

serialize(element) -> string

使用 name=value 的格式创建表单控件的 URL 编码字符串。

setValue

setValue(element, value) -> HTMLElement

设置表单控件的值。对于多选框,参数 value 应传入一个数组,其它的控件传入字符串。