Angular Material API简单翻译(Layout部分)

昨天翻译了Angualr Material的一个官方入门教程,今天来简单翻译一下它的API文档,保证自己能看懂就行了,原文地址

简述

Angular Material 的布局方式基于CSS3的flexbox规则
布局API由一系列Angular 指令组成
Angular Material使用指令布局,使用CSS类注入样式

布局与容器

使用layout指令来制定容器内部元素的布局方式,如layout='row'制定容器内部的元素将进行水平排列,如果不知道layout的值,那将默认进行row布局

  • row : 元素水平排列,每个元素最大高度为100%,最大宽度为元素在容器中的宽度
  • column : 元素垂直排列,最大宽度100%,最大高度为元素在容器中的高度

响应式布局

在不同的设备下,元素的布局方式可能发生变化,可以用breakpoint alias来设置元素在不同设备下的布局方式
下面的代码表示当页面在宽屏设备上显示时,两个div会以行布局显示,当页面在小尺寸设备上显示时,则会以列布局显示

I'm above on mobile, and to the left on larger devices.
I'm below on mobile, and to the right on larger devices.

所有的breakpoint alias如下:

  • layout : 默认布局方式,当其他布局别名执行时失效
  • layout-xs : width < 600px时触发
  • layout-gt-xs : width >= 600px 时触发
  • layout-sm : 600px <= width < 960px 时触发
  • layout-md : 960px <= width < 1280px 时触发
  • layout-gt-md : width > 1280px 时触发
  • layout-lg : 1280px <= width < 1920px 时触发
  • layout-gt-lg : width >= 1920px 时触发
  • layout-xl : width >= 1920px 时触发

容器中的子元素

我们可以使用flexflex-orderflex-offset来为容器中的子元素设定尺寸,例如:flex='30',表示这个元素的宽度为30%,flex属性的取值如果是数字的话,只能取5的倍数或33、66
当然,还有以下值可供选择:

  • flex='none' : 尺寸取决于自身的width和height且不会变化
  • flex='initial' : 会按照需要收缩,不会扩大,变化基于自身的width和height
  • flex='auto' : 会根据需要自动变化,变化基于自身的width和height
  • flex='grow' : 会根据需要自动变化,且恒为100%
  • flex='nogrow' : 会根据需要收缩,但不会扩大,变化基于自身的width和height
  • flex='noshrink' : 会根据需要扩大,但不会收缩,变化基于自身的width和height

排列HTML元素

可以通过flex-order指令来对子元素进行排序,子元素将按照取值从小到大的顺序依次排列,取值范围为-20至20的整数
'flex-order'指令也有对应的响应式布局指令,如flex-order-xsflex-order-gt-xs

偏移量

可以通过使用flex-offset指令为子元素添加偏移量,取值规则和flex相同,其原理是为子元素添加了一个margin-left...
当然,这个指令也有响应式布局别名...

子元素对齐

layout-align指令取值由两个词组成,前者设置水平对齐方式,后者设置垂直对齐方式,只提供一个值时将只能设置水平对齐方式,而垂直对齐方式将被设置为默认
当然,这个指令也有响应式布局别名,不说了...
水平对齐方式包括:

  • none : 无对齐,使用默认对齐,和start相同
  • start : 默认对齐方式,向左(上)顶格
  • center : 居中对齐
  • end : 向右(下)顶格
  • space-around : 每个元素都保留margin的分散对齐方式
  • space-between : 仅在相邻元素间保留margin的分散对齐方式
    垂直对齐方式包括:
  • none : 无对齐,使用默认对齐,和stretch相同
  • start : 向上(左)顶格
  • center : 居中对齐
  • end : 向下(右)顶格
  • stretch(default) : 拉伸对齐,拉伸高度(宽度)为100%

额外设定

layout-marginlayout-paddinglayout-fill

  • layout-margin指令为容器内的每个子元素添加margin
  • layout-padding指令为容器内的每个子元素添加padding
  • layout-fill指令强制让容器内的子元素撑满容器
  • layout-wrap指令限制子元素被包含在容器内及时它们的尺寸之和超过了容器

Show 和 Hide

使用show和hide指令设置子元素显示或隐藏,和Angular的ng-show和ng-hide相似,接受一个boolean值或返回boolean值的表达式,show和hide指令也拥有相应式别名,可以设置元素在特定屏幕尺寸下显示或隐藏

故障处理

概述

Angular Material Layout系统使用了CSS3的flexbox特性,更重要的是,它提供了一系列语法糖来让开发者轻松快捷为HTML容器和元素添加响应式支持
当你使用这些布局特性时,你也许会遇到布局没有达到预期效果的情况,特别是在ie10和ie11浏览器中,此时也许你仍然需要使用原生的HTML,CSS和Javascript来达到你预期的结果

资源

如果你在某个特定的浏览器中开发时遇到问题,强烈建议你通过以下资源获得帮助:

  • FlexBugs
  • Solved by FlexBugs
  • Normalizing Cross-browser Flexbox Bugs
  • Can I use flexbox...?(see the Known Issues tab)
  • Angular Material Forum
  • A Complete Guide to Flexbox
  • A Visual Guide to CSS3 Flexbox Properties

常见问题

下面给你介绍一下开发过程中的常见问题和解决方法

  • 在开始构建应用时,建议先进行移动端的布局,在达到预期效果后,使用flex-gt-*flex-gt-*指令添加对大屏幕设备的支持.这个方法避免了从大屏向小屏迁移时面临的一大堆问题
  • 某些元素如
  • 部分Flexbox 属性例如flex-direction无法添加动画
  • Flexbox在不同的浏览器会有不同的显示效果,你应该测试尽可能多的浏览器以确保尽快发现和解决布局错误

Layout Column

因为CSS的一些特殊规则,layout='column'和breakpoints(xs,gt-xs,xs,gt-sm等等)在某些情况下可能会失效
在案例中,我们希望card1和card2在非小尺寸设备中进行行布局,且card1的宽度为30%,但是最后的显示效果却不是我们希望的.原因是搞反了布局的逻辑导致默认的布局方式为layout='row'

Layout Column 和 Container HEights

在Flexbox中,一些浏览器会根据flex容器的内容的大小来决定容器的尺寸,当你在有一个non-flex的组件(如 toolbar)后面跟着2个列布局的felx组件时这是非常需要注意的(在原文的例子中出现的是flex元素嵌套的问题),解决的办法是给外部的flex元素添加height:100%

layout部分就到这里啦 ,明天继续翻译service部分

你可能感兴趣的:(Angular Material API简单翻译(Layout部分))