Prototype1.4手册_Javascript教程-查字典教程网

Prototype1.4手册

摘要：prototype.js开发者手册对应版本1.4.0originalarticlebysp('SergioPereira')SergioPe...

prototype.js开发者手册对应版本1.4.0 original article by sp('Sergio Pereira') Sergio Pereira

last update: March 30th 2006

中文版：THIN

最后更新：2006-3-31

看到一个很好的东西在国内没有被很多人使用起来，实在是不爽，所以花了很大功夫把这个手册翻译成中文，由于这篇文章很长，所以，翻译的工作量很大而且有些地方英文版也没有说清楚，虽得查看源代码，好在不是坚持做完了，大家鼓励下啊！^o^

prototype.js是一个非常优雅的javascript基础类库，对javascript做了大量的扩展，而且很好的支持Ajax，国外有多个基于此类库实现的效果库，也做得很棒。

prototype.js不仅是一个有很大实用价值的js库，而且有很高的学习价值，所以我强烈建议B/S开发人员和对JS开发感兴趣的朋友去浏览一些它的源代码，其中有很多的珠玑，你绝对会觉得读它的源代码是一种享受，当然要读得懂，呵呵。

网上也有人写过1.3版的源码解读，大家可以找来看看。不过1.4版做了很大的扩充，所以希望有朋友写出1.4版的源码解读。

几点说明：有朋友说prototye已经有人翻译过了，呵呵，是对的，说明你以前关注过它，不过原来翻译的是1.3版的文档，1.4版有很多重要的扩展，而且pre_1.5版现在也出来，不地改动不大。有朋友说有用多没有翻译地来的，拜托，只是各个方法的参数说明没有翻，这些说明很多都是什么类型，还是有空再弄吧，先将就一下，对不起了，翻到这个程序已经很累人了，毕竟有这么长。做成CHM文档的事也只能Sorry，因为我没有这个时间，也没有做过CHM，我觉得排版一下看网页和CHM是差不多吧。 prototype.js是什么?

万一你没有使用过大名鼎鼎的prototype.js，那么让我来告诉你，prototype.js是由Sam Stephenson写的一个javascript类库。这个构思奇妙，而且兼容标准的类库，能帮助你轻松建立有高度互动的web2.0特性的富客户端页面。

如果你最近尝试使用它，你大概了解到文档并不是作者的一个强项。和在我以前使用这个类库的不少开发者一样，一开始，我不得不一头扎进阅读prototype.js的源代码和实验它的功能中。我想，在我学习完它之后，把我学到的东西分享给大家是件不错的事。

同时，在本文中，我也将提供一个关于这个类库提供的objects,classes,functions,extensions这对东东的非官方参考

在阅读这个文档时，熟悉Ruby的开发者将会注意到Ruby的一些内建类和本类库扩展实现之间非常相似。

Advanced JavaScript guide.

一些实用的函数

这个类库带有很多预定义的对象和实用函数，这些东东的目的显然是把你从一些重复的打字中解放出来。

使用$()方法

$() 方法是在DOM中使用过于频繁的 document.getElementById() 方法的一个便利的简写，就像这个DOM方法一样，这个方法返回参数传入的id的那个元素。

比起DOM中的方法，这个更胜一筹。你可以传入多个id作为参数然后 $() 返回一个带有所有要求的元素的一个 Array 对象。

<HTML> <HEAD> <TITLE> Test Page </TITLE> <script src="prototype-1.3.1.js"></script> <script> function test1() { var d = $('myDiv'); alert(d.innerHTML); } function test2() { var divs = $('myDiv','myOtherDiv'); for(i=0; i<divs.length; i++) { alert(divs[i].innerHTML); } } </script> </HEAD> <BODY> <div id="myDiv"> <p>This is a paragraph</p> </div> <div id="myOtherDiv"> <p>This is another paragraph</p> </div> <input type="button" value=Test1><br> <input type="button" value=Test2><br> </BODY> </HTML>

