从零开始搭建口袋妖怪管理系统(3)-实现一个简单的SPA管理系统

一、目标

上一章我们完成了口袋妖怪的细节展示页面，这次我想要把总计划的框架搭起来，也就是建立起一个口袋妖怪SPA管理系统，包含口袋妖怪、技能、树果、道具、游戏这样五个模块，并且能够通过导航平滑跳转到指定模块。

二、分析

SPA系统的基础是路由&模块化，所以将上一章我们所写的pokemon抽象出pokemon模块，然后路由默认跳转至pokemon模块页面。完成之后再照葫芦画瓢完成其他模块的，最后再编写导航标签实现口袋妖怪SPA系统的多模块导航。

三、开发

1. pokemon部分模块化

首先在pokemon文件夹中新建pokemon.js，然后在index.html中加入引用：

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

完成之后开始编写pokemon.js，首先完成创建pokemon-app.pokemon模块并引入ng-Route依赖：

(function () {
  'use strict';
  angular.module('pokemon-app.pokemon', ['ngRoute']);
})();

接着将app.js中的pokemon控制器部分剪切过来，当然顺便把pokemons的数据也带上：

(function () {
  'use strict';
  angular.module('pokemon-app.pokemon', ['ngRoute'])
  .controller('PMListController', PMListController)
  .controller('PMDetailController', PMDetailController);

  
  var pokemons = [
    { no:'001', name:'妙蛙种子', count: 1, weight: 6.9, property: '草/毒', type: '种子宝可梦', character: { common: '茂盛', conceal: '叶绿素'}},
    { no:'002', name:'妙蛙草', count: 1, weight: 13.0, property: '草/毒', type: '种子宝可梦',  character: { common: '茂盛', conceal: '叶绿素'}},
    { no:'003', name:'妙蛙花', count: 1, weight: 100, property: '草/毒', type: '种子宝可梦',  character: { common: '茂盛', conceal: '叶绿素'}},
    { no:'004', name:'小火龙', count: 1, weight: 8.5, property: '火', type: '蜥蜴宝可梦',  character: { common: '猛火', conceal: '太阳之力'}},
    { no:'025', name:'皮卡丘', count: 1, weight: 6, property: '电', type: '鼠宝可梦',  character: { common: '静电', conceal: '避雷针'}}
  ];

  PMListController.$inject = ['$scope'];
  function PMListController ($scope) {
    $scope.pokemons = pokemons;
    $scope.remove = function (index) {
      $scope.pokemons.splice(index, 1);
    }
  }

  PMDetailController.$inject = ['$scope', '$routeParams'];
  function PMDetailController ($scope, $routeParams) {
    console.log('$routeParams:', $routeParams);
    angular.forEach(pokemons, function (element) {
      if (element.no === $routeParams.no) {
        $scope.pokemon = element;
        console.log('the match pokemon:', $scope.pokemon);
      }
    });
  }
})();

然后再将app.js中pokemon路由部分剪切过来：

  angular.module('pokemon-app.pokemon', ['ngRoute'])
  .config(['$routeProvider', function ($routeProvider) {
    $routeProvider
      .when('/pokemons', {
        templateUrl: 'pokemon/pm-list.html',
        controller: 'PMListController'
      })
      .when ('/pokemon/:no', {
        templateUrl: 'pokemon/pm-detail.html',
        controller: 'PMDetailController'
      })
  }])

pokemon模块很简单地完成了，这时候应该在app.js中添加对'pokemon-app.pokemon'模块的依赖，并修改一下路由，使其初始化时默认加载pokemon模块：

(function () {
  'use strict';
  angular.module('pokemon-app', [
    'ngRoute',
    'pokemon-app.pokemon'           // 添加依赖
  ])
  .config (['$routeProvider', function ($routeProvider) {
    $routeProvider
      .otherwise({  
        redirectTo: '/pokemons'     // 初始化直接跳转到pokemon模块
      });
  }])

  AppController.$inject = ['$scope'];
  function AppController ($scope) {}
})();

至此，pokemon模块已经完全从主模块中独立出来了，主模块想要使用pokemon就需要通过添加依赖的方式实现调用。

2. 其他模块编写

完成了pokemon模块之后，其他模块的构建自然也是很简单的，构建完成之后的项目文件目录如下：

项目文件列表.png

完成每个模块的编写之后，记得将模块引入工程：

<!DOCTYPE html>
<html lang="en" ng-app="pokemon-app">
  <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>口袋妖怪</title>
    <script src="libs/angular.js"></script>
    <script src="libs/angular-route.js"></script>
    <script src="pokemon/pokemon.js"></script>
    <script src="skill/skill.js"></script>
    <script src="hagberry/hagberry.js"></script>
    <script src="prop/prop.js"></script>
    <script src="game/game.js"></script>
    <script src="app.js"></script>
    <link rel="stylesheet" href="app.css"/>
  </head>
  <body ng-controller="AppController">
    <h1>口袋妖怪管理系统</h1>
    <div ng-view></div>
  </body>
</html>

并添加为'pokemon-app'模块的依赖：

