prototype.js　1.4版开发者手册

【 网络作者：THIN 更新时间：2006-09-20 | 字体：大 中 小】

[导读]prototype.js开发者手册 对应版本1.4.0 original article by sp('Sergio Pereira') Sergio Pereira last update: March 30th 2006 中文版：THIN 最后更新：2006-3-31 看到一个很好的东西在国内没有被很多人使用起来，...

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中找到的所有<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事件处理函数。

 

在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() 相反。

 

• 转载请注明来源：IT学习网 网址：http://www.t086.com/ 向您的朋友推荐此文章
• 特别声明： 本站除部分特别声明禁止转载的专稿外的其他文章可以自由转载，但请务必注明出处和原始作者。文章版权归文章原始作者所有。对于被本站转载文章的个人和网站，我们表示深深的谢意。如果本站转载的文章有版权问题请联系我们，我们会尽快予以更正。

• 上一篇：prototype 1.3 源码解读
• 下一篇：介绍一个javascript库－－jquery
• 查看2006年09月的文章归档