只是书写和调试时的规范!!!构建后的代码完全不需要遵循下面的约定!!!!!!
模块 factory 构造方法的第一个参数 必须 命名为 require
。
// 错误!define(function(req) { // ...});// 正确!define(function(require) { // ...});
不要重命名 require
函数,或在任何作用域中给 require
重新赋值。
// 错误 - 重命名 "require"!var req = require, mod = req("./mod");// 错误 - 重定义 "require"!require = function() {};// 错误 - 重定义 "require" 为函数参数!function F(require) {}// 错误 - 在内嵌作用域内重定义了 "require"!function F() { var require = function() {}; }
require
的参数值 必须 是字符串直接量。
// 错误!require(myModule);// 错误!require("my-" + "module");// 错误!require("MY-MODULE".toLowerCase());// 正确!require("my-module");
在书写模块代码时,必须遵循这些规则。其实只要把 require
看做是语法关键字 就好啦。
有时会希望可以使用 require
来进行条件加载:
if (todayIsWeekend) require("play");else require("work");
但请牢记,从静态分析的角度来看,这个模块同时依赖 play 和 work 两个模块,加载器会把这两个模块文件都下载下来。 这种情况下,推荐使用 require.async
来进行条件加载。
这些约定初看起来会有些小不爽,其实也的确可以通过每次都编译的方式来去掉这些限制。但编译的方式,会给开发调试带来麻烦,代码的实现复杂度也会增加。Sea.js 的核心设计原则是保持简单,遵循 New Jersey Approach:
简单性:设计必须简单,这既是对实现的要求,也是对接口的要求。实现的简单要比接口的简单更加重要。简单是设计中需要第一重视的因素。
因为简单,所以可靠!