prototype.js 1.4版开发者手册(强烈推荐)

prototype.js参考

JavaScript类扩展

prototype.js 类库实现强大功能的一种途径是扩展已有的JavaScript 类。

对 Object的扩展

Method	Kind	Arguments	Description
extend(destination, source)	static	destination: any object, source: any object	提供一种通过拷贝所有源以象属性和函数到目标函数实现继承的方法
inspect(targetObj)	static	targetObj: any object	返回可读性好关于目标对象的文字描述，如果对象实例没有定义一个inspect函数，默认返回toString函数的值。

对Number的扩展

Method	Kind	Arguments	Description
toColorPart()	instance	(none)	返回数字的十六进制表示形式。在把一个RGB数字转换成HTML表现形式时很有用。
succ()	instance	(none)	返回下一个数字，这个方法可用于迭代调用场景中。
times(iterator)	instance	iterator: a function object conforming to Function(index)	Calls the iterator function repeatedly passing the current index in the index argument. 反复调用iterator函数并传递当前index到iterator的index参数。

下面的例子用提示框显示0-9。

对 Function扩展

Method	Kind	Arguments	Description
bind(object)	instance	object: the object that owns the method	返回function的实例，这个实例和源function的结构一样，但是它已被绑定给了参数中提供的object，就是说，function中的this指针指向参数object。
bindAsEventListener(object)	instance	object: the object that owns the method	用法和上面的bind一样，区别在于用来绑定事件。

让我们看看如何运用这些扩展。

 Test?

对String的扩展

Method

Kind

Arguments

Description

stripTags()

instance

(none)

返回一个把所有的HTML或XML标记都移除的字符串。

stripScripts()

instance

(none)

返回一个把所有的script都移除的字符串。

escapeHTML()

instance

(none)

返回一个把所有的HTML标记合适的转义掉的字符串。

unescapeHTML()

instance

(none)

escapeHTML()的反转。

extractScripts()

instance

(none)

返回一个包含在string中找到的所有

在prototype.js中定义新的对象和类

另一个这个程序包帮助你的地方就是提供许多既支持面向对象设计理念又有共通功能的许多对象。

The PeriodicalExecuter object

这个对象提供一定间隔时间上重复调用一个方法的逻辑。

Method	Kind	Arguments	Description
[ctor](callback, interval)	constructor	callback: a parameterless function, interval: number of seconds	创建这个对象的实例将会重复调用给定的方法。

Property	Type	Description
callback	Function()	被调用的方法，该方法不能传入参数。
frequency	Number	以秒为单位的间隔。
currentlyExecuting	Boolean	表示这个方法是否正在执行。

The Prototype object

Prototype 没有太重要的作用，只是声明了该程序包的版本 。

Property	Type	Description
Version	String	版本。
emptyFunction	Function()	空函数。
K	Function(obj)	一个仅仅回传参数的函数。
ScriptFragment	String	识别script的正则式。

The Enumerable object

Enumberable对象能够已更优雅的方式实现对列表样式的结构进行枚举。

很多其它的对象通过扩展自Enumberable对象来得到这些有用的接口。

