Angular Material官方入门教程

作者: ___wanJS | 来源:发表于2016-07-26 18:18 被阅读0次

翻译自Angular Material官方主页，原文地址

Angular Material官方入门教程，八步打造一个这样的app:

这个app属于一种Master-Detail布局，即左侧是用户列表，右侧是用户详情

上面同时还展示了在小尺寸设备上的显示效果。响应式的布局使得我们可以通过点击菜单按钮将用户列表隐藏，以及通过分享按钮显示底部的分享视图。

"如何创建app?"

有一些广泛使用的、规范化的app开发流程

规划你的布局和希望使用到的组件，最好有一套交互设计文档
使用常规的HTML和伪造的数据来确保组件能按希望的样式渲染
将UI组件整合到你的应用逻辑中，尽可能地和Angular的指令和控制器做到无缝整合。在整合前，你最好对应用逻辑进行单元测试。
添加合适的断点(响应式布局的触发点)
添加主题支持
添加对无障碍设计的支持
编写自动化测试，此步骤对于验证你的应用逻辑与Angular Material UI组件的配合非常重要。

此教程针对ES5

本教程假定你已经通过clone或npm install获取到了Angular Material

第一步载入库文件

在HTML文件中引入库文件的连接即可：

<head> 
  <link href="../node_modules/angular-material/angular-material.css" rel="stylesheet" />
</head> 
<body> 
  <script src="../node_modules/angular/angular.js" type="text/javascript" ></script> 
  <script src="../node_modules/angular-animate/angular-animate.js" type="text/javascript" ></script> 
  <script src="../node_modules/angular-aria/angular-aria.js" type="text/javascript" ></script> 
  <script src="../node_modules/angular-material/angular-material.js" type="text/javascript" ></script> 
  <script> 
     // Include the dependency upon ngMaterial - important !!
     angular.module('starterApp', ['ngMaterial']); 
  </script>
</body>

第二步容器布局

下面的插图展示了我们如何规划布局以及确定应用中的主要组件

注意，container#2是一个普通的div容器，并非Angular Material的组件

添加<md-toolbar>,<md-sidenav>,<md-content>容器。<md-sidenav>容器用于包含用户列表，<md-content>容器用于包含选中用户的详情视图。
添加 layout和flex属性来指定容器的布局方式和尺寸
使用md-locked-open将侧边栏导航锁定在左侧
使用md-whiteframe-z2来为侧边栏导航添加阴影

<body ng-app="starterApp" layout="column"> 
  <!-- Container #1 (see wireframe) -->
   <md-toolbar layout="row" >
     <h1>Angular Material - Starter App</h1> 
   </md-toolbar> 
   <!-- Container #2 -->
   <div flex layout="row">
     <!-- Container #3 --> 
     <md-sidenav md-is-locked-open="true" class="md-whiteframe-z2"></md-sidenav> 
     <!-- Container #4 --> 
     <md-content flex id="content"></md-content>
   </div>
</body>

这里使用简单的线框图来规划布局我们需要的组件和属性。然后使用Angular Material Layout api来对容器进行响应式布局。

第三步常规HTML

在这一步你将使用常规的HTML元素和Angular Material UI组件来渲染和布局每个容器所需要的子元素。

在md-sideNav容器中显示一个用户列表
- 使用md-list,md-button,和md-icon组件并添加伪数据
在md-content容器中显示用户的伪数据

注意：md-sidenav容器是用户列表的主要视图，md-content容器是用户的详情视图

<body ng-app="starterApp" layout="column">
    <md-sidenav md-is-locked-open="true" class="md-whiteframe-z2">
      <md-list>
        <!-- List item #1 -->
        <md-list-item>
          <md-button>
            <md-icon md-svg-src="./assets/svg/avatar-1.svg" class="avatar"></md-icon>
            Lia Luogo
          </md-button>
        </md-list-item>
        <!-- List item #2 -->
        <md-list-item>
          <md-button>
            <md-icon md-svg-src="./assets/svg/avatar-4.svg" class="avatar"></md-icon>
            Lawrence Ray
          </md-button>
        </md-list-item>
      </md-list>
    </md-sidenav>
    <md-content flex id="content">
      <!-- User details sample -->
      <md-icon md-svg-src="./assets/svg/avatar-1.svg" class="avatar"></md-icon>
      <h2>Lia Luogo</h2>
      <p> I love cheese... </p>
    </md-content>
