prototype-151-api

### Prototype 1.5.1 API 全面参考 #### 概述 Prototype 是一个 JavaScript 框架，旨在简化动态 Web 应用程序的开发。该框架由 Sam Stephenson 创建，并于 2005 年 2 月作为开源项目发布。Prototype 的核心团队还包括 Thomas Fuchs、Justin Palmer、Andrew Dupont、Dan Webb、Scott Raymond、Seth Dillingham、Mislav Marohnić、Christophe Porteneuve 和 Tobie Langel。 #### 版权声明与许可 本 PDF 版本的 Prototype API 参考手册由 Josh Clark 创建，但所有内容均来自 Prototype 官方网站，其知识产权归 Sam Stephenson 和 Prototype 核心团队所有。此 PDF 根据 Creative Commons Attribution-ShareAlike 2.5 许可证分发。 #### 内容概览 本参考手册包含了 Prototype 1.5.1 的所有 API 方法和类的详细介绍，分为以下几个部分： 1. **Utility Methods（工具方法）** 2. **Ajax** 3. **Array** 4. **Class** 5. **Date** 6. **Element** 下面将逐一介绍这些部分中的重要知识点。 #### Utility Methods 工具方法 - **$**：选择器，用于获取 DOM 元素。 - **$$**：多选择器，可以传入多个选择器字符串，返回匹配的所有元素的数组。 - **$A**：转换为数组，可以把类数组对象转换为真正的数组。 - **$F**：获取表单域的值，等同于 `element.value`。 - **$H**：创建哈希对象，返回一个包含键值对的对象。 - **$R**：创建范围，返回一个从开始值到结束值的数组。 - **$w**：单词数组，把字符串分割成数组，每个单词为数组的一个元素。 - **Try**：执行函数列表，直到其中一个函数成功执行或所有函数都尝试过为止。 - **document.getElementsByClassName**：返回带有指定类名的所有元素的 Node 列表。 #### Ajax - **AjaxOptions**：Ajax 请求配置选项。 - **Ajax.PeriodicalUpdater**：周期性更新请求，用于周期性地执行 AJAX 请求并更新页面内容。 - **Ajax.Request**：执行 AJAX 请求的核心方法，用于向服务器发送请求并处理响应。 - **Ajax.Responders**：响应处理器，用于注册和触发 AJAX 请求的响应处理程序。 - **Ajax.Updater**：更新器，用于执行 AJAX 请求并将响应内容插入到指定的 DOM 元素中。 #### Array 数组 - **clear**：清空数组。 - **clone**：复制数组。 - **compact**：压缩数组，移除数组中的空值。 - **each**：遍历数组中的每一个元素，并执行指定的操作。 - **first**：返回数组的第一个元素。 - **flatten**：扁平化数组，将多维数组转换为一维数组。 - **from**：创建数组。 - **indexOf**：查找数组中第一个匹配的元素的索引位置。 - **inspect**：返回数组的字符串表示形式。 - **last**：返回数组的最后一个元素。 - **reduce**：对数组中的元素执行操作，将它们减少为单个值。 - **reverse**：反转数组中的元素顺序。 - **size**：返回数组的长度。 - **toArray**：转换为数组。 - **toJSON**：将数组转换为 JSON 字符串。 - **uniq**：去重，移除数组中的重复项。 - **without**：从数组中删除指定的元素。 #### Class 类 - **create**：创建新的类。允许通过继承已有类来定义新类，并可以添加新的方法。 #### Date 日期 - **toJSON**：将日期对象转换为 JSON 字符串格式。 #### Element 元素 - **addClassName**：向元素添加类名。 - **addMethods**：向元素添加方法。 - **ancestors**：返回元素的所有祖先节点。 - **childElements**：返回元素的所有子元素。 - **classNames**：返回元素的类名列表。 - **cleanWhitespace**：清理空白字符，移除元素内部的空白字符。 - **descendantOf**：检查元素是否是另一个元素的后代。 - **descendants**：返回元素的所有后代节点。 - **down**：获取元素的子元素。 - **empty**：清空元素，移除元素内的所有子节点。 - **extend**：扩展元素，为元素添加新方法。 - **firstDescendant**：返回元素的第一个后代元素。 - **getDimensions**：获取元素的尺寸信息。 - **getElementsByC**：根据指定条件获取元素的子元素。 以上是对 Prototype 1.5.1 API 参考手册中的主要知识点进行了详细的介绍，可以帮助开发者更好地理解和使用这个框架。