另外一个好处是，这个函数能传入用string表示的对象ID，也可以传入对象本身，这样，在建立其它能传两种类型的参数的函数时非常有用。

使用$F()函数

$F()函数是另一个大收欢迎的“快捷键”，它能用于返回任何表单输入控件的值，比如text box,drop-down list。这个方法也能用元素id或元素本身做为参数。

$A()函数能把它接收到的单个的参数转换成一个Array对象。

这个方法，结合被本类库扩展了的Array类，能方便的把任何的可枚举列表转换成或拷贝到一个Array对象。一个推荐的用法就是把DOM Node Lists转换成一个普通的Array对象，从而更有效率的进行遍历，请看下面的例子。

$H()函数把一些对象转换成一个可枚举的和联合数组类似的Hash对象。

$R()是new ObjectRange(lowBound,upperBound,excludeBounds)的缩写。

跳到ObjectRange 类文档可以看到一个关于此类的完整描述. 此时，我们还是先来看一个例子以展示这个缩写能代替哪些方法吧。其它相关的一些知识可以在Enumerable 对象文档中找到。

Try.these() 方法使得实现当你想调用不同的方法直到其中的一个成功正常的这种需求变得非常容易，他把一系列的方法作为参数并且按顺序的一个一个的执行这些方法直到其中的一个成功执行，返回成功执行的那个方法的返回值。

在下面的例子中， xmlNode.text在一些浏览器中好用，但是xmlNode.textContent在另一些浏览器中正常工作。使用Try.these()方法我们可以得到正常工作的那个方法的返回值。

function getXmlNodeValue(xmlNode){

return Try.these(

function() {return xmlNode.text;},

function() {return xmlNode.textContent;)

);

}

</script>

Ajax对象

上面提到的共通方法非常好，但是面对它吧，它们不是最高级的那类东西。它们是吗？你很可能自己编写了这些甚至在你的脚本里面有类似功能的方法。但是这些方法只是冰山一角。

我很肯定你对prototype.js感兴趣的原因很可能是由于它的AJAX能力。所以让我们解释当你需要完成AJAX逻辑的时候，这个包如何让它更容易。

Ajax 对象是一个预定义对象，由这个包创建，为了封装和简化编写AJAX 功能涉及的狡猾的代码。这个对象包含一系列的封装AJAX逻辑的类。我们来看看其中几个类。使用Ajax.Request类

如果你不使用任何的帮助程序包，你很可能编写了整个大量的代码来创建XMLHttpRequest对象并且异步的跟踪它的进程，然后解析出响应然后处理它。当你不需要支持多于一种类型的浏览器时你会感到非常的幸运。

为了支持 AJAX 功能。这个包定义了 Ajax.Request 类。

假如你有一个应用程序可以通过url http://yoursever/app/get_sales?empID=1234&year=1998与服务器通信。它返回下面这样的XML 响应。

<?xml version="1.0" encoding="utf-8" ?> <ajax-response> <response type="object" id="productDetails"> <monthly-sales> <employee-sales> <employee-id>1234</employee-id> <year-month>1998-01</year-month> <sales>$8,115.36</sales> </employee-sales> <employee-sales> <employee-id>1234</employee-id> <year-month>1998-02</year-month> <sales>$11,147.51</sales> </employee-sales> </monthly-sales> </response> </ajax-response>

用 Ajax.Request对象和服务器通信并且得到这段XML是非常简单的。下面的例子演示了它是如何完成的。

你注意到传入 Ajax.Request构造方法的第二个对象了吗？参数{method: 'get', parameters: pars, onComplete: showResponse} 表示一个匿名对象的真实写法。他表示你传入的这个对象有一个名为 method 值为 'get'的属性，另一个属性名为 parameters 包含HTTP请求的查询字符串，和一个onComplete 属性/方法包含函数showResponse。

还有一些其它的属性可以在这个对象里面定义和设置，如 asynchronous，可以为true 或 false 来决定AJAX对服务器的调用是否是异步的（默认值是 true）。