</body>

第四步动态化与伪数据

这一步我们将动态替换常规的HTML，并注入伪数据

建立自定义的应用逻辑来载入伪数据
创建HTML标记来渲染脚本和伪数据
然后你就能整合你的应用逻辑
定义一个Angular模块'users'并添加到你的代码中
定义你的数据服务，数据模型和控制器
使用script标签加载你的代码
确定你的'starterApp' 模块同时注入了'ngMaterial' 和 'users'

<script src="./src/users/Users.js"></script>
<script src="./src/users/UsersListController.js"></script>
<script src="./src/users/UsersDataservice.js"></script>
<script type="text/javascript">
    angular.module('starterApp', ['ngMaterial', 'users']);       
</script>

然后使用angular指令(如：ng-repeat)将HTML替换为动态标记,b并使用{{}}注入数据

Angular将会编译并渲染动态HTML标记
注册一套虚拟图标，让每个用户都关联一个虚拟ID

<!-- Wireframe Container #2 -->
<div flex layout="row">
    <!-- Wireframe Container #3 -->
    <md-sidenav md-is-locked-open="true" class="md-whiteframe-4dp">
      <md-list>
        <md-list-item ng-repeat="u in ul.users">
          <md-button ng-click="ul.selectUser(it)" ng-class="{'selected' : u === ul.selected }">
            <md-icon md-svg-icon="{{u.avatar}}" class="avatar"></md-icon>
            {{it.name}}
          </md-button>
        </md-list-item>
      </md-list>
    </md-sidenav>
    <!-- Wireframe Container #4 -->
    <md-content flex id="content">
      <md-icon md-svg-icon="{{ul.selected.avatar}}" class="avatar"></md-icon>
      <h2>{{ul.selected.name}}</h2>
      <p>{{ul.selected.content}}</p>
    </md-content> </div>
  <script type="text/javascript">
      angular .module('starterApp', ['ngMaterial', 'users']) .config(function( $mdIconProvider ){ 
        // Register the user `avatar` icons 
        $mdIconProvider .defaultIconSet("./assets/svg/avatars.svg", 128); 
});
   </script>

第五步使用底部表

这一步，你将会在用户详情区域底部添加一个动态的mbBottomSheet组件,用来向其他用户展示该用户的联系方式。

在用户详情视图的右上角创建一个'Share'按钮
在底部表中创建联系用户视图和控制器
使用$mdBottomSheet服务指定并加载底部表
注册可能需要的图标

添加share按钮到视图中

  <md-content flex id="content">
    <md-icon md-svg-icon="{{ul.selected.avatar}}" class="avatar"></md-icon>
    <h2>{{ul.selected.name}}</h2>
    <p>{{ul.selected.content}}</p>
    <md-button class="share" md-no-ink ng-click="ul.makeContact(ul.selected)">
      <md-icon md-svg-icon="share"></md-icon>
    </md-button>
  </md-content>
  <script type="text/javascript">
    angular .module('starterApp', ['ngMaterial', 'users']) .config(function($mdIconProvider){ 
      $mdIconProvider.icon("share", "./assets/svg/share.svg", 24); });
  </script>

