一个ionic的微博demo源码分析

最近几天在汇智网上学习了一些ionic的基础知识。但是还是有点晕。今天在网上看到一个很不错的demo。在这里记录一下。

1. index.html

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
    <title></title>

    <link href="lib/ionic/css/ionic.css" rel="stylesheet">
    <link href="css/style.css" rel="stylesheet">

    <!-- IF using Sass (run gulp sass first), then uncomment below and remove the CSS includes above如果你想使用sass的话，要把下面这句话加进去
    <link href="css/ionic.app.css" rel="stylesheet">
    -->

    <!-- ionic/angularjs js -->
    <script src="lib/ionic/js/ionic.bundle.js"></script>

    <!-- cordova script (this will be a 404 during development)有了cordova script会报错404 -->
    <script src="cordova.js"></script>

    <!-- your app's js你app的js包含 -->
    <script src="js/app.js"></script>
    <script src="js/controllers.js"></script>
  </head>

  <body ng-app="starter" class="platform-android platform-cordova platform-webview">
<!--在body中，定义了ng-app是starter-->
    <ion-nav-view></ion-nav-view>
  </body>

</html>

2.列表项目app.js

接下来我们看一下app.js文件，这是程序的入口js文件。
为了理解起来简单，我将程序分段贴在这里，并对它进行备注。

在书上看到一句话很有用：module.config和module.run方法注册了在angularjs应用的生命周期的关键时刻所调用的函数。
传给config方法的函数在当前模块被加载后调用
传给run方法的函数在所有模块被加载后调用

2.1.angular.module

angular.module('starter', ['ionic', 'starter.controllers'])

这句话是定义了一个module，它有两个参数：

starter是与HTML文件中的ng-app对应的。
[]中的内容是依赖注入。这个Module被依赖注入了两个文件，一个是ionic,一个是starter.controllers。

2.2.run方法

.run(function($ionicPlatform) {
  $ionicPlatform.ready(function() {
    // Hide the accessory bar by default (remove this to show the accessory bar above the keyboard
    // for form inputs)
    if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
    if(window.StatusBar) {
      // org.apache.cordova.statusbar required
      StatusBar.styleDefault();
    }
  });
})

上面这段是.run入口方法。在程序启动时调用，可以在里面做一些初始化的东西。

run方法传入一个函数，这就是初始化程序的函数function($ionicPlatform)。

函数被注入$ionicPlatform（一个angular抽象的ionic.Platform。用来检测当前的平台，以及诸如在PhoneGap/Cordova中覆盖Android后退按钮。）

2.2.1.ready()

接下来我们一句句分析。

ready([callback])

这是 $ionicPlatform的一个函数。一旦设备就绪，则触发一个回调函数，或如果该设备已经就绪，则立即调用。
参数callback,可选,它是一个触发的function。

返回: promise 当设备就绪后，就会解决一个 promise。

2.2.2.if

if(window.cordova && window.cordova.plugins.Keyboard) {
      cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
    }
这句话只是判断一下cordova环境以及键盘是否就位

if(window.StatusBar) {
      // org.apache.cordova.statusbar required
      StatusBar.styleDefault();
    }
判断org.apache.cordova.statusbar设备是否就位

2.3.config方法

.config(function($stateProvider, $urlRouterProvider) {//配置，注入了状态机，ui-router
  $stateProvider//状态机开始

    .state('app', {   //state的第一个参数——app叫做状态名
      url: "/app",//匹配的url， 我们必须要地址栏输入www.xx.com/app，才会加载对应的模板而不是输入app，它仅仅是一个名字而已。
      abstract: true,//表明此状态不能被显性激活，只能被子状态隐性激活
      templateUrl: "templates/menu.html",//对应的模板
      controller: 'AppCtrl'//控制器
    })

    .state('app.feed', {
      url: "/feed",
  // **views  用在该状态下有多个 ion-nav-view 的情况，可以对不同的ion-nav-view使用特定的 template,** controller, resolve data
  // 绝对 view 使用 '@' 符号来区别，比如 'foo@bar' 表明名为 'foo' 的 ui-view 使用了 'bar' 状态的模板(template)，相对 view 则无
      views: {
        'menuContent' :{
          templateUrl: "templates/social/feed.html"
        }
      }
    })

    .state('app.start', {
      url: "/start",
      views: {
        'menuContent' :{
          templateUrl: "templates/social/start-fullscreen.html"
        }
      }
    })

.config方法接受一个函数，该函数在调用方法的模块被加载后调用

2.3.1.$route路由相关

由$route服务提供的核心功能：设置URL与视图文件名称之间的映射。也叫URL路由。当$location.path方法返回的值匹配映射其中之一时，与之相应的视图文件就被载入并显示。用$route服务的提供器$routeProvider定义映射。

2.3.2.$ui-route状态机

找了半天，没找到什么有用的资料。暂且认为这种状态机是一种固定的格式。吧。

3.controllers.js

angular.module('starter.controllers', [])
//相当于myapp = angular.module('starter.controllers', [])
//myapp.controller('AppCtrl', function($scope, $ionicModal, $timeout){
.controller('AppCtrl', function($scope, $ionicModal, $timeout) {


  // Form data for the login modal
  $scope.loginData = {};

  // Create the login modal that we will use later
  $ionicModal.fromTemplateUrl('templates/social/login.html', {
    scope: $scope
  }).then(function(modal) {
    $scope.modal = modal;
  });

  // Triggered in the login modal to close it
  $scope.closeLogin = function() {
    $scope.modal.hide();
  };

  // Open the login modal
  $scope.login = function() {
    $scope.modal.show();
  };

  // Perform the login action when the user submits the login form
  $scope.doLogin = function() {
    console.log('Doing login', $scope.loginData);

    // Simulate a login delay. Remove this and replace with your login
    // code if using a login system
    $timeout(function() {
      $scope.closeLogin();
    }, 1000);
  };
})

3.1controller定义

angular.module('starter.controllers', [])
  .controller('AppCtrl', function($scope, $ionicModal, $timeout)

相当于：

myapp = angular.module('starter.controllers', [])
myapp.controller('AppCtrl', function($scope, $ionicModal, $timeout)
控制器接受两个参数，控制器名，工厂函数（设置控制器并使其就绪）
函数被注入依赖，`$scope, $ionicModal, $timeout`

理解依赖注入

一个angularjs应用程序中的一些组件将会依赖于其他组件，依赖注入改变了函数参数的用途。

3.2 内部函数分析

肥肠简单。就不用写了。