prototype.js开发参考手册(转贴)
2006-08-10 10:06
260 查看
prototype.js开发笔记
覆盖版本1.3.11.Prototype是什么?
或许你还没有用过它,如果你最近体验了这个程序包,你很可能会发现文档并不是它的强项之一。像所有在我之前的开发者一样,我只能一头扎进prototype.js的源代码中并且试验其中的每一个部分。我想当我学习他的时候记写笔记然后分享给其他人将会很不错。
我也一起提供了这个包的对象,类,方法和扩展的
2.通用性方法
这个程序包里面包含了许多预定义的对象和通用性方法。编写这些方法的明显的目的就是为了减少你大量的重复编码和惯用法。2.1.使用$()方法
$()方法是在DOM中使用过于频繁的document.getElementById()方法的一个便利的简写,就像这个DOM方法一样,这个方法返回参数传入的id的那个元素。比起DOM中的方法,这个更胜一筹。你可以传入多个id作为参数然后$()返回一个带有所有要求的元素的一个Array对象。下面的例子会向你描述这些。
<HTML>
<HEAD>
<TITLE>TestPage</TITLE>
<scriptsrc="prototype-1.3.1.js"></script>
<script>
functiontest1()
{
vard=$('myDiv');
alert(d.innerHTML);
}
functiontest2()
{
vardivs=$('myDiv','myOtherDiv');
for(i=0;i<divs.length;i++)
{
alert(divs[i].innerHTML);
}
}
</script>
</HEAD>
<BODY>
<divid="myDiv">
<p>Thisisaparagraph</p>
</div>
<divid="myOtherDiv">
<p>Thisisanotherparagraph</p>
</div>
<inputtype="button"value=Test1onclick="test1();"><br>
<inputtype="button"value=Test2onclick="test2();"><br>
</BODY>
</HTML>
这个方法的另一个好处就是你可以传入id字符串或者元素对象自己,这使得在创建可以传入任何形式参数的方法的时候,它变得非常有用。
2.2.使用$F()方法
$F()方法是另一个非常受欢迎的简写。它可以返回任何输入表单控件的值,如文本框或下拉框。这个方法可以传入元素的id或者元素自己。<script>
functiontest3()
{
alert($F('userName'));
}
</script>
<inputtype="text"id="userName"value="JoeDoe"><br>
<inputtype="button"value=Test3onclick="test3();"><br>
2.3.使用Try.these()方法
Try.these()方法使得实现当你想调用不同的方法直到其中的一个成功正常的这种需求变得非常容易,他把一系列的方法作为参数并且按顺序的一个一个的执行这些方法直到其中的一个成功执行,返回成功执行的那个方法的返回值。在下面的例子中,xmlNode.text在一些浏览器中好用,但是xmlNode.textContent在另一些浏览器中正常工作。使用Try.these()方法我们可以得到正常工作的那个方法的返回值。
<script>
functiongetXmlNodeValue(xmlNode){
returnTry.these(
function(){returnxmlNode.text;},
function(){returnxmlNode.textContent;)
);
}
</script>
3.Ajax对象
上面提到的共通方法非常好,但是面对它吧,它们不是最高级的那类东西。它们是吗?你很可能自己编写了这些甚至在你的脚本里面有类似功能的方法。但是这些方法只是冰山一角。我很肯定你对prototype.js感兴趣的原因很可能是由于它的AJAX能力。所以让我们解释当你需要完成AJAX逻辑的时候,这个包如何让它更容易。
Ajax对象是一个预定义对象,由这个包创建,为了封装和简化编写
3.1.使用Ajax.Request类
如果你不使用任何的帮助程序包,你很可能编写了整个大量的代码来创建XMLHttpRequest对象并且异步的跟踪它的进程,然后解析出响应然后处理它。当你不需要支持多于一种类型的浏览器时你会感到非常的幸运。为了支持AJAX功能。这个包定义了Ajax.Request类。
假如你有一个应用程序可以通过url
<?xmlversion="1.0"encoding="utf-8"?>
<ajax-response>
<responsetype="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是非常简单的。下面的例子演示了它是如何完成的。
<script>
functionsearchSales()
{
varempID=$F('lstEmployees');
vary=$F('lstYears');
varurl='http://yoursever/app/get_sales';
varpars='empID='+empID+'&year='+y;
varmyAjax=newAjax.Request(
url,
{method:'get',parameters:pars,onComplete:showResponse}
);
}
functionshowResponse(originalRequest)
{
//putreturnedXMLinthetextarea
$('result').value=originalRequest.responseText;
}
</script>
<selectid="lstEmployees"size="10"onchange="searchSales()">
<optionvalue="5">Buchanan,Steven</option>
<optionvalue="8">Callahan,Laura</option>
<optionvalue="1">Davolio,Nancy</option>
</select>
<selectid="lstYears"size="3"onchange="searchSales()">
<optionselected="selected"value="1996">1996</option>
<optionvalue="1997">1997</option>
<optionvalue="1998">1998</option>
</select>
<br><textareaid=resultcols=60rows=10></textarea>
你看到传入Ajax.Request构造方法的第二个对象了吗?参数{method:'get',parameters:pars,onComplete:showResponse}表示一个匿名对象的真实写法。他表示你传入的这个对象有一个名为method值为'get'的属性,另一个属性名为parameters包含HTTP请求的查询字符串,和一个onComplete属性/方法包含函数showResponse。
还有一些其它的属性可以在这个对象里面定义和设置,如asynchronous,可以为true或false来决定AJAX对服务器的调用是否是异步的(默认值是true)。
这个参数定义AJAX调用的选项。在我们的例子中,在第一个参数通过HTTPGET命令请求那个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。
更完全的解释,请参照
3.2.使用Ajax.Updater类
如果你的服务器的另一端返回的信息已经是HTML了,那么使用这个程序包中Ajax.Updater类将使你的生活变得更加得容易。用它你只需提供哪一个元素需要被AJAX请求返回的HTML填充就可以了,例子比我写说明的更清楚。<script>
functiongetHTML()
{
varurl='http://yourserver/app/getSomeHTML';
varpars='someParameter=ABC';
varmyAjax=newAjax.Updater('placeholder',url,{method:'get',parameters:pars});
}
</script>
<inputtype=buttonvalue=GetHtmlonclick="getHTML()">
<divid="placeholder"></div>
你可以看到,这段代码比前面的例子更加简洁,不包括onComplete方法,但是在构造方法中传入了一个元素id。我们来稍稍修改一下代码来描述如何在客户端处理服务器段错误成为可能。
我们将加入更多的选项,指定处理错误的一个方法。这个是用onFailure选项来完成的。
我们也指定了一个placeholder只有在成功请求之后才会被填充。为了完成这个目的我们修改了第一个参数从一个简单的元素id到一个带有两个属性的对象,success(一切OK的时候被用到)和failure(有地方出问题的时候被用到)在下面的例子中没有用到failure属性,而仅仅在onFailure处使用了reportError方法。
<script>
functiongetHTML()
{
varurl='http://yourserver/app/getSomeHTML';
varpars='someParameter=ABC';
varmyAjax=newAjax.Updater(
{success:'placeholder'},
url,
{method:'get',parameters:pars,onFailure:reportError});
}
functionreportError(request)
{
alert('Sorry.Therewasanerror.');
}
</script>
<inputtype=buttonvalue=GetHtmlonclick="getHTML()">
<divid="placeholder"></div>
如果你的服务器逻辑是返回JavaScript代码而不是单纯的HTML标记,Ajax.Updater对象可以执行那段JavaScript代码。为了使这个对象对待响应为JavaScript,你只需在最后参数的对象构造方法中简单加入evalScripts:true属性。
更完全的解释,请参照
4.prototype.js参考
4.1.JavaScript类的扩展
prototype.js包中加入功能的一种途径就是扩展已有的JavaScript类。4.2.对Object类的扩展
Table1.Object类的扩展方法 | 类别 | 参数 | 描述 |
extend(destination,source) | static | destination:任何对象,source:任何对象 | 用从source到destination复制所有属性和方法的方式来提供一种继承机制。 |
extend(object) | instance | 任何对象 | 用从传入的object中复制所有属性和方法的方式来提供一种继承机制。 |
4.3.对Number类的扩展
Table2.Number类的扩展方法 | 类别 | 参数 | 描述 |
toColorPart() | instance | (none) | 返回数字的十六进制描述,当在HTML中转换为RGB颜色组件到HTML中使用的颜色。 |
4.4.对Function类的扩展
Table3.对Function类的扩展方法 | 类别 | 参数 | 描述 |
bind(object) | instance | object:拥有这个方法的对象 | 返回预先绑定在拥有该函数(=方法)的对象上的函数实例,返回的方法将和原来的方法具有相同的参数。 |
bindAsEventListener(object) | instance | object:拥有这个方法的对象 | 返回预先绑定在拥有该函数(=方法)的对象上的函数实例,返回的方法将把当前的事件对象作为它的参数。 |
<inputtype=checkboxid=myChkvalue=1>Test?
<script>
//declaringtheclass
varCheckboxWatcher=Class.create();
//definingtherestoftheclassimplmentation
CheckboxWatcher.prototype={
initialize:function(chkBox,message){
this.chkBox=$(chkBox);
this.message=message;
//assigningourmethodtotheevent
this.chkBox.onclick=this.showMessage.bindAsEventListener(this);
},
showMessage:function(evt){
alert(this.message+'('+evt.type+')');
}
};
varwatcher=newCheckboxWatcher('myChk','Changed');
</script>
4.5.对String类的扩展
Table4.String类的扩展方法 | 类别 | 参数 | 描述 |
stripTags() | instance | (none) | 返回一个把所有的HTML或XML标记都移除的字符串。 |
escapeHTML() | instance | (none) | 返回一个把所有的HTML标记回避掉的字符串。 |
unescapeHTML() | instance | (none) | 和escapeHTML()相反。 |
4.6.对documentDOM对象的扩展
Table5.documentDOM对象的扩展方法 | 类别 | 参数 | 描述 |
getElementsByClassName(className) | instance | className:关联在元素上的CSS类名 | 返回给定的具有相同的CSS类名的所有元素。 |
4.7.对Event对象的扩展
Table6.Event对象的扩展属性 | 类型 | 描述 |
KEY_BACKSPACE | Number | 8:常量,退格(Backspace)键的代码。 |
KEY_TAB | Number | 9:常量,Tab键的代码。 |
KEY_RETURN | Number | 13:常量,回车键的代码。 |
KEY_ESC | Number | 27:常量,Esc键的代码。 |
KEY_LEFT | Number | 37:常量,左箭头键的代码。 |
KEY_UP | Number | 38:常量,上箭头键的代码。 |
KEY_RIGHT | Number | 39:常量,右箭头键的代码。 |
KEY_DOWN | Number | 40:常量,下箭头键的代码。 |
KEY_DELETE | Number | 46:常量,删除(Delete)键的代码。 |
observers: | Array | 缓存的观察者的列表,这个对象内部具体实现的一部分。 |
方法 | 类别 | 参数 | 描述 |
element(event) | static | event:事件对象 | 返回引发这个事件的元素。 |
isLeftClick(event) | static | event:事件对象 | 如果鼠标左键单击返回true。 |
pointerX(event) | static | event:事件对象 | 返回在页面上x坐标。 |
pointerY(event) | static | event:事件对象 | 返回在页面上y坐标。 |
stop(event) | static | event:事件对象 | 用这个方法来中止事件的默认行为来使事件的传播停止。 |
findElement(event,tagName) | static | event:事件对象,tagName:指定标记的名字 | 向DOM树的上位查找,找到第一个给定标记名称的元素,从这个元素开始触发事件。 |
observe(element,name,observer,useCapture) | static | element:对象或者对象id,name:事件名(如'click','load',etc),observer:处理这个事件的方法,useCapture:如果true,在捕捉到事件的阶段处理事件那么如果false在bubbling阶段处理。 | 加入一个处理事件的方法。 |
stopObserving(element,name,observer,useCapture) | static | element:对象或者对象id,name:事件名(如'click','load',etc),observer:处理这个事件的方法,useCapture:如果true,在捕捉到事件的阶段处理事件那么如果false在bubbling阶段处理。 | 删除一个处理实践的方法。 |
_observeAndCache(element,name,observer,useCapture) | static | 私有方法,不用管它。 | |
unloadCache() | static | (none) | 私有方法,不用管它。清除内存中的多有观察着缓存。 |
<script>
Event.observe(window,'load',showMessage,false);
functionshowMessage(){
alert('Pageloaded.');
}
</script>
4.8.在prototype.js中定义的新对象和类
另一个这个程序包帮助你的地方就是提供许多既支持面向对象设计理念又有共通功能的许多对象。4.9.PeriodicalExecuter对象
这个对象提供一定间隔时间上重复调用一个方法的逻辑。Table8.PeriodicalExecuter对象
方法 | 类别 | 参数 | 描述 |
[ctor](callback,interval) | constructor | callback:没有参数的方法,interval:秒数 | 创建这个对象的实例将会重复调用给定的方法。 |
属性 | 类型 | 描述 |
callback | Function() | 被调用的方法,该方法不会被传入参数。 |
frequency | Number | 以秒为单位的间隔。 |
currentlyExecuting | Boolean | 表示这个方法是否正在执行。 |
4.10.Prototype对象
Prototype没有太重要的作用,只是声明了该程序包的版本。Table10.ThePrototypeobject
属性 | 类型 | 描述 |
Version | String | 包的版本。 |
emptyFunction | Function() | 空方法对象。 |
4.11.Class对象
在这个程序包中Class对象在声明其他的类时候被用到。用这个对象声明类使得新类支持initialize()方法,他起构造方法的作用。看下面的例子
//declaringtheclass
varMySampleClass=Class.create();
//definingtherestoftheclassimplmentation
MySampleClass.prototype={
initialize:function(message){
this.message=message;
},
showMessage:function(ajaxResponse){
alert(this.message);
}
};
//now,let'sinstantiateanduseoneobject
varmyTalker=newMySampleClass('hithere.');
myTalker.showMessage();//displaysalert
Table11.Class对象
方法 | 类别 | 参数 | 描述 |
create(*) | instance | (any) | 定义新类的构造方法。 |
4.12.Ajax对象
这个对象被用作其他提供AJAX功能的类的根对象。Table12.Ajax对象
方法 | 类别 | 参数 | 描述 |
getTransport() | instance | (none) | 返回新的XMLHttpRequest对象。 |
4.13.Ajax.Base类
这个类是其他在Ajax对象中定义的类的基类。Table13.Ajax.Base类
方法 | 类别 | 参数 | 描述 |
setOptions(options) | instance | options: | 设定AJAX操作想要的选项。 |
responseIsSuccess() | instance | (none) | 返回true如果AJAX操作成功,否则为false。 |
responseIsFailure() | instance | (none) | 与responseIsSuccess()相反。 |
4.14.Ajax.Request类
继承自封装AJAX操作
Table14.Ajax.Request类
属性 | 类型 | 类别 | 描述 |
Events | Array | static | 在AJAX操作中所有可能报告的事件/状态的列表。这个列表包括:'Uninitialized','Loading','Loaded','Interactive',和'Complete'。 |
transport | XMLHttpRequest | instance | 携带AJAX操作的XMLHttpRequest对象。 |
方法 | 类别 | 参数 | 描述 |
[ctor](url,options) | constructor | url:请求的url,options:AJAX选项 | 创建这个对象的一个实例,它将在给定的选项下请求url。重要:如果选择的url受到浏览器的安全设置,他会一点作用也不起。很多情况下,浏览器不会请求与当前页面不同主机(域名)的url。你最好只使用本地url来避免限制用户配置他们的浏览器(谢谢Clay) |
request(url) | instance | url:AJAX请求的url | 这个方法通常不会被外部调用。已经在构造方法中调用了。 |
setRequestHeaders() | instance | (none) | 这个方法通常不会被外部调用。被这个对象自己调用来配置在HTTP请求要发送的HTTP报头。 |
onStateChange() | instance | (none) | 这个方法通常不会被外部调用。当AJAX请求状态改变的时候被这个对象自己调用。 |
respondToReadyState(readyState) | instance | readyState:状态数字(1到4) | 这个方法通常不会被外部调用。当AJAX请求状态改变的时候被这个对象自己调用。 |
4.15.options参数对象
AJAX操作中一个重要的部分就是options参数。本质上没有options类。任何对象都可以被传入,只要带有需要的属性。通常会只为了AJAX调用创建匿名类。Table16.options参数对象
属性 | 类型 | Default | 描述 |
method | Array | 'post' | HTTP请求方式。 |
parameters | String | '' | 在HTTP请求中传入的url格式的值列表。 |
asynchronous | Boolean | true | 指定是否做异步AJAX请求。 |
postBody | String | undefined | 在HTTPPOST的情况下,传入请求体中的内容。 |
requestHeaders | Array | undefined | 和请求一起被传入的HTTP头部列表,这个列表必须含有偶数个项目,任何奇数项目是自定义的头部的名称,接下来的偶数项目使这个头部项目的字符串值。例子:['my-header1','thisisthevalue','my-other-header','anothervalue'] |
onXXXXXXXX | Function(XMLHttpRequest) | undefined | 在AJAX请求中,当相应的事件/状态形成的时候调用的自定义方法。例如varmyOpts={onComplete:showResponse,onLoaded:registerLoaded};.这个方法将被传入一个参数,这个参数是携带AJAX操作的XMLHttpRequest对象。 |
onSuccess | Function(XMLHttpRequest) | undefined | 当AJAX请求成功完成的时候调用的自定义方法。这个方法将被传入一个参数,这个参数是携带AJAX操作的XMLHttpRequest对象。 |
onFailure | Function(XMLHttpRequest) | undefined | 当AJAX请求完成但出现错误的时候调用的自定义方法。这个方法将被传入一个参数,这个参数是携带AJAX操作的XMLHttpRequest对象。 |
insertion | Function(Object,String) | null | 为了把返回的文本注入到一个元素中而执行的方法。这个方法将被传入两个参数,要被更新的对象并且只应用于 |
evalScripts | Boolean | undefined,false | 决定当响应到达的时候是否执行其中的脚本块,只在 |
decay | Number | undefined,1 | 决定当最后一次响应和前一次响应相同时在 |
4.16.Ajax.Updater类
继承自当请求的url返回一段HTML而你想把它直接放置到页面中一个特定的元素的时候被用到。如果url的返回<script>的块并且想在接收到时就执行它的时候也可以使用该对象。含有脚本的时候使用evalScripts选项。
Table17.Ajax.Updater类
属性 | 类型 | 类别 | 描述 |
ScriptFragment | String | static | 可以判断是否为脚本的正则表达式。 |
containers | Object | instance | 这个对象包含两个属性:AJAX请求成功执行的时候用到containers.success,否则的话用到containers.failure。 |
方法 | 类别 | 参数 | 描述 |
[ctor](container,url,options) | constructor | container:可以是元素的id,也可以是元素自己,或者可以是带有2个属性的对象-object.successAJAX请求成功的时候用到的元素(或者id)否则用到object.failure中设定的元素(或id),url:请求的url,options: | 创建一个用给定的选项请求给定的url的一个实例。 |
updateContent() | instance | (none) | 这个方法通常不会被外部调用。当响应到达的时候,被这个对象自己调用。它会用HTML更新适当的元素或者调用在insertion选项中传入的方法-这个方法将被传入两个参数,被更新的元素和响应文本。 |
4.17.Ajax.PeriodicalUpdater类
继承自这个类重复生成并使用Ajax.Updater对象来刷新页面中的一个元素。或者执行Ajax.Updater可以执行的其它任务。更多信息参照
Table19.Ajax.PeriodicalUpdater类
属性 | 类型 | 类别 | 描述 |
container | Object | instance | 这个值将直接传入Ajax.Updater的构造方法。 |
url | String | instance | 这个值将直接传入Ajax.Updater的构造方法。 |
frequency | Number | instance | 两次刷新之间的间隔(不是频率),以秒为单位。默认2秒。This当调用Ajax.Updater对象的时候,这个数将和当前的decay相乘。 |
decay | Number | instance | 重负执行任务的时候保持的衰败水平。 |
updater | instance | 最后一次使用的Ajax.Updater对象 | |
timer | Object | instance | 通知对象该下一次更新时用到的JavaScript计时器。 |
方法 | 类别 | 参数 | 描述 |
[ctor](container,url,options) | constructor | container:可以是元素的id,也可以是元素自己,或者可以是带有2个属性的对象-object.successAJAX请求成功的时候用到的元素(或者id)否则用到object.failure中设定的元素(或id),url:请求的url,options: | 创建一个用给定的选项请求给定的url的一个实例。 |
start() | instance | (none) | 这个方法通常不会被外部调用。对象为了开始周期性执行任务的时候调用的方法。 |
stop() | instance | (none) | 这个方法通常不会被外部调用。对象为了停止周期性执行任务的时候调用的方法。 |
updateComplete() | instance | (none) | 这个方法通常不会被外部调用。被当前的Ajax.Updater使用,当一次请求结束的时候,它被用作计划下一次请求。 |
onTimerEvent() | instance | (none) | 这个方法通常不会被外部调用。当到下一次更新时被内部调用。 |
4.18.Element对象
这个对象提供在操作DOM中元素时使用的功能性方法。Table21.Element对象
方法 | 类别 | 参数 | 描述 |
toggle(elem1[,elem2[,elem3[...]]]) | constructor | elemN:元素对象或id | 切换每一个传入元素的可视性。 |
hide(elem1[,elem2[,elem3[...]]]) | instance | elemN:元素对象或id | 用设定它的style.display为'none'来隐藏每个传入的元素。 |
show(elem1[,elem2[,Slem3[...]]]) | instance | elemN:元素对象或id | 用设定它的style.display为''来显示每个传入的元素。 |
remove(element) | instance | element:元素对象或id | 从document对象中删除指定的元素。 |
getHeight(element) | instance | element:元素对象或id | 返回元素的offsetHeight。 |
addClassName(element,className) | instance | element:元素对象或id,className:CSS类名 | 向元素的类名中加入给定的类名。 |
hasClassName(element,className) | instance | element:元素对象或id,className:CSS类名 | 返回true如果元素的类名中含有给定的类名 |
removeClassName(element,className) | instance | element:元素对象或id,className:CSS类名 | 从元素的类名中删除给定的类名。 |
cleanWhitespace(element) | instance | element:元素对象或id | 删除该元素的所有只含有空格的子节点。 |
4.19.Abstract对象
这个对象是这个程序包中其他类的根。它没有任何属性和方法。在这个对象中定义的类可以被视为传统的抽象类。4.20.Abstract.Insertion类
这个类被用作其他提供动态内容插入功能的类的基类,它像一个抽象类一样被使用。Table22.Abstract.Insertion类
方法 | 类别 | 参数 | 描述 |
[ctor](element,content) | constructor | element:元素对象或id,content:被插入的HTML | 创建一个可以帮助插入动态内容的对象。 |
属性 | 类型 | 类别 | 描述 |
adjacency | String | static,parameter | 这个参数指定相对于给定元素,内容将被放置的位置。可能的值是:'beforeBegin','afterBegin','beforeEnd',和'afterEnd'. |
element | Object | instance | 与插入物做参照元素对象。 |
content | String | instance | 被插入的HTML。 |
4.21.Insertion对象
这个对象是其他类似功能的根。它没有任何属性和方法。在这个对象中定义的类仍然可以被视为传统的抽象类。4.22.Insertion.Before类
继承自在给定元素开始标记的前面插入HTML。
Table24.Insertion.Before类
方法 | 类别 | 参数 | 描述 |
[ctor](element,content) | constructor | element:元素对象或id,content:被插入的HTML | 继承自Abstract.Insertion.创建一个可以帮助插入动态内容的对象。 |
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>
<script>newInsertion.Before('person','Chief');</script>
将把HTML变为
<br>Hello,Chief<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>
4.23.Insertion.Top类
继承自在给定元素第一个子节点位置插入HTML。内容将位于元素的开始标记的紧后面。
Table25.Insertion.Top类
方法 | 类别 | 参数 | 描述 |
[ctor](element,content) | constructor | element:元素对象或id,content:被插入的HTML | 继承自Abstract.Insertion.创建一个可以帮助插入动态内容的对象。 |
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>
<script>newInsertion.Top('person','Mr.');</script>
将把HTML变为
<br>Hello,<spanid="person"style="color:red;">Mr.Wiggum.How'sitgoing?</span>
4.24.Insertion.Bottom类
继承自在给定元素最后一个子节点位置插入HTML。内容将位于元素的结束标记的紧前面。
Table26.Insertion.Bottom类
方法 | 类别 | 参数 | 描述 |
[ctor](element,content) | constructor | element:元素对象或id,content:被插入的HTML | 继承自Abstract.Insertion.创建一个可以帮助插入动态内容的对象。 |
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>
<script>newInsertion.Bottom('person',"What'sup?");</script>
将把HTML变为
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?What'sup?</span>
4.25.Insertion.After类
继承自在给定元素结束标记的后面插入HTML。
Table27.Insertion.After类
方法 | 类别 | 参数 | 描述 |
[ctor](element,content) | constructor | element:元素对象或id,content:被插入的HTML | 继承自Abstract.Insertion.创建一个可以帮助插入动态内容的对象。 |
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>
<script>newInsertion.After('person','Areyouthere?');</script>
将把HTML变为
<br>Hello,<spanid="person"style="color:red;">Wiggum.How'sitgoing?</span>Areyouthere?
4.26.Field对象
这个对象提供操作表单中的输入项目的功能性方法。Table28.Field对象
方法 | 类别 | 参数 | 描述 |
clear(field1[,field2[,field3[...]]]) | instance | fieldN:元素对象或id | 清除传入表单中项目元素的值。 |
present(field1[,field2[,field3[...]]]) | instance | fieldN:元素对象或id | 只有在所有的表单项目都不为空时返回true。 |
focus(field) | instance | fieldN:元素对象或id | 移动焦点到给定的表单项目。 |
select(field) | instance | fieldN:元素对象或id | 选择支持项目值选择的表单项目的值。 |
activate(field) | instance | fieldN:元素对象或id | 移动焦点并且选择支持项目值选择的表单项目的值。 |
4.27.Form对象
这个对象提供操作表单和他们的输入项目的功能性方法。Table29.Form对象
方法 | 类别 | 参数 | 描述 |
serialize(form) | instance | form:表单元素或id | 返回url参数格式的项目名和值的列表,如'field1=value1&field2=value2&field3=value3'。 |
getElements(form) | instance | form:表单元素或id | 返回包含所有在表单中输入项目的Array对象。 |
getInputs(form[,typeName[,name]]) | instance | form:表单元素或id,typeName:输入项目的类型,name:输入项目的名称 | 返回一个Array包含所有在表单中的<input>元素。另外,这个列表可以对元素的类型或名字属性进行过滤。 |
disable(form) | instance | form:表单元素或id | 使表单中的所有输入项目无效。 |
enable(form) | instance | form:表单元素或id | 使表单中的所有输入项目有效。 |
focusFirstElement(form) | instance | form:表单元素或id | 激活第一个表单中可视的,有效的输入项目。 |
reset(form) | instance | form:表单元素或id | 重置表单。和调用表单对象的reset()方法一样。 |
4.28.Form.Element对象
这个对象提供表单对象中的可视和非可视元素的功能性方法。Table30.Form.Element对象
方法 | 类别 | 参数 | 描述 |
serialize(element) | instance | element:表单元素或id | 返回元素的名称=值对,如'elementName=elementValue'。 |
getValue(element) | instance | element:表单元素或id | 返回元素的值。 |
4.29.Form.Element.Serializers对象
这个对象提供了内部使用的用来协助解析出表单元素的当前值功能性方法。Table31.Form.Element.Serializers对象
方法 | 类别 | 参数 | 描述 |
inputSelector(element) | instance | element:一个带有checked属性的表单元素或id,如radio或checkbox。 | 返回带有元素名称和值的Array,如['elementName','elementValue'] |
textarea(element) | instance | element:一个带有value属性的表单元素或id,如textbox,button或password项目。 | 返回带有元素名称和值的Array,如['elementName','elementValue'] |
select(element) | instance | element:一个<select>元素对象或id。 | 返回带有元素名称和所有被选择的选项的值或文本的Array,如['elementName','selOpt1selOpt4selOpt9'] |
4.30.Abstract.TimedObserver类
这个类是用于其它监听一个元素的值(或者任何类中涉及的属性)变化的类的基类,这个类像一个抽象类一样被使用。子类可以被创建来监听如输入项目值,或style属性,或表格的行数,或者其他任何对跟踪变化相关的东西。
子类必须实现这个方法来决定什么才是被监听的元素的当前值。
Table32.Abstract.TimedObserver类
方法 | 类别 | 参数 | 描述 |
[ctor](element,frequency,callback) | constructor | element:元素对象或id,frequency:以秒为单位的间隔,callback:当元素改变的时候调用的方法。 | 创建一个监听元素的对象。 |
registerCallback() | instance | (none) | 这个方法通常不会被外部调用。被这个对象自己调用来开始监听那个元素。 |
onTimerEvent() | instance | (none) | 这个方法通常不会被外部调用。被这个对象自己调用来周期性的检查那个元素。 |
属性 | 类型 | 描述 |
element | Object | 被监听的元素对象。 |
frequency | Number | 每次检查中的以秒为单位的时间间隔。 |
callback | Function(Object,String) | 只要元素改变这个方法就会被调用。会接收到元素对象和新值作为参数。 |
lastValue | String | 元素被核实的最后一个值。 |
4.31.Form.Element.Observer类
继承自Abstract.TimedObserver的一个实现类用来监听表单输入项目的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。否则的话使用
Table34.Form.Element.Observer类
方法 | 类别 | 参数 | 描述 |
[ctor](element,frequency,callback) | constructor | element:元素对象或id,frequency:以秒为单位的间隔,callback:当元素改变的时候调用的方法。 | 继承自Abstract.TimedObserver.创建一个监听元素值属性的对象。 |
getValue() | instance | (none) | 返回元素的值。 |
4.32.Form.Observer类
继承自Abstract.TimedObserver的一个实现类用来监听表单中任何数据项的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。否则的话使用类
Table35.Form.Observer类
方法 | 类别 | 参数 | 描述 |
[ctor](form,frequency,callback) | constructor | form:表单对象或id, | 继承自Abstract.TimedObserver.创建一个监听表单变化的对象。 |
getValue() | instance | (none) | 返回所有表单数据的一系列值。 |
4.33.Abstract.EventObserver类
这个类被用作其他一些类的基类,这些类具有在一个元素的值改变事件发生的时候执行一个回调方法这样的功能。类Abstract.EventObserver的多个对象可以绑定到一个元素上,不是一个帮其他的擦出了,而是按照他们付给元素的顺序执行这些回调方法。
单选按钮和复选框的触发事件是onclick,而文本框和下拉列表框/下拉列表框的是onchange。
子类必须实现这个方法来决定什么才是被监听的元素的当前值。
Table36.Abstract.EventObserver类
方法 | 类别 | 参数 | 描述 |
[ctor](element,callback) | constructor | element:元素对象或id,callback:当事件发生的时候调用的方法。 | 创建监听元素的对象。 |
registerCallback() | instance | (none) | 这个方法通常不会被外部调用。被对象调用来把自己绑定到元素的事件上。 |
registerFormCallbacks() | instance | (none) | 这个方法通常不会被外部调用。被对象调用来把自己绑定到表单中的每一个数据项元素的事件上。 |
onElementEvent() | instance | (none) | 这个方法通常不会被外部调用。将被绑定到元素的事件上。 |
属性 | 类型 | 描述 |
element | Object | 被监听的元素对象。 |
callback | Function(Object,String) | 只要元素改变就调用的方法。会接收到元素对象和新值作为参数。 |
lastValue | String | 元素被核实的最后一个值。 |
4.34.Form.Element.EventObserver类
继承自Abstract.EventObserver的一个实现类,它在监测到表单中数据项元素的值改变的相应事件时候执行一个回调方法。如果元素没有任何报告变化的事件,那么你可以使用
Table38.Form.Element.EventObserver类
方法 | 类别 | 参数 | 描述 |
[ctor](element,callback) | constructor | element:元素对象或id,callback:当事件发生的时候调用的方法。 | 继承自Abstract.EventObserver。创建一个监听元素值属性的对象。 |
getValue() | instance | (none) | 返回元素的值。 |
4.35.Form.EventObserver类
继承自Abstract.EventObserver的一个实现类,监听表单对象中包含的任何对象的任何变化,用元素的事件检测值的变化。如果元素没有任何报告变化的事件,那么你可以使用
Table39.Form.Element.EventObserver类
方法 | 类别 | 参数 | 描述 |
[ctor](form,callback) | constructor | form:元素对象或id,callback:当表单中任何数据项改变的时候调用的方法 | 继承自Abstract.EventObserver。创建一个监听元素值属性的对象。 |
getValue() | instance | (none) | 返回所有表单数据的一系列值。 |
4.36.Position对象(预备文档)
这个对象提供许多和元素位置相关的方法。Table40.Position对象(预备文档)
方法 | 类别 | 参数 | 描述 |
prepare() | instance | (none) | 调整deltaX和deltaY属性来协调在滚动位置中的变化。记得在页面滚动之后的任何调用的withinIncludingScrolloffset之前调用这个方法。 |
realOffset(element) | instance | element:对象或id | 返回这个元素的正确滚动偏差的Array对象,包括所有影响元素的滚动偏差。结果数组类似[total_scroll_left,total_scroll_top] |
cumulativeOffset(element) | instance | element:对象或id | 回这个元素的正确滚动偏差的Array对象,包含任何被放置的父元素强加偏差。结果数组类似[total_offset_left,total_offset_top] |
within(element,x,y) | instance | element:对象,x和y:一个点的坐标 | 测试给定的点的坐标是否在给定的元素的外部矩形范围之内。 |
withinIncludingScrolloffsets(element,x,y) | instance | element:object,xandy:coordinatesofapoint | |
overlap(mode,element) | instance | mode:'vertical'或'horizontal',element:对象 | 在调用这个方法之前需要调用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:元素对象或id,target:元素对象或id | 改变目标元素的大小尺寸和位置与源元素的相同。 |
相关文章推荐
- prototype.js开发参考手册(转贴)
- Prototype.js 1.4 中文开发手册
- 使用cordova+Ionic+AngularJs进行Hybird App开发的环境搭建手册
- web开发人员必备的提高开发水平的20个参考手册
- 100+个程序员开发必备参考手册(在线及下载)
- spring开发参考手册
- prototype.js 1.4版开发者手册
- prototype.js 1.4版开发者手册(强烈推荐)
- prototype.js 1.4版开发者手册(强烈推荐)
- 【转贴】扩展基于prototype的validation.js
- Prototype使用学习手册指南之ajax.js
- Prototype使用学习手册指南之Selector.js
- prototype.js开发笔记
- prototype.js开发详解【老外的网站】
- 《PL/SQL 语言开发参考手册》之七:SUB PROGRAM
- Cocos2d-x游戏开发之Lua 5.1 参考手册
- ajax:prototype.js很全的手册
- JBoss4 应用服务器Web开发人员参考手册(6):设置Web应用的Context Root
- prototype.js开发笔记
- prototype.js中文手册