Method	Kind	Arguments	Description
each(iterator)	instance	iterator: a function object conforming to Function(value, index)	把每个element做为第一个参数，element的index作为第一个参数调用iterator函数。
all([iterator])	instance	iterator: a function object conforming to Function(value, index)	这 个函数会用给出的iterator测试整个集合，如果集合中任一元素在iterator函数测试中返回false或null，那么这个函数返回 false,否则返回true。如果没有给出iterator，那么就会测试所有的元素是不是不等于false和null。你可以简单的把它看成是“检测 每个元素都为非空非负”。
any(iterator)	instance	iterator: a function object conforming to Function(value, index), optional.	这 个函数会用给出的iterator测试整个集合，如果集合中任一元素在iterator函数测试中返回true，那么这个函数返回true,否则返回 false。如果没有给出iterator，那么就会测试所有的元素是不是有一个不等于false和null。你可以简单的把它看成是“检测元素中是不是 有非空非负的”。
collect(iterator)	instance	iterator: a function object conforming to Function(value, index)	调用iterator函数根据集合中每个元素返回一个结果，然后按照原来集合中的顺序，返回一个Array。
detect(iterator)	instance	iterator: a function object conforming to Function(value, index)	集合中每个元素调用一次Iterator，返回第一个使Iterator返回True的元素，如果最终都没有为true的调用，那么返回null。
entries()	instance	(none)	等于toArray().
find(iterator)	instance	iterator: a function object conforming to Function(value, index)	等于 detect().
findAll(iterator)	instance	iterator: a function object conforming to Function(value, index)	集合中每个元素调用Iterator，返回一个由所有调用Iterator返回结果等于true的元素组成的数组。和reject()相反。
grep(pattern [, iterator])	instance	pattern: a RegExp object used to match the elements, iterator: a function object conforming to Function(value, index)	用pattern参数正则表达式测试集合中的每个元素，返回一个包含所有匹配正则式的元素的Array，如果给出了Iterator，那个每个结果还要经过一下Iterator处理。
include(obj)	instance	obj: any object	判断集合中包不包含指定对象。
inject(initialValue, iterator)	instance	initialValue: any object to be used as the initial value, iterator: a function object conforming to Function(accumulator, value, index)	用Iterator联接所有集合中的元素。Iterator在被调用时把上一次迭代的结果做为第一个参数传给accumulator。第一次迭代时，accurmelator等于initialValue,最后返回accumulator的值。
invoke(methodName [, arg1 [, arg2 [...]]])	instance	methodName: name of the method that will be called in each element, arg1..argN: arguments that will be passed in the method invocation.	集合中的每个元素调用指定的函数（查看源代码可以发现指定函数被调用时，this指针被传成当前元素），并传入给出的参数，返回调用结果组成的Array。
map(iterator)	instance	iterator: a function object conforming to Function(value, index)	同collect().
max([iterator])	instance	iterator: a function object conforming to Function(value, index)	返回集合中元素的最大值，或调用Iterator后返回值的最大值(如果给出了Iterator的话)。
member(obj)	instance	obj: any object	同 include().
min([iterator])	instance	iterator: a function object conforming to Function(value, index)	返回最小值，参见max()。
partition([iterator])	instance	iterator: a function object conforming to Function(value, index)	返回一个包含两个Array的Array，第一个Array包含所有调用Iterator返回True的元素，第二个Array包含剩下的元素。如果Iterator没有给出，那么就根据元素本身判断。
pluck(propertyName)	instance	propertyName name of the property that will be read from each element. This can also contain the index of the element	返回每个元素的指定属性名的属性的值组成的Array。
reject(iterator)	instance	iterator: a function object conforming to Function(value, index)	和  findAll()相反（返回所有等于false的元素）.
select(iterator)	instance	iterator: a function object conforming to Function(value, index)	同 findAll().
sortBy(iterator)	instance	iterator: a function object conforming to Function(value, index)	根据每个元素调用Iterator返回的值进行排序返回一个Array。
toArray()	instance	(none)	返回由集合所有元素组成的一个Array。
zip(collection1[, collection2 [, ... collectionN [,transform]]])	instance	collection1 .. collectionN: enumerations that will be merged, transform: a function object conforming to Function(value, index)	合 并每个给出的集合到当前集合。合并操作返回一个新的array，这个array的元素个数和原集合的元素个数一样，这个array的每个元素又是一个子 array,它合并了所有集合中相同index的元素。如果transform函数被指定，那么array的每个元素还会调用transform函数先做 处理。举个例子: [1,2,3].zip([4,5,6], [7,8,9]).inspect() 返回 "[ [1,4,7],[2,5,8],[3,6,9] ]"

The Hash object

 Hash对象实现一种Hash结构，也就是一个Key:Value对的集合。

Hash中的每个Item是一个有两个元素的array，前一个是Key，后一个是Value，每个Item也有两个不需加以说明的属性,key和value。

Method	Kind	Arguments	Description
keys()	instance	(none)	返回所有Item的key的集合的一个array。
values()	instance	(none)	返回所有Item的value的集合的一个array。
merge(otherHash)	instance	otherHash: Hash object	合并给出的Hash，返回一个新Hash。
toQueryString()	instance	(none)	以QueryString那样的样式返回hash中所有的item，例如： 'key1=value1&key2=value2&key3=value3'
inspect()	instance	(none)	用一种合适的方法显示hash中的key:value对。

The ObjectRange class