添加makeContact()函数到控制器中

  function share(selectedUser) { 
    $mdBottomSheet.show({ 
      controllerAs : "vm", 
      controller : [ '$mdBottomSheet', ContactSheetController], 
      templateUrl :'./src/users/view/contactSheet.html',                           
      parent:angular.element(document.getElementById('content'))
    });
    function ContactSheetController( $mdBottomSheet ) {
      this.user = selectedUser;
      this.items = [ 
        { name: 'Phone' , icon: 'phone' , icon_url: 'assets/svg/phone.svg'},
        { name: 'Twitter' , icon: 'twitter' , icon_url: 'assets/svg/twitter.svg'},
        { name: 'Google+' , icon: 'google_plus' , icon_url: 'assets/svg/google_plus.svg'},
        { name: 'Hangout' , icon: 'hangouts' , icon_url: 'assets/svg/hangouts.svg'} ]; 
      this.contactUser = function(action) { 
        // The actually contact process has not been implemented... 
        // so just hide the bottomSheet 
        $mdBottomSheet.hide(action);
      };
    }
  }

第六步响应式布局

Angular Material Layout API 使用flexbox来让你的DOM容器和元素能流畅地适应你的浏览器视图宽度和高度的变化。它们还是用媒体查询来定义浏览器特定的宽度范围，让你的应用能适应新的视口大小，这些范围以下面的断点为定义：

但是对于使用Angular Material的开发者来说，使用媒体查询和断点显得太低级了，所以我们可以使用下面的别名来实现

在本节课中，你将会使用自适应断点来让你的应用实现响应式布局

在工具栏中添加一个Menu按钮
当设备宽度大于600px时，锁定用户列表处于打开状态，否则关闭
- 使用$mdMedia来帮助实现这一效果
当用户列表处于打开状态时，隐藏工具栏的menu图标
为menu按钮添加click响应
- 使用$mdSideNav 服务来切换侧边栏
- 当用户被选中时，自动关闭侧边栏

  <body>
    <!-- Wireframe Container #1 -->
    <md-toolbar layout="row">
      <md-button class="menu" hide-gt-sm ng-click="ul.toggleList()" >
        <md-icon md-svg-icon="menu" ></md-icon>
      </md-button>
    </md-toolbar>
    <!-- Wireframe Container #2 -->
    <div flex layout="row">
      <!-- Wireframe Container #3 -->
      <md-sidenav md-is-locked-open="$mdMedia('gt-sm')" md-component-id="left" ng-click="ul.toggleList()" >
      </md-sidenav>
      <!-- Wireframe Container #4 -->
      <md-content flex id="content">
         <md-button class="share" md-no-ink ng-click="ul.share(ul.selected)"> 
        </md-button>
      </md-content>
    </div>
  </body>

添加menu图标

  <script type="text/javascript">
     angular .module('starterApp', ['ngMaterial', 'users']) .config(function($mdIconProvider){
      $mdIconProvider.icon("menu", "./assets/svg/menu.svg", 24);
    });
  </script>

使用Layout API 和out breakpoint aliases和组件服务

hide-gt-sm和$mdMedia('gt-sm')
$mdSidenav 和 $mdMedia

我们很快的创建了一个不光响应尺寸变化还适应断点值变化的应用

  function UserController( userService, $mdBottomSheet, $mdSidenav ) { 
    var self = this; 
    self.toggleList = toggleUsersList; 
    // ********************************* 
    // Internal methods 
    // ********************************* 
    /** 
      * Hide or Show the 'left' sideNav area 
      */ 
    function toggleUsersList() { 
      $mdSidenav('left').toggle(); 
    }
  }

第七步主题及无障碍阅读设计

这里你将会使用特别的，更深的主题

使用$mdThemingProvider服务来制定特别的主题，使用棕色作为主色，红色作为强调色

  <script type="text/javascript">
    angular .module('starterApp', ['ngMaterial', 'users']).config(function($mdThemingProvider, $mdIconProvider){
      $mdThemingProvider.theme('default') .primaryPalette('brown') .accentPalette('red');
    });
  </script>

总结

通过以上7步和几分钟的工作，我们迅速创建了一个美丽的、自适应的、主题鲜明的、可访问的以及容易保持的Angular Material 应用

想象一下没有Angular Material做这些会是什么样！
(原文的链接就是写的八步所以不要问我第八步去哪了)

Angular Material官方入门教程