Prototype使用指南之form.js

【 tulaoshi.com - Web开发 】

这一部分提供了很多与表单操作有关的功能，包括以下部分，当通过$方法返回元素时，可以直接通过$(element).method()调用：

Form对象：提供了操作整个表单的一些方法
Form.Element对象：提供了操作某个表单元素的方法
TimedObserver类：周期性表单监视器，当表单元素值改变的时候执行一个回调函数，有Form和Element两种类型
EventObserver类：利用事件来监视表单元素，当表单元素值改变的时候执行一个回调函数，有Form和Element两种类型

Form对象：

reset(form)：form.reset()
serializeElements(elements)：将elements中的元素序列化，就是返回指定的所有元素的queryString的形式，便于在xmlhttp或其他地方使用
serialize(form)：序列化整个表单
getElements(form)：返回表单的所有可序列化元素
getInputs(form, typeName, name)：返回所有符合typeName和name的input元素
disable(form)：使整个表单处于不可用状态
enable(form) ：是整个表单可用
findFirstElement(form)：返回类型为'input', 'select', 'textarea'的第一个可用的非隐藏元素
focusFirstElement(form)：使findFirstElement(form)返回的元素得到焦点

Form.Element对象：

focus(element) select(element)：html元素内置方法的封装，除了返回元素本身
serialize(element)：序列化指定的表单元素，返回key=value的形式，返回的string已经encodeURIComponent了
getValue(element)：返回元素的值
clear(element)：清除元素的值
present(element)：判断元素的值是否非空
activate(element)：使元素获得焦点
disable(element)：使元素不可用
enable(element)：是元素可用

$F = Form.Element.getValue 方便使用

Form.Element.Observer以及Form.Observer类：

周期性监视表单元素，如果表单或表单元素的值有改变时，执行执行一个回调函数，使用方式如下：

var oser=new Form.Element.Observer(element, frequency, callback)
or oser=new Form.Observer(form, frequency, callback)
callback可以定义两个参数 form/element、Form.serialize()/value

Form.Element.EventObserver和Form.EventObserver类：

这两个类跟上面的差不多，只是不是周期性的监视，而是利用元素的change或click事件来监视表单元素的变化，当发生变化时执行callback，参数跟上面一样