继承自  Enumerable

用上、下边界描述一个对象区域。

Property	Type	Kind	Description
start	(any)	instance	range的下边界
end	(any)	instance	range的上边界
exclusive	Boolean	instance	决定边界自身是不是range的一部分。

Method	Kind	Arguments	Description
[ctor](start, end, exclusive)	constructor	start: the lower bound, end: the upper bound, exclusive: include the bounds in the range?	创建一个range对象，从start生成到end,这里要注意的是，start和end必段类型一致，而且该类型要有succ()方法。
include(searchedValue)	instance	searchedValue: value that we are looking for	检查一个value是不是在range中。

The Class object

在这个程序包中 Class 对象在声明其他的类时候被用到 。用这个对象声明类使得新类支持 initialize() 方法，他起构造方法的作用。

看下面的例子

//declaring the class
var MySampleClass = Class.create();

//defining the rest of the class implmentation
MySampleClass.prototype = {

   initialize: function(message) {
this.message = message;
   },

   showMessage: function(ajaxResponse) {
      alert(this.message);
   }
};

//now, let's instantiate and use one object
var myTalker = new MySampleClass('hi there.');
myTalker.showMessage(); //displays alert

Method	Kind	Arguments	Description
create(*)	instance	(any)	定义新类的构造方法。

The Ajax object

这个对象被用作其他提供AJAX功能的类的根对象。 

Property	Type	Kind	Description
activeRequestCount	Number	instance	正在处理中的Ajax请求的个数。

Method	Kind	Arguments	Description
getTransport()	instance	(none)	返回新的XMLHttpRequest 对象。

The Ajax.Responders object

继承自 Enumerable

这个对象维持一个在Ajax相关事件发生时将被调用的对象的列表。比如，你要设置一个全局钩子来处理Ajax操作异常，那么你就可以使用这个对象。

Property	Type	Kind	Description
responders	Array	instance	被注册到Ajax事件通知的对象列表。

Method	Kind	Arguments	Description
register(responderToAdd)	instance	responderToAdd: object with methods that will be called.	被传入参数的对象应包含名如Ajax事件的系列方法（如onCreate,onComplete,onException）。通讯事件引发所有被注册的对象的合适名称的函数被调用。
unregister(responderToRemove)	instance	responderToRemove: object to be removed from the list.	从列表中移除。
dispatch(callback, request, transport, json)	instance	callback: name of the AJAX event being reported, request: the Ajax.Request object responsible for the event, transport: the XMLHttpRequest object that carried (or is carrying) the AJAX call, json: the X-JSON header of the response (if present)	遍历被 注册的对象列表，找出有由callback参数决定的那个函数的对象。然后向这些函数传递其它的三个参数，如果Ajax响应中包含一个含有JSON内容的 X-JSON HTTP头，那么它会被热行并传入json参数。如果事件是onException,那么transport参数会被异常代替，json不会传递。

The Ajax.Base class

这个类是其他在Ajax对象中定义的类的基类。

Method	Kind	Arguments	Description
setOptions(options)	instance	options: AJAX options	设定AJAX操作想要的选项。
responseIsSuccess()	instance	(none)	返回 true 如果AJAX操作成功,否则为 false 。
responseIsFailure()	instance	(none)	与 responseIsSuccess() 相反。

The Ajax.Request class

继承自 Ajax.Base

封装 AJAX 操作

Property	Type	Kind	Description
Events	Array	static	在AJAX操作中所有可能报告的事件/状态的列表。这个列表包括: 'Uninitialized', 'Loading', 'Loaded', 'Interactive', 和 'Complete'。
transport	XMLHttpRequest	instance	承载AJAX操作的 XMLHttpRequest 对象。
url	string	instance	请求的URL。