这个参数定义AJAX调用的选项。在我们的例子中，在第一个参数通过HTTP GET命令请求那个url，传入了变量 pars包含的查询字符串， Ajax.Request 对象在它完成接收响应的时候将调用showResponse 方法。

也许你知道， XMLHttpRequest在HTTP请求期间将报告进度情况。这个进度被描述为四个不同阶段：Loading, Loaded, Interactive, 或 Complete。你可以使 Ajax.Request 对象在任何阶段调用自定义方法，Complete 是最常用的一个。想调用自定义的方法只需要简单的在请求的选项参数中的名为 onXXXXX 属性/方法中提供自定义的方法对象。就像我们例子中的 onComplete 。你传入的方法将会被用一个参数调用，这个参数是 XMLHttpRequest 对象自己。你将会用这个对象去得到返回的数据并且或许检查包含有在这次调用中的HTTP结果代码的 status 属性。

还有另外两个有用的选项用来处理结果。我们可以在onSuccess 选项处传入一个方法，当AJAX无误的执行完后调用，相反的，也可以在onFailure选项处传入一个方法，当服务器端出现错误时调用。正如onXXXXX 选项传入的方法一样，这两个在被调用的时候也传入一个带有AJAX请求的XMLHttpRequest对象。

我们的例子没有用任何有趣的方式处理这个 XML响应，我们只是把这段XML放进了一个文本域里面。对这个响应的一个典型的应用很可能就是找到其中的想要的信息，然后更新页面中的某些元素，或者甚至可能做某些XSLT转换而在页面中产生一些HTML。

在1.4.0版本中，一种新的事件回传外理被引入。如果你有一段代码总是要为一个特殊的事件执行，而不管是哪个AJAX调用引发它，那么你可以使用新的Ajax.Responders对象。

假设你想要在一个AJAX调用正在运行时，显示一些提示效果，像一个不断转动的图标之类的，你可以使用两个全局事件Handler来做到，其中一个在第一个调用开始时显示图标，另一个在最后一个调用完成时隐藏图标。看下面的例子。

更完全的解释，请参照 Ajax.Request 参考和 Ajax选项参考。

使用Ajax.Updater类

如果你的服务器的另一端返回的信息已经是HTML了，那么使用这个程序包中 Ajax.Updater 类将使你的生活变得更加得容易。用它你只需提供哪一个元素需要被AJAX请求返回的HTML填充就可以了，例子比我写说明的更清楚。

你可以看到，这段代码比前面的例子更加简洁，不包括 onComplete 方法，但是在构造方法中传入了一个元素id。我们来稍稍修改一下代码来描述如何在客户端处理服务器段错误成为可能。

我们将加入更多的选项，指定处理错误的一个方法。这个是用 onFailure 选项来完成的。我们也指定了一个 placeholder 只有在成功请求之后才会被填充。为了完成这个目的我们修改了第一个参数从一个简单的元素id到一个带有两个属性的对象， success (一切OK的时候被用到) 和 failure (有地方出问题的时候被用到) 在下面的例子中没有用到failure属性，而仅仅在 onFailure 处使用了 reportError 方法。

function getHTML()

{

var url = 'http://yourserver/app/getSomeHTML';

var pars = 'someParameter=ABC';

var myAjax = new Ajax.Updater( {success: 'placeholder'}, url, { method: 'get', parameters: pars, onFailure: reportError }); } function reportError(request) { alert('Sorry. There was an error.'); } </script> <input type=button value=GetHtml> <div id="placeholder"></div>

如果你的服务器逻辑是连同HTML 标记返回JavaScript 代码， Ajax.Updater对象可以执行那段JavaScript代码。为了使这个对象对待响应为JavaScript，你只需在最后参数的对象构造方法中简单加入evalScripts: true属性。但是值得提醒的是，像这个选项名evalScripts暗示的，这些脚本会被执行，但是它们不会被加入到Page的脚本中。“有什么区别？”，可能你会这样问。我们假定请求地址返回的东东像这样：

