首页 > 代码库 > 基于requirejs和angular搭建spa应用

基于requirejs和angular搭建spa应用

  接上篇,angular 实战部分,angular比较适合spa项目,这里不借助任何seed和构建工具,直接从零搭建,基本的angular项目结构大致包含如下几个部分:
  1)app.js 入口

  2)index.html html框架页

  3)lib(vendor)第三方类库

  4)components 业务组件

  5)styles/images 静态资源部分

1、常规实现

  创建文件夹demo1,按照上述结构分别创建app.js ,index.html文件,创建lib、components、styles和images文件夹,最终如下图所示:

技术分享

在此基础上,我们增加三个业务组件home,about,contact,并初始化基本代码如下:

技术分享

核心代码文件

index.html

 1 <!DOCTYPE html> 2 <html lang="en" ng-app="app"> 3 <head> 4     <meta charset="UTF-8"> 5     <meta name="viewport" content="width=device-width, initial-scale=1.0"> 6     <meta http-equiv="X-UA-Compatible" content="ie=edge"> 7     <title>demo1</title> 8     <script src="https://cdn.bootcss.com/angular.js/1.6.0/angular.js"></script> 9     <script src="https://cdn.bootcss.com/angular-ui-router/1.0.3/angular-ui-router.js"></script>10 11     <script src=‘./app.js‘></script>12     <script src=‘./components/home/home.controller.js‘></script>13     <script src=‘./components/about/about.controller.js‘></script>14     <script src=‘./components/contact/contact.controller.js‘></script>15 16 </head>17 <body>18     <div class="nav">19         <ul>20             <li><a ui-sref="home">Home</a></li>21             <li><a ui-sref="about">About</a></li>22             <li><a ui-sref="contact">Contact</a></li>23         </ul>24     </div>25     <div class="container">26         <div ui-view></div>27     </div>28 </body>29 </html>