Method	Kind	Arguments	Description
[ctor](url, options)	constructor	url: the url to be fetched, options: AJAX options	创建这个对象的一个实例，它将在给定的选项下请求url。onCreate事件在调用constructor事被激发。 重要： 如果选择的url受到浏览器的安全设置，他会一点作用也不起。 很多情况下，浏览器不会请求与当前页面不同主机(域名)的url。 你最好只使用本地url来避免限制用户配置他们的浏览器(谢谢Clay)
evalJSON()	instance	(none)	这个方法显然不会被外部调用。它在Ajax响应中含有X-JSON HTTP头时用于内部调用执行这些内容。
evalReponse()	instance	(none)	这也方法显然不会被外部调用，如果Ajax响应含有一个值为text/javascript的Cotent-Type头，那么这个方法就用被调用执行响应体。
header(name)	instance	name: HTTP header name	引用Ajax响应的头的内容，在Ajax访问结束后再调用这个方法。
onStateChange()	instance	(none)	这个方法通常不会被外部调用。 当AJAX请求状态改变的时候被这个对象自己调用。
request(url)	instance	url: url for the AJAX call	这个方法通常不会被外部调用。已经在构造方法中调用了。
respondToReadyState(readyState)	instance	readyState: state number (1 to 4)	这个方法通常不会被外部调用。 当AJAX请求状态改变的时候被这个对象自己调用。
setRequestHeaders()	instance	(none)	这个方法通常不会被外部调用。 被这个对象自己调用来配置在HTTP请求要发送的HTTP报头。

The options argument object

An important part of the AJAX operations is the options argument. There's no options class per se. Any object can be passed, as long as it has the expected properties. It is common to create anonymous objects just for the AJAX calls.

Property	Type	Default	Description
method	String	'post'	HTTP 请求方式。
parameters	String	''	在HTTP请求中传入的url格式的值列表。
asynchronous	Boolean	true	指定是否做异步 AJAX 请求。
postBody	String	undefined	在HTTP POST的情况下，传入请求体中的内容。
requestHeaders	Array	undefined	和请求一起被传入的HTTP头部列表， 这个列表必须含有偶数个项目， 任何奇数项目是自定义的头部的名称， 接下来的偶数项目使这个头部项目的字符串值。 例子:['my-header1', 'this is the value', 'my-other-header', 'another value']
onXXXXXXXX	Function(XMLHttpRequest, Object)	undefined	在AJAX请求中，当相应的事件/状态形成的时候调用的自定义方法。 例如 var myOpts = {onComplete: showResponse, onLoaded: registerLoaded};. 这个方法将被传入一个参数， 这个参数是承载AJAX操作的 XMLHttpRequest 对象，另一个是包含被执行X-JSON响应HTTP头。
onSuccess	Function(XMLHttpRequest, Object)	undefined	当AJAX请求成功完成的时候调用的自定义方法。 这个方法将被传入一个参数， 这个参数是承载AJAX操作的 XMLHttpRequest 对象，另一个是包含被执行X-JSON响应HTTP头。
onFailure	Function(XMLHttpRequest, Object)	undefined	当AJAX请求完成但出现错误的时候调用的自定义方法。这个方法将被传入一个参数， 这个参数是承载AJAX操作的 XMLHttpRequest 对象，另一个是包含被执行X-JSON响应HTTP头。
onException	Function(Ajax.Request, exception)	undefined	当一个在客户端执行的Ajax发生像无效响应或无效参数这样的异常情况时被调用的自定义函数。它收到两个参数，包含异常Ajax操作的Ajax.Request对象和异常对象。
insertion	an Insertion class	undefined	一个能决定怎么样插入新内容的类，能 Insertion.Before, Insertion.Top, Insertion.Bottom, 或 Insertion.After. 只能应用于Ajax.Updater 对象.
evalScripts	Boolean	undefined, false	决定当响应到达的时候是否执行其中的脚本块，只在 Ajax.Updater 对象中应用。
decay	Number	undefined, 1	决定当最后一次响应和前一次响应相同时在 Ajax.PeriodicalUpdater 对象中的减漫访问的次数， 例如，如果设为2，后来的刷新和之前的结果一样， 这个对象将等待2个设定的时间间隔进行下一次刷新， 如果又一次一样， 那么将等待4次，等等。 不设定这个只，或者设置为1，将避免访问频率变慢。
frequency	Number	undefined, 2	用秒表示的刷新间的间隔，只能应用于 Ajax.PeriodicalUpdater  对象。

The Ajax.Updater class

继承自 Ajax.Request

当请求的url返回一段HTML而你想把它直接放置到页面中一个特定的元素的时候被用到。 如果url的返回

将把 HTML 变为


Hello, Chief Wiggum. How's it going?

The Insertion.Top class

继承自 Abstract.Insertion

