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

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

<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
         
      
        
       
This is a paragraph
    
      
    
      
        
       
This is another paragraph
    
      
    
      
      
    
      
      

     

这个方法的另一个好处就是你可以传入id字符串或者元素对象自己，这使得在创建可以传入任何形式参数的方法的时候， 它变得非常有用。

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

<script>    function test3()    {        alert(  $F('userName')  );    }</script>
 

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

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

<script>function getXmlNodeValue(xmlNode){    return Try.these(        function() {return xmlNode.text;},        function() {return xmlNode.textContent;)        );}</script>

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

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

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

     
         
              
                   
                        
         
          1234
                         
         
          1998-01
                         
         
          $8,115.36
                     
                    
                        
         
          1234
                         
         
          1998-02
                         
         
          $11,147.51
                     
                
           
      
     

用 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>Buchanan, StevenCallahan, LauraDavolio, Nancy199619971998

你看到传入 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选项参考。

如果你的服务器的另一端返回的信息已经是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>
     

你可以看到，这段代码比前面的例子更加简洁，不包括 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>
     

如果你的服务器逻辑是返回JavaScript 代码而不是单纯的 HTML 标记， Ajax.Updater对象可以执行那段JavaScript代码。为了使这个对象对待响应为JavaScript，你只需在最后参数的对象构造方法中简单加入evalScripts: true属性。

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

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

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

 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>

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

<script>    Event.observe(window, 'load', showMessage, false);    function showMessage() {      alert('Page loaded.');    }</script>

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

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

Prototype 没有太重要的作用，只是声明了该程序包的版本 。

在这个程序包中 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 alert

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

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

继承自 Ajax.Base

封装 AJAX 操作

AJAX操作中一个重要的部分就是 options 参数。 本质上没有options类。任何对象都可以被传入，只要带有需要的属性。通常会只为了AJAX调用创建匿名类。

继承自 Ajax.Request

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

继承自 Ajax.Base

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

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

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

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

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

继承自 Abstract.Insertion

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

下面的代码

Hello, Wiggum. How's it going?