超简单组织AngularJS模块

去年下半年接触前端开发和AngularJS,一路跌跌撞撞,尤以模块化代码组织的教训最深刻。

最开始代码量小也没经验,直接在html引用所有js文件。后来搞得html文件越来越大,js的顺序一乱,就报奇奇怪怪的错误,找半天。

第二个项目,我就想着要改进,直奔声名显赫的RequireJS去了。但RequireJS真的很麻烦有木有!平添了许多代码,和AngularJS的Dependency Injection长得还挺像,一不小心就搞混。时不时报个Script Error出来,根本不知道问题在哪里。

有没有更简单的方法呢?正想着呢,ng-newsletter一声炮响,送来了这篇文章。作者Jeff Dickey介绍了用模块来组织代码的四种方法,依照推荐程度,依次为:

  • Require.js (Implementation of AMD)
  • Browserify (Implementation of CommonJS)
  • Angular dependency injection
  • ES6 modules

作者着重写了在第三种基础上,组织代码的简化方法(捂脸,我才用到第一种)。

模块的功用,首先是要隔离命名空间。Angular的模块机制很好地解决了。除了angular这个对象本身,没有任何暴露在Global里的对象。

然后是处理依赖关系。Angular的模块同样指定了依赖关系,而Dependency Injection在更细的粒度上做了类似的事。

更棒的是,Angular模块的定义顺序可以随便。各个service、controller、directive注册到模块的顺序,也没有限制。唯一的要求只是:模块要先定义,后使用。请看下面的例子:

// 模块可以按任意的顺序定义
angular.module('app', ['ctrl']);
angular.module('ctrl', ['svc']);
angular.module('svc', []);

// 使用尚未注册的GithubSvc
angular.module('ctrl')
.controller('GithubCtrl', function ($scope, GithubSvc) {
  GithubSvc.fetchStories().success(function (users) {
    $scope.users = users;
  });
});

angular.module('svc')
.factory('GithubSvc', function ($http) {
  return {
    fetchStories: function () {
      return $http.get('https://api.github.com/users');
    }
  };
});

可运行的代码在这个jsFiddle

Angular没有帮我们解决的,就剩下文件加载了。既然加载顺序无关紧要,那直接把文件合并起来不就好了?反正最终都要合并的。

gulp.task('js', function () {
  gulp.src(['src/**/module.js', 'src/**/*.js'])
    .pipe(concat('app.js'))
    .pipe(gulp.dest('.'))
})

无论是按业务还是按功能划分目录,只要把每个模块的定义都放在目录下的module.js里,保证所有模块在使用之前都已经定义过了,直接concat毫无问题。html里却只有一行:

<script src="app.js"></script>

编写、测试还是按模块分目录和文件,代码组织清晰利落。拼接到一起在浏览器上跑。发布时,再ngAnnotateuglify一下就好。

库的代码,再拼出一个vender.js就行了。gulp-bower-files这个插件,可以分析bower.json,把依赖的每个库里的main属性组合起来,创建gulp.src()

gulp.task('vendor', function () {
  gulpBowerFiles()
    .pipe(concat('vendor.js'))
    .pipe(gulp.dest('.'))
})

每次手工gulp js不方便?gulp watch起来。

gulp.task('watch', ['js'], function () {
  gulp.watch('src/**/*.js', ['js'])
})

当然,这些都是权宜之计,因为传说中的ES6和Angular 2.0,将搞定这些问题。不过在此之前,不妨试试这个超简单的方法咯。

[补充]

  1. gulp-bower-files已被main-bower-files取代。
  2. moduleconfig阶段是有顺序依赖的。比如,要定义route里的controller,就要求该controller必须存在。
    原文作者:梦林
    原文地址: https://www.jianshu.com/p/2c93f354d909
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