`
bufanliu
  • 浏览: 200186 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

prototype.js简易教程手册1

阅读更多
1. Prototype是什么?
或许你还没有用过它, prototype.js 是一个由Sam Stephenson写的JavaScript包。这个构思奇妙编写良好的一段兼容标准的一段代码将承担创造胖客户端, 高交互性WEB应用程序的重担。轻松加入Web 2.0特性。

2. 通用性方法

这个程序包里面包含了许多预定义的对象和通用性方法。编写这些方法的明显的目的就是为了减少你大量的重复编码和惯用法。

2.1. 使用 $()方法
$() 方法是在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 onclick="test1();"><br>    <input type="button" value=Test2 onclick="test2();"><br></BODY></HTML>这个方法的另一个好处就是你可以传入id字符串或者元素对象自己,这使得在创建可以传入任何形式参数的方法的时候, 它变得非常有用。

2.2. 使用$F()方法
$F()方法是另一个非常受欢迎的简写。它可以返回任何输入表单控件的值,如文本框或下拉框。 这个方法可以传入元素的id或者元素自己。

<script>    function test3()    {        alert(  $F('userName')  );    }</script><input type="text" id="userName" value="Joe Doe"><br> <input type="button" value=Test3 onclick="test3();"><br>2.3. 使用Try.these()方法
Try.these() 方法使得实现当你想调用不同的方法直到其中的一个成功正常的这种需求变得非常容易, 他把一系列的方法作为参数并且按顺序的一个一个的执行这些方法直到其中的一个成功执行,返回成功执行的那个方法的返回值。

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

<script>function getXmlNodeValue(xmlNode){    return Try.these(        function() {return xmlNode.text;},        function() {return xmlNode.textContent;)        );}</script>3. Ajax 对象
上面提到的共通方法非常好,但是面对它吧,它们不是最高级的那类东西。它们是吗?你很可能自己编写了这些甚至在你的脚本里面有类似功能的方法。但是这些方法只是冰山一角。

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

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

3.1. 使用 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是非常简单的。下面的例子演示了它是如何完成的。

<script>    function searchSales()    {        var empID = $F('lstEmployees');        var y = $F('lstYears');        var url = 'http://yoursever/app/get_sales';        var pars = 'empID=' + empID + '&year=' + y;       var myAjax = new Ajax.Request(                    url,                    {method: 'get', parameters: pars, onComplete: showResponse}                    );    }    function showResponse(originalRequest)    {        //put returned XML in the textarea        $('result').value = originalRequest.responseText;    }</script><select id="lstEmployees" size="10" onchange="searchSales()">    <option value="5">Buchanan, Steven</option>    <option value="8">Callahan, Laura</option>    <option value="1">Davolio, Nancy</option></select><select id="lstYears" size="3" onchange="searchSales()">    <option selected="selected" value="1996">1996</option>    <option value="1997">1997</option>    <option value="1998">1998</option></select><br><textarea id=result cols=60 rows=10 ></textarea>你看到传入 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。

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

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

<script>    function getHTML()    {        var url = 'http://yourserver/app/getSomeHTML';        var pars = 'someParameter=ABC';         var myAjax = new Ajax.Updater('placeholder', url, {method: 'get', parameters: pars});    }</script><input type=button value=GetHtml onclick="getHTML()"><div id="placeholder"></div>你可以看到,这段代码比前面的例子更加简洁,不包括 onComplete 方法,但是在构造方法中传入了一个元素id。 我们来稍稍修改一下代码来描述如何在客户端处理服务器段错误成为可能。

我们将加入更多的选项, 指定处理错误的一个方法。这个是用 onFailure 选项来完成的。

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

<script>    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 onclick="getHTML()"><div id="placeholder"></div>如果你的服务器逻辑是返回JavaScript 代码而不是单纯的 HTML 标记, Ajax.Updater对象可以执行那段JavaScript代码。为了使这个对象对待响应为JavaScript,你只需在最后参数的对象构造方法中简单加入evalScripts: true属性。

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

4. prototype.js参考
4.1. JavaScript 类的扩展
prototype.js 包中加入功能的一种途径就是扩展已有的JavaScript 类。

4.2. 对 Object 类的扩展
Table 1. Object 类的扩展

方法 类别 参数 描述
extend(destination, source) static destination: 任何对象, source: 任何对象 用从 source 到 destination复制所有属性和方法的方式 来提供一种继承机制。
extend(object) instance 任何对象 用从传入的 object 中复制所有属性和方法的方式 来提供一种继承机制。

4.3. 对 Number 类的扩展
Table 2. Number 类的扩展

方法 类别 参数 描述
toColorPart() instance (none) 返回数字的十六进制描述, 当在HTML中转换为RGB颜色组件到HTML中使用的颜色。

4.4. 对 Function 类的扩展
Table 3. 对 Function 类的扩展

方法 类别 参数 描述
bind(object) instance object: 拥有这个方法的对象 返回预先绑定在拥有该函数(=方法)的对象上的函数实例, 返回的方法将和原来的方法具有相同的参数。
bindAsEventListener(object) instance object: 拥有这个方法的对象 返回预先绑定在拥有该函数(=方法)的对象上的函数实例, 返回的方法将把当前的事件对象作为它的参数。

让我们看看这些扩展的具体例子。

<input type=checkbox id=myChk value=1> Test?<script>    //declaring the class    var CheckboxWatcher = Class.create();    //defining the rest of the class implmentation    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>4.5. 对 String 类的扩展
Table 4. String 类的扩展

方法 类别 参数 描述
stripTags() instance (none) 返回一个把所有的HTML或XML标记都移除的字符串。
escapeHTML() instance (none) 返回一个把所有的HTML标记回避掉的字符串。
unescapeHTML() instance (none) 和 escapeHTML()相反。

4.6. 对 document DOM 对象的扩展
Table 5. document DOM 对象的扩展

方法 类别 参数 描述
getElementsByClassName(className) instance className: 关联在元素上的CSS类名 返回给定的具有相同的CSS类名的所有元素。

4.7. 对 Event 对象的扩展
Table 6. 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 缓存的观察者的列表,这个对象内部具体实现的一部分。

Table 7. Event 对象的扩展

方法 类别 参数 描述
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) 私有方法,不用管它。清除内存中的多有观察着缓存。

让我们看看怎样用这个对象加入处理 window 对象的load事件的处理方法。

<script>    Event.observe(window, 'load', showMessage, false);    function showMessage() {      alert('Page loaded.');    }</script>4.8. 在 prototype.js中定义的新对象和类
另一个这个程序包帮助你的地方就是提供许多既支持面向对象设计理念又有共通功能的许多对象。

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

Table 8. PeriodicalExecuter 对象

方法 类别 参数 描述
[ctor](callback, interval) constructor callback: 没有参数的方法, interval: 秒数 创建这个对象的实例将会重复调用给定的方法。

Table 9. PeriodicalExecuter 对象

属性 类型 描述
callback Function() 被调用的方法,该方法不会被传入参数。
frequency Number 以秒为单位的间隔。
currentlyExecuting Boolean 表示这个方法是否正在执行。

4.10. Prototype 对象
Prototype 没有太重要的作用,只是声明了该程序包的版本 。

Table 10. The Prototype object

属性 类型 描述
Version String 包的版本。
emptyFunction Function() 空方法对象。

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

看下面的例子

//declaring the classvar MySampleClass = Class.create();//defining the rest of the class implmentationMySampleClass.prototype = {   initialize: function(message) {        this.message = message;   },   showMessage: function(ajaxResponse) {      alert(this.message);   }};//now, let's instantiate and use one objectvar myTalker = new MySampleClass('hi there.');myTalker.showMessage(); //displays alertTable 11. Class 对象

方法 类别 参数 描述
create(*) instance (any) 定义新类的构造方法。

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

Table 12. Ajax 对象

方法 类别 参数 描述
getTransport() instance (none) 返回新的XMLHttpRequest 对象。

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

Table 13. Ajax.Base 类

方法 类别 参数 描述
setOptions(options) instance options: AJAX 选项 设定AJAX操作想要的选项。
responseIsSuccess() instance (none) 返回 true 如果AJAX操作成功,否则为 false 。
responseIsFailure() instance (none) 与 responseIsSuccess() 相反。

4.14. Ajax.Request 类
继承自 Ajax.Base

封装 AJAX 操作

Table 14. Ajax.Request 类

属性 类型 类别 描述
Events Array static 在AJAX操作中所有可能报告的事件/状态的列表。这个列表包括: 'Uninitialized', 'Loading', 'Loaded', 'Interactive', 和 'Complete'。
transport XMLHttpRequest instance 携带AJAX操作的 XMLHttpRequest 对象。

Table 15. Ajax.Request 类

方法 类别 参数 描述
[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请求状态改变的时候被这个对象自己调用。
分享到:
评论

相关推荐

    prototype.js 1.6中文手册、prototype.js 1.6英文手册、

    通过阅读Prototype.js 1.6的中文和英文手册,开发者可以深入了解其用法和背后的原理,提高JavaScript编程效率,创建更具交互性和动态性的网页应用。"prototypeAPI"这个文件可能包含了Prototype.js的API参考文档,是...

    prototype.js中文手册

    **《prototype.js中文手册》详解** Prototype.js 是一个开源JavaScript库,由Sam Stephenson于2005年创建,主要用于简化DOM(文档对象模型)操作,增强JavaScript的面向对象编程能力,以及提供实用的函数扩展。它在...

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

    《prototype.js 1.4版开发者手册》是JavaScript开发领域中的一个重要参考资料,尤其对于那些希望深入理解并利用Prototype库的开发者来说,它是一份不可多得的资源。Prototype.js是一个强大的JavaScript库,由Sam ...

    prototype.js文件使用和讲解

    **prototype.js 文件详解** 在JavaScript中,`prototype`是一个核心概念,它关乎对象的继承机制。...记得结合`prototype.js`开发手册,深入学习并熟练掌握其各种用法,提升你的JavaScript开发技能。

    prototype_1.7.3.js 最新版本

    《prototype_1.7.3.js:JavaScript框架的里程碑》 在JavaScript的世界里,Prototype库是一个不可或缺的重要组成部分,尤其在Web开发领域,它为开发者提供了强大的功能和便利性。Prototype_1.7.3.js是这个库的一个...

    prototype.js

    《prototype.js:JavaScript框架的核心与应用》 在Web开发领域,JavaScript库和框架极大地提高了开发效率,其中Prototype.js就是一款非常流行的开源JavaScript框架。本文将深入探讨Prototype.js的核心概念、功能...

    prototype.js简介

    1. **面向对象编程** - prototype.js 引入了类的概念,使得JavaScript支持类式的继承。它通过`Class.create()`方法创建类,通过`Object.extend()`方法实现对象的继承。此外,还提供了`prototype`属性来扩展类的行为...

    prototype.js 1.4-1.6[全]

    《Prototype.js 1.4-1.6:JavaScript 动态原型框架的探索与实践》 Prototype.js 是一个广泛使用的JavaScript库,它扩展了JavaScript语言的功能,为开发人员提供了更强大的面向对象编程支持。该库的核心特性是其对...

    prototype.js_v1.6_含中英文手册

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

    prototype.js javaScript插件

    "Prototype.js"是一个针对JavaScript的开源库,旨在增强和扩展JavaScript的基本功能,尤其在处理DOM(文档对象模型)操作、事件处理以及Ajax交互时提供了极大的便利。 ### 1. Prototype.js核心概念 - **原型链**:...

    prototype.js 1.6

    《Prototype.js 1.6:JavaScript 动态对象增强库的深度解析》 Prototype.js 是一个广泛使用的 JavaScript 库,它为浏览器环境提供了许多实用的功能,尤其是在对象操作和事件处理方面。1.6 版本是该库的一个重要里程...

    prototype.js开发者手册

    《prototype.js开发者手册》是针对JavaScript库Prototype的一份详尽指南,旨在帮助开发者深入理解和有效利用这个强大的工具。Prototype.js是开源的JavaScript框架,它扩展了JavaScript的基本对象,提供了类和面向...

    PROTOTYPE.JS1.4版开发者手册

    资源名称:PROTOTYPE.JS 1.4版开发者手册内容简介:prototype.js 是什么?万一你没有使用过大名鼎鼎的prototype.js,那么让我来告诉你,prototype.js是由Sam Stephenson写的一个javascript类库。这个构思奇妙,...

    prototype.js开发手册

    **Prototype.js 开发手册** Prototype.js 是一个广泛使用的 JavaScript 库,它为浏览器环境提供了许多实用的功能,极大地简化了 JavaScript 的开发。这个库的核心理念是扩展JavaScript的基本对象和类型,使其更加...

    prototype.js开发手册.pdf

    《prototype.js开发手册》是关于JavaScript库Prototype的详细指南,旨在帮助开发者更好地理解和利用这个强大的工具。Prototype由Sam Stephenson创建,它提升了JavaScript的基础功能,为Web开发提供了更丰富的功能和...

    prototype.js 实例

    在JavaScript的世界里,Prototype.js是一个著名的库,它扩展了JavaScript的内置对象,为开发者提供了更加便利的编程体验。本实例将深入探讨如何利用Prototype.js来实现弹出窗口和移动窗口的功能,这对于创建交互性强...

    Prototype.js 1.6.0.3 及中文CHM帮助文档

    Prototype.js 是一个广泛使用的JavaScript库,它为JavaScript编程提供了丰富的功能和便利,旨在简化和优化在浏览器环境中进行的脚本编写。1.6.0.3 版本是该库的一个稳定版本,它包含了对先前版本的改进和修复,以...

    prototype.js手册

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

Global site tag (gtag.js) - Google Analytics