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
应传入一个数组,其它的控件传入字符串。