align-content
=============

CSS 的 **`align-content`** 属性设置了浏览器如何沿着弹性盒子布局的纵轴和网格布局的主轴在内容项之间和周围分配空间。

尝试一下
----

该属性对单行弹性盒子模型无效。（即：带有 `flex-wrap: nowrap`）。

语法
--


```css
/\* 基本位置对齐 \*/
/\*align-content 不采用左右值 \*/
align-content: center; /\* 将项目放置在中点 \*/
align-content: start; /\* 最先放置项目 \*/
align-content: end; /\* 最后放置项目 \*/
align-content: flex-start; /\* 从起始点开始放置 flex 元素 \*/
align-content: flex-end; /\* 从终止点开始放置 flex 元素 \*/

/\* 默认对齐 \*/
align-content: normal;

/\*基线对齐\*/
align-content: baseline;
align-content: first baseline;
align-content: last baseline;

/\* 分布式对齐 \*/
align-content: space-between; /\* 均匀分布项目
 第一项与起始点齐平，
 最后一项与终止点齐平 \*/
align-content: space-around; /\* 均匀分布项目
 项目在两端有一半大小的空间\*/
align-content: space-evenly; /\* 均匀分布项目
 项目周围有相等的空间 \*/
align-content: stretch; /\* 均匀分布项目
 拉伸‘自动’ - 大小的项目以充满容器 \*/

/\* 溢出对齐 \*/
align-content: safe center;
align-content: unsafe center;

/\* 全局属性 \*/
align-content: inherit; /\* 继承 \*/
align-content: initial; /\* 初始值 \*/
align-content: unset; /\* 未设置 \*/
```

### 取值

`start`

所有行从容器的起始边缘开始填充。

`end`

所有行从容器的结束边缘开始填充。

`flex-start`

所有行从垂直轴起点开始填充。第一行的垂直轴起点边和容器的垂直轴起点边对齐。接下来的每一行紧跟前一行。

`flex-end`

所有行从垂直轴末尾开始填充。最后一行的垂直轴终点和容器的垂直轴终点对齐。同时所有后续行与前一个对齐。

`center`

所有行朝向容器的中心填充。每行互相紧挨，相对于容器居中对齐。容器的垂直轴起点边和第一行的距离相等于容器的垂直轴终点边和最后一行的距离。

`normal`

这些项按默认位置填充，就像没有设置对齐内容值一样。

`baseline first baseline`
`last baseline`

