翻译自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做这些会是什么样！
(原文的链接就是写的八步所以不要问我第八步去哪了)