如果你以前这样尝试过，你知道这些脚本不会如你所期望的那样工作，原因是这段脚本会被执行，但像上面这样的脚本执行并不会创建一个名叫sayHi的函数，它什么也不做。如果要创建一个函数，我们应当把代码改成下面这个样子：

为什么我们在上面的代码中不使用var关键字来声明这个变量呢（指sayHi），因为那样做创建出来的函数将只是当前脚本块的一个局部变量（至少在IE中是这样）。不写var关键字，创建出来的对象的作用域就是我们所期望的window。

更多相关知识，请参看 Ajax.Updater reference 和options reference.

枚举... 噢!噢!

你知道，我们都是这样来做循环的，建一个Array，用elements组织它们，再建一个循环结构（例如for,foreach,while)通过index数字来访问每一个element，再用这个element做一些动作。

当你想到这时，你会发现几乎每次写循环代码你都会迟早用到一个Array。那么，如果Array对象能够提供更多的功能给它们的迭代器使用不是很爽吗？确实是这样，事实上很多的编程语言都在它们的Array或其它类似的结构中（如Collections,Lists）提供一些这样的功能。

现在好了，prototype.js了给我们一个 Enumerable对象，它实现了很多和可迭代数据进行交互的窍门。和原有的JS对象相比prototype.js更上一层楼，它对Array 类s扩展了所有枚举要用的函数。

循环, Ruby样式的

在标准的javascript中，如果你想把一个array中的所有elements显示出来，你可以像下面代码这样写得很好：

使用我们新的最好的朋友，prototype.js，我们可以把它生写成这样

function showList(){ var simpsons = ['Homer', 'Marge', 'Lisa', 'Bart', 'Meg']; simpsons.each( function(familyMember){ alert(familyMember); }); }

你可能会想“非常奇怪的方式...相对旧的，这种语法太怪异了”。哦，在上面的例子，确实什么也没有，在这个简单得要死例子中，也没有改变太多啊，尽管如此，请继续读下去。

在继续下面内容之前，你注意到那个被做为一个参数传递给each函数的函数？我们把它理解成迭代器函数。

Your arrays on steroids

就如我们上面提到的，把你的Array中的elements当成相同的类型使用相同的属性和函数是很通用(Common,不知该翻译成通用还是庸俗)的。让我们看看怎么样利用我们新的马力强劲的Arrays的迭代功能吧。

依照标准找到一个element。

现在我们再下一城，看看如何过滤一个Array中的元素，从每个元素中得到我们想要的成员。

上面的代码仅仅是一点小小的实践让人爱上这种语法。请参看 Enumerable和Array的所有函数

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。

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一样，区别在于用来绑定事件。

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

<input type=checkbox id=myChk value=1> Test? <script> //declaring the class var CheckboxWatcher = Class.create(); //defining the rest of the class implementation CheckboxWatcher.prototype = { initialize: function(chkBox, message) { this.chkBox = $(chkBox); this.message = message; //assigning our method to the event this.chkBox.onclick = this.showMessage.bindAsEventListener(this); }, showMessage: function(evt) { alert(this.message + ' (' + evt.type + ')'); } }; var watcher = new CheckboxWatcher('myChk', 'Changed'); </script> 对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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

对 Array的扩展

因为array扩展于enumerable，所以所有enumberable对象的函数，array都是可以使用的，除此之外，下面的这些也是已经实现了的。

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

document DOM扩展

Method Kind Arguments Description

getElementsByClassName(className [, parentElement])

instance

className: name of a CSS class associated with the elements, parentElement: object or id of the element that contains the elements being retrieved.

返回所有CSS className属性等于className参数的元素，如果没有给出parentElement,那么将搜索document body。(此处使用document.body我觉得不如使用document,因为有时有的页面没有body)

Event扩展

Property Type Description