app.js

 1 angular.module(‘app‘, [‘ui.router‘]) 2     .config([‘$stateProvider‘, ‘$urlRouterProvider‘, function ($stateProvider, $urlRouterProvider) { 3         //默认指向 4         $urlRouterProvider.otherwise(‘/home‘); 5  6         $stateProvider.state(‘home‘, { 7             url: ‘/home‘, 8             templateUrl: ‘./components/home/home.tpl.html‘, 9             controller: ‘HomeController‘,10             controllerAs: ‘vm‘11 12         }).state(‘about‘, {13             url: ‘/about‘,14             templateUrl: ‘./components/about/about.tpl.html‘,15             controller: ‘AboutController‘,16             controllerAs: ‘vm‘17         }).state(‘contact‘, {18             url: ‘/contact‘,19             templateUrl: ‘./components/contact/contact.tpl.html‘,20             controller: ‘ContactController‘,21             controllerAs: ‘vm‘22         })23 24     }])

controller中文件格式一直,tpl为view文件以home模块为例:

home.controller.js

1 angular.module(‘app‘)2     .controller(‘HomeController‘, HomeController);3 4 HomeController.$inject = [‘$scope‘];5 6 function HomeController($scope) {7     console.log("HomeController created successfully!!!");8 }

home.tpl.html

<h2>Page Home</h2>

对命名做如下规定,所有文件夹都用小写,多词用点号隔开,所有文件都小写,多词用点号分割,控制器以.controller.js结尾,类似的有.service.js,.tpl.html,.directive.js,.filter.js等。

最终运行效果如下:

技术分享

上述代码能正常运行,但是我们发现一个问题,当前js文件或者说模块较少,我们引入不会有很大的问题,但是当我们的应用变得很大,文件几十甚至上百个,如何处理呢,有人说当然使用构建工具了,一个一个引入多慢呢,构建工具当然可以做到批量引入js文件,但是我们还需要考虑按需加载的问题,举例来说,我们在打开home的时候,about和contact是没必要加载的,但是按照我们传统的模式,所有脚本都完成了加载,这首先增加了http请求次数,脚本过多的加载解析也影响浏览器的渲染,用户体验并不友好,基于此,我们有几种方式来实现,1、基于requirejs来做,这也是本章内容要讲的部分;2、使用webpack分块打包,实现按需加载,后期看时间会加入对应的文章;3、使用oclazyload(可自行google)。本文就以requirejs来实现一下业务模块的按需加载,在此之前首先引入requirejs。

2、引入Requirejs

  RequireJS 是一个JavaScript模块加载器。它非常适合在浏览器中使用,但它也可以用在其他脚本环境,就像 Rhino and Node。使用RequireJS加载模块化脚本将提高代码的加载速度和质量,实现的是AMD规范,当然类似的还有CMD规范的实现框架seajs。

  Requirejs中,简单的说一个文件一个模块,即是单文件模块,所以对模块的加载其实本质上是对文件的加载。

  假设读者已经了解requirejs的基本使用方式。

  上一节中,讲到了提了一下controller的注册方式,其中说到了动态注册,当然除了controller之外,还有service、directive等都可以实现动态注册,这也是我们实现按需加载的基础,现在对我们的项目做一下修改,增加requirejs配置文件,main.js

 1 require.config({ 2     paths:{ 3         angular:‘https://cdn.bootcss.com/angular.js/1.6.0/angular‘, 4         ui_router:‘https://cdn.bootcss.com/angular-ui-router/1.0.3/angular-ui-router‘, 5         app:‘./app‘ 6         7     }, 8     shim:{ 9         angular:{exports:‘angular‘}10     }11 });12 13 require([‘angular‘,‘./app‘,‘ui_router‘],function(angular,app){14     angular.element(document).ready(function(){15         angular.bootstrap(document,[app.name]);16     })17 })

app.js修改如下:

 1 define([‘angular‘, ‘ui_router‘], function (angular) { 2     var app = angular.module(‘app‘, [‘ui.router‘]) 3         .config([‘$controllerProvider‘, ‘$provide‘, function ($controllerProvider, $provide) { 4             app.register = { 5                 controller: $controllerProvider.register,//动态注册controller 6                 factory: $provide.factory//动态注册服务 7             } 8         }]) 9         .config([‘$stateProvider‘, ‘$urlRouterProvider‘, function ($stateProvider, $urlRouterProvider) {10             //默认指向11             $urlRouterProvider.otherwise(‘/home‘);12 13             $stateProvider.state(‘home‘, {14                 url: ‘/home‘,15                 templateUrl: ‘./components/home/home.tpl.html‘,16                 controller: ‘HomeController‘,17                 controllerAs: ‘vm‘,18                 resolve: {19                     deps: loadCtrl([‘./components/home/home.controller‘])20                 }21 22             }).state(‘about‘, {23                 url: ‘/about‘,24                 templateUrl: ‘./components/about/about.tpl.html‘,25                 controller: ‘AboutController‘,26                 controllerAs: ‘vm‘,27                 resolve: {28                     deps: loadCtrl([‘./components/about/about.controller‘])29                 }30             }).state(‘contact‘, {31                 url: ‘/contact‘,32                 templateUrl: ‘./components/contact/contact.tpl.html‘,33                 controller: ‘ContactController‘,34                 controllerAs: ‘vm‘,35                 resolve: {36                     deps: loadCtrl([‘./components/contact/contact.controller‘])37                 }38             })39 40         }]);41     return app;42 43 44     function loadCtrl(path_arr) {45         return [‘$q‘, function ($q) {46             var defered = $q.defer();47             require(path_arr, function () {48                 defered.resolve();49             });50 51             return defered.promise;52 53         }]54     };55 })

修改controller注册方式如下:

1 define([‘app‘], function (app) {2     app.register.controller(‘HomeController‘, HomeController);3 4     HomeController.$inject = [‘$scope‘];5 6     function HomeController($scope) {7         console.log("HomeController created successfully!!!");8     }9 })

最后修改修改index.html中脚本引入方式,以及去掉ng-app指令启动方式,angular应用启动已在main.js中通过domready后使用脚本启动。

<!DOCTYPE html><html lang="en"><head>    <meta charset="UTF-8">    <meta name="viewport" content="width=device-width, initial-scale=1.0">    <meta http-equiv="X-UA-Compatible" content="ie=edge">    <title>demo1</title>    <script src="https://cdn.bootcss.com/require.js/2.3.3/require.js" data-main="./main"></script></head><body>    <div class="nav">        <ul>            <li><a ui-sref="home">Home</a></li>            <li><a ui-sref="about">About</a></li>            <li><a ui-sref="contact">Contact</a></li>        </ul>    </div>    <div class="container">        <div ui-view></div>    </div></body></html>

最终运行效果如下,可以看到只有在点击了对应的菜单时,才加载了对应的controller:

技术分享

由于代码简单,注释很少,有疑问可直接提交。

本文到此结束。

 

 

基于requirejs和angular搭建spa应用