RequireJS 2.0 API 中文指南

"这篇文档详细介绍了RequireJS 2.0 API的使用方法和高级功能，包括模块定义、配置选项以及各种场景下的应用。RequireJS是一个JavaScript模块加载器，旨在促进代码的模块化和优化加载效率。它通过非传统的方式来加载JS文件，并提供了丰富的配置和插件支持。" RequireJS的核心概念是模块化，它使用`define`函数来定义模块，通过`require`函数来加载模块。以下是关键知识点的详细说明： 1. **定义模块**： - **简单键值对**：`define(id?, dependencies?, factory)`，其中`id`是可选的模块标识符，`dependencies`是模块依赖的数组，`factory`是创建模块的函数或对象。 - **函数定义**：如果`factory`是函数，它可以接收依赖的模块作为参数，执行后返回模块的值。 - **带依赖的函数**：可以指定依赖的其他模块，RequireJS会按需加载并传递给工厂函数。 - **CommonJS包装器**：对于兼容CommonJS风格的模块，可以通过包装器进行定义。 2. **数据主入口点**：`data-main`属性用于指定应用程序的入口脚本，通常设置在`require.js`加载的`<script>`标签上。 3. **循环依赖**：RequireJS可以处理循环依赖的情况，通过延迟计算直到所有依赖都准备就绪。 4. **配置选项**： - `baseUrl`：基础URL，用于解析模块ID。 - `paths`：配置模块路径，可以指定每个模块的完整或相对路径。 - `shim`：用于处理非AMD兼容的库，提供依赖和出口的配置。 - `paths config fallbacks`：配置路径的备选方案，当模块不存在时，尝试加载其他路径的模块。 5. **高级用法**： - **从包中加载模块**：通过配置`bundles`，可以批量加载一组模块。 - **多版本支持**：通过配置多个`paths`，可以同时支持不同版本的库。 - **页面加载完成后加载代码**：使用`onLoad`或监听`window.onload`事件来确保代码在DOM准备就绪后执行。 - **WebWorker支持**：在WebWorker环境中使用RequireJS加载代码。 - **Rhino支持**：在非浏览器环境（如Rhino）中运行RequireJS。 - **错误处理**：通过`requirejs.onError`全局函数处理加载失败，或使用`require([...], errback)`中的`errback`回调。 6. **加载器插件**：允许扩展RequireJS的功能，如加载文本文件、CSS等非JavaScript资源。 7. **I18n支持**：定义多语言捆绑，便于实现国际化。 8. **页面加载事件/DOM就绪**：可以监听DOM加载完成事件，确保代码在适当的时候执行。 RequireJS 2.0 API提供了一套强大且灵活的工具，帮助开发者组织和管理JavaScript代码，实现模块化的开发模式，提升代码的可维护性和性能。通过合理配置和使用，可以有效地解决项目中遇到的加载和依赖管理问题。