KEY_BACKSPACE	NumberNumber	8: Constant. Code for the Backspace key.
KEY_TAB	Number	9: Constant. Code for the Tab key.
KEY_RETURN	Number	13: Constant. Code for the Return key.
KEY_ESC	Number	27: Constant. Code for the Esc key.
KEY_LEFT	Number	37: Constant. Code for the Left arrow key.
KEY_UP	Number	38: Constant. Code for the Up arrow key.
KEY_RIGHT	Number	39: Constant. Code for the Right arrow key.
KEY_DOWN	Number	40: Constant. Code for the Down arrow key.
KEY_DELETE	Number	46: Constant. Code for the Delete key.
observers:	Array	List of cached observers. Part of the internal implementation details of the object.

Method Kind Arguments Description

element(event)	static	event: an Event object	返回事件源对象。
isLeftClick(event)	static	event: an Event object	如果点击了鼠标左键，返回true.
pointerX(event)	static	event: an Event object	返回鼠标的X座标。
pointerY(event)	static	event: an Event object	返回鼠标的Y座标。
stop(event)	static	event: an Event object	使用此函数来中断事件的默认行为并阻止传递（冒泡)。
findElement(event, tagName)	static	event: an Event object, tagName: name of the desired tag.	从事件源对象开始向上搜索DOM树，直到找到第一个符合tagName的元素
observe(element, name, observer, useCapture)	static	element: object or id, name: event name (like 'click', 'load', etc), observer: function to handle the event, useCapture: if true, handles the event in the capture phase and if false in the bubbling phase.	为对象的某个事件增加一个处理函数。
stopObserving(element, name, observer, useCapture)	static	element: object or id, name: event name (like 'click'), observer: function that is handling the event, useCapture: if true handles the event in the capture phase and if false in the bubbling phase.	和上面的函数相反。
_observeAndCache(element, name, observer, useCapture)	static		私有函数，别管它。
unloadCache()	static	(none)	私有函数，别管它。从内存中清除所有的observers缓存。

下面代码演示如何给window添加一个load事件处理函数。

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

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 没有太重要的作用，只是声明了该程序包的版本。

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参数。

The Enumerable object

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

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

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参数。

The Hash object

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

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

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参数。

The ObjectRange class

继承自 Enumerable

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

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参数。

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参数。

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

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参数。

The Ajax object

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

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参数。

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参数。

The Ajax.Responders object

继承自 Enumerable

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

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参数。

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参数。

The Ajax.Base class

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

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一样，区别在于用来绑定事件。

The Ajax.Request class

继承自 Ajax.Base

封装 AJAX 操作

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一样，区别在于用来绑定事件。

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一样，区别在于用来绑定事件。

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.

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一样，区别在于用来绑定事件。

The Ajax.Updater class

继承自 Ajax.Request

当请求的url返回一段HTML而你想把它直接放置到页面中一个特定的元素的时候被用到。如果url的返回<script> 的块并且想在接收到时就执行它的时候也可以使用该对象。含有脚本的时候使用 evalScripts 选项。

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一样，区别在于用来绑定事件。

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一样，区别在于用来绑定事件。

The Ajax.PeriodicalUpdater class

继承自Ajax.Base

这个类重复生成并使用 Ajax.Updater 对象来刷新页面中的一个元素。或者执行 Ajax.Updater 可以执行的其它任务。更多信息参照 Ajax.Updater 参考。

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一样，区别在于用来绑定事件。

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一样，区别在于用来绑定事件。

The Element object

这个对象提供在操作DOM中元素时使用的功能性方法。

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一样，区别在于用来绑定事件。

The Element.ClassNames class

继承自 Enumerable

在一个对象中表示CSS class names的集合。

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一样，区别在于用来绑定事件。

The Abstract object

这个对象是这个程序包中其他类的根。它没有任何属性和方法。在这个对象中定义的类可以被视为传统的抽象类。

The Abstract.Insertion class

这个类被用作其他提供动态内容插入功能的类的基类，它像一个抽象类一样被使用。

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The Insertion object

这个对象是其他类似功能的根。它没有任何属性和方法。在这个对象中定义的类仍然可以被视为传统的抽象类。

The Insertion.Before class

继承自 Abstract.Insertion

在给定元素开始标记的前面插入HTML。

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

下面的代码

