().Prototype1.5 rc2)使用指南之array.js

$A = Array.from(iterable): iterable转化为数组,如果iterable定义了toArray方法,就调用这个方法,否则利用iterablelength属性进行枚举, 如果iterable没有length属性的话就返回空数组[]

Array对象除了扩展Enumerable对象的方法外,另外扩展了如下的几个方法,

注意以下方法除了clear外都不改变原来数组,而是返回一个新数组:

clear(): 清除数组,利用arr.length=0

first(): 返回第一个元素

last():返回最后一个元素

compact(): 去除数组中值为nullundefined的元素

flatten(): 将数组扁平化,例如[3,4,[6,7]]变为[3,4,6,7]

without(): 去除指定的元素, 可以指定多个值, 例如[4,56,7,8].without(4,7) 返回[568]

indexOf(object): 返回指定的元素在数组中的索引,不包含则返回-1

reverse(inline)Array内置函数reverse的增强,当inlinetrue时,跟内置的reverse函数效果一样,改变原数组的值,否则不改变原来的值

reduce(): 如果数组只有一个元素,则返回这个元素,否则返回数组本身

uniq(): 返回没有重复元素的数组

clone(): 返回一个跟数组相同的数组,Array中的toArray方法覆盖了Enumerable中的toArray方法,指向了这个方法

inspect(): 跟数组的toString方法类似,返回对象的字符串表示,例如[2,3].inspect() 返回 "[2,3]"

().Prototype1.5 rc2)使用指南之hash.js

Hash对象(关联数组)Prototype新建的一个对象,要创建一个Hash对象可以调用$H(object)方法,使用这个方法将生成一个基于 object对象的Hash对象,生成的Hash对象将object的属性名作为key,将object的属性值最为键值,因为javascript本身的特点(对象本身就是关联数组) ,所以实现Hash也很简单,Prototype中的Hash只是javascript的关联数组(对象)而已

Prototype中的Hash对象继承自Enumerable对象,所以也具有Enumerable对象的所有属性和方法,另外它具有以下的方法:

keys(): 返回hash的键值数组

values(): 返回值得数组

merge(hash): 合并两个hash

toQueryString(): stringtoQueryParams方法想法,将hash转化为一个querystring, 会调用encodeURIComponent对键和值进行编码

inspect(): hash的字符串表示

因为hash只是javascript的一个普通的对象而已,所以添加一个键值对使用: hash[key]=value就可以了,删除一个键值对使用 detele hash[key]就可以了

().Prototype1.5 rc2)使用指南之range.js

Range对象是一个继承自Enumerable"范围"对象,你可以把它看成[x,x+1,x+2,x+3……x+n]的数组看待,但是比这样的数组更节省存储空间,因为range对象只是保存xx+n而已

要创建一个Range对象调用$R(start, end, exclusive) 函数就可以了,exclusive指定是否包含end本身,如果没有指定或为false则包含end,否则不包含,你可以利用Enumerable中定义的方法来操作range对象,range对象只是实现了Enumerable对象需要的枚举逻辑_each和覆盖了include方法而已

().Prototype1.5 rc2)使用指南之ajax

Prototype中的ajax.js提供了一个非常好用的ajax框架,一般应用中简单的调用以下代码就可以了

new Ajax.Request(

    url, {method: “get”,

    onSuccess: showFilter,

    onFailure: function(request){alert(”Server error!”)},

    onException: showError}

 );

这个框架中提供了如下的对象和方法等:

Ajax对象:

只有一个getTransport方法,返回一个XMLHttpRequest对象,另外有一个activeRequestCount属性,反映当前正在处理的ajax数量

Ajax.Responders对象:

继承自Enumerable,管理全局Ajax的请求,具有如下方法

register(responder):注册一个管理ajax请求的对象

unregister(responder):撤销一个管理ajax请求的对象

dispatch(callback, request, transport, json):触发注册的处理对象的方法

这个对象一般很少使用,系统中已经使用如下的代码注册了一个处理对象

Ajax.Responders.register({

 onCreate: function() {

    Ajax.activeRequestCount++;

 },

 onComplete: function() {

    Ajax.activeRequestCount–;

 }

});

Ajax.Base类:

Ajax的基类, 只有一个方法setOptions(options), 默认request参数如下,你可以在新建Ajax.request时指定:

method:       'post’,

asynchronous: true,

contentType: 'application/x-www-form-urlencoded’,

encoding:     'UTF-8,

Ajax.Request类:

ajax主要的类,继承自ajax.base类,客户端使用 new Ajax.Request(url,options) 调用,options是一个对象(关联数组), options中可以指定methodasynchronouscontentTypeencodingparameters postBodyusername,password等选项,其中parameters可以是字符传或者关联数组象,

另外在options中还可以通过requestHeaders指定request heads,其中requestHeaders可以是数组(例如[Connection,Close,aheadkey,aheadvalue])或一个关联数组;

options中最重要的选项就是指定ajax的回调方法,可以定义onComplete, onSuccess, onFailure, onException(执行过程中发生异常调用的方法,主要为onComplete, onSuccess, onFailure等回调方法产生的),甚至可以定义on404,on503这样的回调方法,它们的参数为(transport, json),其中transport为请求的XMLHttpRequest对象, jsonevalJSON的结果

如果返回的是一个javascript文件(根据返回的Content-type头判断)将会执行evalResponse方法,另外Ajax.Request对象还有一个evalJSON方法,取得文件的时候就会执行

这个对象的方法列表如下:

request(url) : 发送请求,new的时候就已经调用了,所以一般不需要使用

success(): 判断request是否成功了

getHeader(name):根据name得到request head

evalJSON(): 执行getHeader(X-JSON),并返回结果

evalResponse(): 执行返回的responseText并返回

Ajax.Updater:

继承自Ajax.Request,只是比Ajax.Request增加了更新html元素的功能,一般使用方法是new Ajax.Updater(element, url, options), element可以是一个元素,也可以是{success:e1,failure:e2}这种形式,

默认情况下不会执行返回结果中的javascript,如果你先执行,你可以指定options中的evalScriptstrue

默认情况下是替换指定元素的内容,如果你希望是添加,可以指定optionsinsertion参数, insertion是一个Insertion.BeforeInsertion.TopInsertion.Bottom Insertion.After(将在dom.js中介绍)

Ajax.PeriodicalUpdater:

继承自Ajax.Base,周期性的更新一个html元素的内容,这个类会调用Ajax.Updaterhtml元素进行周期性的更新,使用方法为new Ajax.PeriodicalUpdater(container, url, options), 参数跟Ajax.Updater差不多,其中options可以设置frequency(默认为2)decaydecay指的是当请求的内容没有变化的时候,frequency需要延长的倍数,默认是1,例如如果decay设为2frequency设为3而内容一直没有变化,则请求的时间依次会变为 3,6,12,24

start(): 开始更新, 初始化的时候会自动调用

stop(): 停止更新



------君临天下,舍我其谁------