在给定元素第一个子节点位置插入 HTML。内容将位于元素的开始标记的紧后面。

Method	Kind	Arguments	Description
[ctor](element, content)	constructor	element: element object or id, content: HTML to be inserted	继承自  Abstract.Insertion. 创建一个可以帮助插入动态内容的对象。

下面的代码


Hello, Wiggum. How's it going?

将把 HTML 变为


Hello, Mr. Wiggum. How's it going?

The Insertion.Bottom class

Inherits from Abstract.Insertion

在给定元素最后一个子节点位置插入 HTML。内容将位于元素的结束标记的紧前面。

Method	Kind	Arguments	Description
[ctor](element, content)	constructor	element: element object or id, content: HTML to be inserted	Inherited from Abstract.Insertion. Creates an object that will help with dynamic content insertion.

The following code

Hello, Wiggum. How's it going?

Will change the HTML to

Hello, Wiggum. How's it going? What's up?

The Insertion.After class

Inherits from Abstract.Insertion

在给定元素结束标记的后面插入HTML。

Method	Kind	Arguments	Description
[ctor](element, content)	constructor	element: element object or id, content: HTML to be inserted	Inherited from Abstract.Insertion. Creates an object that will help with dynamic content insertion.

The following code

Hello, Wiggum. How's it going?

Will change the HTML to

Hello, Wiggum. How's it going? Are you there?

The Field object

这个对象提供操作表单中的输入项目的功能性方法。

Method	Kind	Arguments	Description
clear(field1 [, field2 [, field3 [...]]])	instance	fieldN: field element object or id	清除传入表单中项目元素的值。
present(field1 [, field2 [, field3 [...]]])	instance	fieldN: field element object or id	只有在所有的表单项目都不为空时返回 true 。
focus(field)	instance	field: field element object or id	移动焦点到给定的表单项目。
select(field)	instance	field: field element object or id	选择支持项目值选择的表单项目的值。
activate(field)	instance	field: field element object or id	移动焦点并且选择支持项目值选择的表单项目的值。

The Form object

这个对象提供操作表单和他们的输入元素的功能性方法。

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

The Form.Element object

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

Method	Kind	Arguments	Description
serialize(element)	instance	element: element object or id	返回元素的 名称=值 对, 如 'elementName=elementValue'。
getValue(element)	instance	element: element object or id	返回元素的值。

The Form.Element.Serializers object

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

Method	Kind	Arguments	Description
inputSelector(element)	instance	element: object or id of a form element that has the checked property, like a radio button or checkbox.	返回带有元素名称和值的 Array , 如 ['elementName', 'elementValue']
textarea(element)	instance	element: object or id of a form element that has the value property, like a textbox, button or password field.	返回带有元素名称和值的 Array , 如 ['elementName', 'elementValue']
select(element)	instance	element: object of a element	返回带有元素名称和所有被选择的选项的值或文本的 Array , 如 ['elementName', 'selOpt1 selOpt4 selOpt9']

The Abstract.TimedObserver class

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

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

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

Method	Kind	Arguments	Description
[ctor](element, frequency, callback)	constructor	element: element object or id, frequency: interval in seconds, callback: function to be called when the element changes	创建一个监听元素的对象。
getValue()	instance, abstract	(none)	子类必须实现这个方法以瘊定什么这个元素被监视的当前值。
registerCallback()	instance	(none)	这个方法通常不会被外部调用。 被这个对象自己调用来开始监听那个元素。
onTimerEvent()	instance	(none)	这个方法通常不会被外部调用。 被这个对象自己调用来周期性的检查那个元素。

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

The Form.Element.Observer class

继承自 Abstract.TimedObserver

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

Method	Kind	Arguments	Description
[ctor](element, frequency, callback)	constructor	element: element object or id, frequency: interval in seconds, callback: function to be called when the element changes	继承自 Abstract.TimedObserver. 创建一个监听元素值属性的对象。
getValue()	instance	(none)	返回元素的值。

The Form.Observer class

继承自 Abstract.TimedObserver

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

Method	Kind	Arguments	Description
[ctor](form, frequency, callback)	constructor	form: form object or id, frequency: interval in seconds, callback function to be called when any data entry element in the form changes	继承自 Abstract.TimedObserver. 创建一个监听表单变化的对象。
getValue()	instance	(none)	返回所有表单数据的一系列值。