<br>Hello, <span id="person">Wiggum. How's it going?</span> <script> new Insertion.Before('person', 'Chief '); </script>

将把 HTML 变为

<br>Hello, Chief <span id="person">Wiggum. How's it going?</span> The Insertion.Top class

继承自 Abstract.Insertion

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

下面的代码

<br>Hello, <span id="person">Wiggum. How's it going?</span> <script> new Insertion.Top('person', 'Mr. '); </script>

将把 HTML 变为

<br>Hello, <span id="person">Mr. Wiggum. How's it going?</span> The Insertion.Bottom class

Inherits from Abstract.Insertion

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The following code

<br>Hello, <span id="person">Wiggum. How's it going?</span> <script> new Insertion.Bottom('person', " What's up?"); </script>

Will change the HTML to

<br>Hello, <span id="person">Wiggum. How's it going? What's up?</span> The Insertion.After class

Inherits from Abstract.Insertion

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The following code

<br>Hello, <span id="person">Wiggum. How's it going?</span> <script> new Insertion.After('person', ' Are you there?'); </script>

Will change the HTML to

<br>Hello, <span id="person">Wiggum. How's it going?</span> Are you there? The Field object

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The Form object

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The Form.Element object

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The Form.Element.Serializers object

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

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中找到的所有<script>的数组。
evalScripts()	instance	(none)	执行在string中找到的所有<script>。
toQueryParams()	instance	(none)	把querystring分割才一个用parameter name做index的联合Array，更像一个hash。
parseQuery()	instance	(none)	和toQueryParams()一样.
toArray()	instance	(none)	把字符串转换成字符数组.
camelize()	instance	(none)	转换一个以连字符连接的字符串成一个骆驼法样式的字符串。比如，这个函数在写代码时，把它做为一个样式工具使用是很有用的。

The Abstract.TimedObserver class

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

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

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

The Form.Element.Observer class

继承自 Abstract.TimedObserver

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

The Form.Observer class

继承自 Abstract.TimedObserver

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

The Abstract.EventObserver class

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

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

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

The Form.Element.EventObserver class

继承自 Abstract.EventObserver

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

The Form.EventObserver class

继承自 Abstract.EventObserver

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

7 Position 对象 (预备文档)

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

Method Kind Arguments Description

clear()	instance	(none)	清空。
compact()	instance	(none)	返回一个不包括源array中null或undefined元素的array,此方法不改变源array。
first()	instance	(none)	返回array的第一个对象。
flatten()	instance	(none)	通过递归组合array每个元素的子元素（如果该元素也是array)来返回一个“扁平的”一维的array。
indexOf(value)	instance	value: what you are looking for.	返回给出数字位置（从０算起）的元素，如果在该位置没有找到对象，返回-1。
inspect()	instance	(none)	重载inspect(),返回更好格式的反映Array每个元素的字符描述。
last()	instance	(none)	返回最后一个元素。
reverse([applyToSelf])	instance	applyToSelf: indicates if the array itself should also be reversed.	反转Array中元素的顺序，如果没有给出参数，或参数为true，则源Array中元素的顺序也反转，否则源Array保持不变。
shift()	instance	(none)	返回Array的第一个元素并从Array中移除它，Array的Length-1。
without(value1 [, value2 [, .. valueN]])	instance	value1 ... valueN: values to be excluded if present in the array.	返回一个把参数列表中包含的元素从源Array中排除的Array。

【Prototype1.4手册】相关文章：

★ JavaScript中String.prototype用法

★ JQuery中DOM事件合成用法实例分析

★ js实现仿Windows风格选项卡和按钮效果

★ 一条一条新闻向上的滚动不错

★ jQuery异步上传文件插件ajaxFileUpload详细介绍

★ 免费空间广告万能消除代码

★ JS显示日历和天气的方法

★ Javascript中的Prototype到底是什么

★ JavaScript中isPrototypeOf函数作用和使用实例

★ javascript实现日期按月份加减

上一篇：检测用户按键

下一篇： [JS]点出统计器

学习工具