![](https://upload.wikimedia.org/wikipedia/commons/thumb/3/39/Typography_Line_Terms.svg/410px-Typography_Line_Terms.svg.png)



 Specifies participation in first- or last-baseline alignment: aligns the alignment baseline of the box’s first or last baseline set with the corresponding baseline in the shared first or last baseline set of all the boxes in its baseline-sharing group.
 The fallback alignment for `first baseline` is `start`, the one for `last baseline` is `end`.


`space-between`

所有行在容器中平均分布。相邻两行间距相等。容器的垂直轴起点边和终点边分别与第一行和最后一行的边对齐。

`space-around`

所有行在容器中平均分布，相邻两行间距相等。容器的垂直轴起点边和终点边分别与第一行和最后一行的距离是相邻两行间距的一半。

`space-evenly`

所有行沿垂直轴均匀分布在对齐容器内。每对相邻的项之间的间距，主开始边和第一项，以及主结束边和最后一项，都是完全相同的。

`stretch`

拉伸所有行来填满剩余空间。剩余空间平均地分配给每一行。

`safe`

与对齐关键字一起使用。如果所选的关键字意味着项溢出对齐容器（data loss），则将采用备用策略对项进行对齐，就像启动了 `start` 对齐模式一样。

`unsafe`

与对齐关键字一起使用。无论元素和对齐容器的相对大小如何、是否会导致一些元素溢出可见范围（data loss），都使用给定的对齐值。

### 标准语法
```

align-content =   
  normal                                   |  
  <baseline-position>                      |  
  <content-distribution>                   |  
  <overflow-position>? <content-position>    
  
<baseline-position> =   
  [ first | last ]?  &&  
  baseline             
  
<content-distribution> =   
  space-between  |  
  space-around   |  
  space-evenly   |  
  stretch          
  
<overflow-position> =   
  unsafe  |  
  safe      
  
<content-position> =   
  center      |  
  start       |  
  end         |  
  flex-start  |  
  flex-end      
  
```

示例
--

### CSS


```css
#container {
  height: 200px;
  width: 240px;
  align-content: center; /\* Can be changed in the live sample \*/
  background-color: #8c8c8c;
}

.flex {
  display: flex;
  flex-wrap: wrap;
}

.grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, 50px);
}

div > div {
  box-sizing: border-box;
  border: 2px solid #8c8c8c;
  width: 50px;
  display: flex;
  align-items: center;
  justify-content: center;
}

#item1 {
  background-color: #8cffa0;
  min-height: 30px;
}

#item2 {
  background-color: #a0c8ff;
  min-height: 50px;
}

#item3 {
  background-color: #ffa08c;
  min-height: 40px;
}

#item4 {
  background-color: #ffff8c;
  min-height: 60px;
}

#item5 {
  background-color: #ff8cff;
  min-height: 70px;
}

#item6 {
  background-color: #8cffff;
  min-height: 50px;
  font-size: 30px;
}

select {
  font-size: 16px;
}

.row {
  margin-top: 10px;
}
```

### HTML


```html
<div id="container" class="flex">
  <div id="item1">1</div>
  <div id="item2">2</div>
  <div id="item3">3</div>
  <div id="item4">4</div>
  <div id="item5">5</div>
  <div id="item6">6</div>
</div>

<div class="row">
  <label for="display">display: </label>
  <select id="display">
    <option value="flex">flex</option>
    <option value="grid">grid</option>
  </select>
</div>

<div class="row">
  <label for="values">align-content: </label>
  <select id="values">
    <option value="normal">normal</option>
    <option value="stretch">stretch</option>
    <option value="flex-start">flex-start</option>
    <option value="flex-end">flex-end</option>
    <option value="center" selected>center</option>
    <option value="space-between">space-between</option>
    <option value="space-around">space-around</option>
    <option value="space-evenly">space-evenly</option>

    <option value="start">start</option>
    <option value="end">end</option>
    <option value="left">left</option>
    <option value="right">right</option>

    <option value="baseline">baseline</option>
    <option value="first baseline">first baseline</option>
    <option value="last baseline">last baseline</option>

    <option value="safe center">safe center</option>
    <option value="unsafe center">unsafe center</option>
    <option value="safe right">safe right</option>
    <option value="unsafe right">unsafe right</option>
    <option value="safe end">safe end</option>
    <option value="unsafe end">unsafe end</option>
    <option value="safe flex-end">safe flex-end</option>
    <option value="unsafe flex-end">unsafe flex-end</option>
  </select>
</div>
```


```
var values = document.getElementById("values");
var display = document.getElementById("display");
var container = document.getElementById("container");

values.addEventListener("change", function (evt) {
  container.style.alignContent = evt.target.value;
});

display.addEventListener("change", function (evt) {
  container.className = evt.target.value;
});
```

### 结果

规范
--

| Specification |
| --- |
| CSS Box Alignment Module Level 3 # align-justify-content |
| CSS Flexible Box Layout Module Level 1 # align-content-property |

|  |  |
| --- | --- |
| 初始值 | `normal` |
| 适用元素 | multi-line flex containers |
| 是否是继承属性 | 否 |
| 计算值 | as specified |
| Animation type | discrete |

浏览器兼容性
------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

参见
--

* 弹性盒子布局的基本概念：*Basic Concepts of Flexbox*
* 对齐弹性容器中的弹性项目：*Aligning items in a flex container*
* 网格布局中的盒模型对齐：*Box alignment in CSS Grid layouts*
* CSS Box Alignment