angular.module('pokemon-app', [
    'ngRoute',
    'pokemon-app.pokemon',           // 添加依赖
    'pokemon-app.skill',
    'pokemon-app.hagberry',
    'pokemon-app.prop',
    'pokemon-app.game'
])

3. 导航标签

完成了模块编写之后，为了方便去到想要的界面，现在来为系统制作导航标签。在index.htm中加入以下代码：

<div>
    <h2>快速导航：</h2>
    <a href="/#!/pokemons">口袋妖怪</a>
    <a href="/#!/skills">技能</a>
    <a href="/#!/hagberrys">树果</a>
    <a href="/#!/props">道具</a>
    <a href="/#!/games">游戏</a>
</div>

4. 效果展示

项目效果展示.gif

5. 扩展学习--加入图片

我在编写上面的SPA系统过程中，找到一些有趣的东西：[皮卡丘]（https://wiki.52poke.com/wiki/...）
在皮卡丘的页面中，我们发现皮卡丘有着许多换装形象，于是我想要把这个功能加入到SPA系统中，实现效果就是在点击口袋妖怪-皮卡丘后，在SPA系统中能够看到皮卡丘的样子。

于是稍微扩展一下pokemons的数据，为口袋妖怪加上原始图像，如果有其他形象，将其名称及链接加入forms中：

  var pokemons = [
    { no:'001', name:'妙蛙种子', count: 1, weight: 6.9, property: '草/毒', type: '种子宝可梦', 
      character: { common: '茂盛', conceal: '叶绿素'},
      img: 'https://s1.52poke.wiki/wiki/thumb/2/21/001Bulbasaur.png/300px-001Bulbasaur.png'
    },
    { no:'002', name:'妙蛙草', count: 1, weight: 13.0, property: '草/毒', type: '种子宝可梦',  
      character: { common: '茂盛', conceal: '叶绿素'},
      img: 'https://s1.52poke.wiki/wiki/thumb/7/73/002Ivysaur.png/300px-002Ivysaur.png'
    },
    { no:'003', name:'妙蛙花', count: 1, weight: 100, property: '草/毒', type: '种子宝可梦',  
      character: { common: '茂盛', conceal: '叶绿素'},
      img: 'https://s1.52poke.wiki/wiki/thumb/a/ae/003Venusaur.png/300px-003Venusaur.png'
    },
    { no:'004', name:'小火龙', count: 1, weight: 8.5, property: '火', type: '蜥蜴宝可梦',  
      character: { common: '猛火', conceal: '太阳之力'},
      img: 'https://s1.52poke.wiki/wiki/thumb/7/73/004Charmander.png/300px-004Charmander.png'
    },
    { no:'025', name:'皮卡丘', count: 1, weight: 6, property: '电', type: '鼠宝可梦',  
      character: { common: '静电', conceal: '避雷针'},
      img: 'http://s1.52poke.wiki/wiki/thumb/0/0d/025Pikachu.png/260px-025Pikachu.png',
      forms: [
        { name: '偶像皮卡丘', src: 'http://s1.52poke.wiki/wiki/thumb/e/e8/025Pikachu-Pop_Star.png/260px-025Pikachu-Pop_Star.png'},
        { name: '博士皮卡丘', src: 'http://s1.52poke.wiki/wiki/thumb/2/2f/025Pikachu-PhD.png/260px-025Pikachu-PhD.png'},
        { name: '面罩摔角手皮卡丘', src: 'http://s1.52poke.wiki/wiki/thumb/e/e7/025Pikachu-Libre.png/260px-025Pikachu-Libre.png'},
        { name: '贵妇皮卡丘', src: 'http://s1.52poke.wiki/wiki/thumb/f/f0/025Pikachu-Belle.png/260px-025Pikachu-Belle.png'},
        { name: '重摇滚皮卡丘', src: 'http://s1.52poke.wiki/wiki/thumb/4/4f/025Pikachu-Rock_Star.png/260px-025Pikachu-Rock_Star.png'},
      ] }
  ];

Tip：数据来源 https://wiki.52poke.com/wiki/ , 仅引用展示并且承诺不用于商业用途。

接下来修改pm-detail.html页面，加入初始形象img及其他形象img：

<h2>口袋妖怪详情：</h2>
<img ng-src="{{pokemon.img}}">
<p><b>编号: </b>No.{{pokemon.no}}</p>
<p><b>名称: </b>{{pokemon.name}}</p>
<p><b>体重: </b>{{pokemon.weight}}</p>
<p><b>属性: </b>{{pokemon.property}}</p>
<p><b>种类: </b>{{pokemon.type}}</p>
<div>
  <b>特性: </b>
  <ul>
    <li><b>普通特性: </b>{{pokemon.character.common}}</li>
    <li><b>隐藏特性: </b>{{pokemon.character.conceal}}</li>
  </ul>
</div>

<div ng-show="pokemon.forms">
  <b style="float: left;">其他形象:</b><br/>
  <div ng-repeat="form in pokemon.forms" style="float: left;">
    <img ng-src="{{form.src}}">
    <p style="text-align: center;">{{form.name}}</p>
  </div>
  <div style="clear: both;"></div>
</div>

<a href="/#!/pokemons">返回列表</a>

加入形象效果展示.png