The Abstract.EventObserver class

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

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

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

Method	Kind	Arguments	Description
[ctor](element, callback)	constructor	element: element object or id, callback: function to be called when the event happens	创建监听元素的对象。
getValue()	instance,abstract	(none)	子类必须实现这个方法以瘊定什么这个元素被监视的当前值。
registerCallback()	instance	(none)	这个方法通常不会被外部调用。 被对象调用来把自己绑定到元素的事件上。
registerFormCallbacks()	instance	(none)	这个方法通常不会被外部调用。 被对象调用来把自己绑定到表单中的每一个数据项元素的事件上。
onElementEvent()	instance	(none)	这个方法通常不会被外部调用。 将被绑定到元素的事件上。

Property	Type	Description
element	Object	被监听的元素对象。
callback	Function(Object, String)	只要元素改变就调用的方法。会接收到元素对象和新值作为参数。
lastValue	String	元素被核实的最后一个值。

The Form.Element.EventObserver class

继承自 Abstract.EventObserver

Abstract.EventObserver 的一个实现类，它在监测到表单中数据项元素的值改变的相应事件时候执行一个回调方法。 如果元素没有任何报告变化的事件，那么你可以使用 Form.Element.Observer 类代替。

Method	Kind	Arguments	Description
[ctor](element, callback)	constructor	element: element object or id, callback: function to be called when the event happens	继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。
getValue()	instance	(none)	返回元素的值。

The Form.EventObserver class

继承自 Abstract.EventObserver

Abstract.EventObserver 的一个实现类，监听表单对象中包含的任何对象的任何变化，用元素的事件检测值的变化。如果元素没有任何报告变化的事件， 那么你可以使用Form.Observer 类代替。

Method	Kind	Arguments	Description
[ctor](form, callback)	constructor	form: form object or id, callback: function to be called when any data entry element in the form changes	继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。
getValue()	instance	(none)	返回所有表单数据的一系列值。

Position 对象 (预备文档)

这个对象提供许多和元素位置相关的方法。

Method	Kind	Arguments	Description
prepare()	instance	(none)	调整 deltaX 和 deltaY 属性来协调在滚动位置中的变化。 记得在页面滚动之后的任何调用的withinIncludingScrolloffset 之前调用这个方法。
realOffset(element)	instance	element: object	返回这个元素的正确滚动偏差的 Array 对象， 包括所有影响元素的滚动偏差。结果数组类似 [total_scroll_left, total_scroll_top]
cumulativeOffset(element)	instance	element: object	回这个元素的正确滚动偏差的 Array 对象， 包含任何被放置的父元素强加偏差。结果数组类似 [total_offset_left, total_offset_top]
within(element, x, y)	instance	element: object, x and y: coordinates of a point	测试给定的点的坐标是否在给定的元素的外部矩形范围之内。
withinIncludingScrolloffsets(element, x, y)	instance	element: object, x and y: coordinates of a point	测试给定的点的坐标是否在给定的元素的外部矩形范围之内（包含scroll offsets）。
overlap(mode, element)	instance	mode: 'vertical' or 'horizontal', element: object	在调用这个方法之前需要调用within() 。这个方法返回0.0到1.0之间的数字，来表示坐标在元素重叠的分数。 举个例子，如果元素是一个边长是100px的正方形的DIV，并且位于(300, 300), 然后 within(divSquare, 330, 330)；overlap('vertical', divSquare); 会返回 0.10，意思是那个点位于DIV顶部边框以下 10% (30px) 的位置上。
clone(source, target)	instance	source: element object or id, target: element object or id	改变目标元素的大小尺寸和位置与源元素的相同。

阅读(903) | 评论(0) | 转发(0) |

0

上一篇： prototype.js　1.4版开发者手册(强烈推荐)

下一篇：Java中文乱码问题大全

给主人留下些什么吧！~~

评论热议

请登录后评论。

登录 注册

关于我们 | 关于IT168 | 联系方式 | 广告合作 | 法律声明 | 免费注册

Copyright 2001-2010 ChinaUnix.net All Rights Reserved 北京皓辰网域网络信息技术有限公司. 版权所有

感谢所有关心和支持过ChinaUnix的朋友们

16024965号-6