<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head id="Head"><title>
prototype.js 1.4版开发者手册
</title>
<body>
<form name="Form1" method="post" action="DeveloperNotesForPrototype.html" onsubmit="javascript:return WebForm_OnSubmit();" id="Form1">
<script type="text/javascript">
<!--
var theForm = document.forms['Form1'];
if (!theForm) {
theForm = document.Form1;
}
function __doPostBack(eventTarget, eventArgument) {
if (!theForm.onsubmit || (theForm.onsubmit() != false)) {
theForm.__EVENTTARGET.value = eventTarget;
theForm.__EVENTARGUMENT.value = eventArgument;
theForm.submit();
}
}
// -->
</script>
<script src="/WebResource.axd?d=PyW-m2hLmppJ9byT1bYEqw2&t=632767537230403380" type="text/javascript"></script>
<script language=JavaScript>
function ctlent(evt)
{
if(evt.ctrlKey && evt.keyCode == 13)
{
try
{
TempSave('AnonymousPostComment1_tbComment');
}
catch(ex)
{
}
finally
{
__doPostBack('AnonymousPostComment1$btnSubmit','')
}
}
}</script>
<script language=JavaScript>function SetReplyAuhor(author){document.getElementById('AnonymousPostComment1_tbComment').value+="@"+author+"\n";document.getElementById('AnonymousPostComment1_tbComment').focus();return false}</script>
<script src="/WebResource.axd?d=PN3YVKw-Ky20FbAsNYS9UM8XqUzPcwpd0&t=632767537230403380" type="text/javascript"></script>
<script type="text/javascript">
<!--
function WebForm_OnSubmit() {
if (typeof(ValidatorOnSubmit) == "function" && ValidatorOnSubmit() == false) return false;
return true;
}
// -->
</script>
<h2>对应版本1.4.0 </h2>
<div>original article by sp('Sergio Pereira') <a href="mailto:sergio_pereira@msn.com">Sergio Pereira</a></div>
<div>
<p>last update: March 30th 2006</p>
<p>中文版：<a href="mailto:thin37421@126.com">THIN</a></p>
<p>最后更新：2006-3-31</p>
</div>
<!-- Translators: check out the file prot-changeLogs.html in this same directory for the diff files. -->
<p><span style="FONT-SIZE: 10pt; COLOR: #008000">看到一个很好的东西在国内没有被很多人使用起来，实在是不爽，所以花了很大功夫把这个手册翻译成中文，<span style="COLOR: red">由于这篇文章很长，所以，翻译的工作量很大而且有些地方英文版也没有说清楚，虽得查看源代码，好在不是坚持做完了，大家鼓励下啊！^</span>o^<br>prototype.js是一个非常优雅的javascript基础类库，对javascript做了大量的扩展，而且很好的支持Ajax，国外有多个基于此类库实现的效果库，也做得很棒。<br>prototype.js不仅是一个有很大实用价值的js库，而且有很高的学习价值，所以我强烈建议B/S开发人员和对JS开发感兴趣的朋友去浏览一些它的源代码，其中有很多的珠玑，你绝对会觉得读它的源代码是一种享受，当然要读得懂，呵呵。<br>网上也有人写过1.3版的源码解读，大家可以找来看看。不过1.4版做了很大的扩充，所以希望有朋友写出1.4版的源码解读。</span><br><span style="COLOR: red">几点说明：
<ul>
<li>有朋友说prototye已经有人翻译过了，呵呵，是对的，说明你以前关注过它，不过原来翻译的是1.3版的文档，1.4版有很多重要的扩展，而且pre_1.5版现在也出来，不地改动不大。
<li>有朋友说有用多没有翻译地来的，拜托，只是各个方法的参数说明没有翻，这些说明很多都是什么类型，还是有空再弄吧，先将就一下，对不起了，翻到这个程序已经很累人了，毕竟有这么长。
<li>做成CHM文档的事也只能Sorry，因为我没有这个时间，也没有做过CHM，我觉得排版一下看网页和CHM是差不多吧。 </li>
</ul>
</span>
<p> </p>
<h3>prototype.js是什么?</h3>
<p>万一你没有使用过大名鼎鼎的prototype.js，那么让我来告诉你，<a href="http://prototype.conio.net/">prototype.js</a>是由<a href="http://www.conio.net/">Sam Stephenson</a>写的一个javascript类库。这个构思奇妙，而且兼容标准的类库，能帮助你轻松建立有高度互动的web2.0特性的富客户端页面。</p>
<p>如果你最近尝试使用它，你大概了解到文档并不是作者的一个强项。和在我以前使用这个类库的不少开发者一样，一开始，我不得不一头扎进阅读prototype.js的源代码和实验它的功能中。我想，在我学习完它之后，把我学到的东西分享给大家是件不错的事。 </p>
<p>同时，在本文中，我也将提供一个关于这个类库提供的objects,classes,functions,extensions这对东东的<a href="#Reference">非官方参考</a></p>
<p>在阅读这个文档时，熟悉Ruby的开发者将会注意到Ruby的一些内建类和本类库扩展实现之间非常相似。 </p>
<h3>相关文章</h3>
<p>Advanced <a href="http://www.sergiopereira.com/articles/advjs.html">JavaScript guide</a>. </p>
<!-- ************************************************************************************************************************************* -->
<h3>一些实用的函数</h3>
<p>这个类库带有很多预定义的对象和实用函数，这些东东的目的显然是把你从一些重复的打字中解放出来 。 </p>
<!-- ------------------------------------------------------------------------------------------- -->
<h4>使用$()方法</h4>
<p>$() 方法是在DOM中使用过于频繁的 document.getElementById() 方法的一个便利的简写，就像这个DOM方法一样，这个方法返回参数传入的id的那个元素。</p>
<p>比起DOM中的方法，这个更胜一筹。你可以传入多个id作为参数然后 $() 返回一个带有所有要求的元素的一个 Array 对象。</p>
<pre class=programlisting><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></pre>
<p>另外一个好处是，这个函数能传入用string表示的对象ID，也可以传入对象本身，这样，在建立其它能传两种类型的参数的函数时非常有用。</p>
<!-- ------------------------------------------------------------------------------------------- -->
<h4>使用$F()函数</h4>
<p>$F()函数是另一个大收欢迎的“快捷键”，它能用于返回任何表单输入控件的值，比如text box,drop-down list。这个方法也能用元素id或元素本身做为参数。 </p>
<pre class=code><script>
function test3()
{
alert( <span class=highlite>$F('userName')</span> );
}
</script>
<input type="text" id="userName" value="Joe Doe"><br>
<input type="button" value=Test3 onclick="test3();"><br>
<!-- ------------------------------------------------
