Grid 栅格

Material Design 响应式布局的栅格可适应屏幕大小和方向，确保布局在不同尺寸之间的一致性。

Grid 栅格组件能确保不同布局间的视觉层面的舒适感，同时在众多不同设计中保持灵活性。 Material Design's responsive UI is based on a 12-column grid layout.

⚠️ 栅格 组件不要与承载大量数据的表格（data grid）进行混淆；这个组件更倾向于在布局中使用。如果需使用承载大量数据的表格，请看这里的 数据表格 组件。

工作原理

栅格系统是通过 Grid 组件实现的：

It uses CSS's Flexible Box module for high flexibility.
它有两种类型的布局： containers ， _items_。
Item widths are set in percentages, so they're always fluid and sized relative to their parent element.
子项目（items）使用内边距来保持和其他块（items）的间距。
其中五个断点可供使用：xs，sm，md，lg 和 xl。
你可以为每个断点提供整数值，表示当视口宽度满足断点约束时，12 个可用列中有多少列被组件占用。

若你对 flexbox 不太熟悉，我们建议你阅读 CSS-Tricks flexbox 手册。

Spacing 间距

响应式栅格布局追求块与块之间统一的间距，而非块本身的宽度。 Material design 外边距（margins）和列（columns）都遵循了一个 8px 的方块形基线栅格。你可以将 spacing 的属性值设置为一个在 0 到 10 之间的整数默认情况下，两个栅格块（item）之间的间距遵循一个线性函数。output(spacing) = spacing * 8px，例如：spacing={2} 将会创建一个 16px 宽的间隙。

通过使用主题，该变换函数的输出是可定制的。

Fluid grids 流式网格

流式网格可以通过列（column）来缩放和调整内容的大小。 A fluid grid's layout can use breakpoints to determine if the layout needs to change dramatically.

基本栅格

每一列的宽度是 1 到 12 之间的整数值；它们适用于任何断点，并且表明了组件占用多少列。

你可以给定一个断点值来应用于比它更宽的所有其他断点（除非被覆盖，你可以在本页的后面部分阅读被覆盖后的行为）。例如，无论组件的大小如何，xs={12} 都会占据整个视口的宽度。

⚠️ Missing demo `pages/components/grid/CenteredGrid.js` ⚠️

有断点的栅格

组件可能会定义多种宽度，这会导致布局会根据事先定义的断点（breakpoint）来改变其宽度。你可以给较大断点指定宽度值。那么它会覆盖给较小断点指定的宽度值。

例如，xs={12} sm={6} 表示当视口宽度为 600 或更多像素时，将组件的大小调整为占据视口宽度的一半（6列）。对于较小的视口，该组件将填充所有 12 个可用的列。

xs=6 md=8

xs=6 md=4

xs=6 md=8

<Grid container spacing={2}>
  <Grid item xs={6} md={8}>
    <Item>xs=6 md=8</Item>
  </Grid>
  <Grid item xs={6} md={4}>
    <Item>xs=6 md=4</Item>
  </Grid>
  <Grid item xs={6} md={4}>
    <Item>xs=6 md=4</Item>
  </Grid>
  <Grid item xs={6} md={8}>
    <Item>xs=6 md=8</Item>
  </Grid>
</Grid>

交互式

下面是一个交互式的演示，你也可以探索不同设置下的视觉结果：

Cell 1

Cell 2

Cell 3

<Grid
  container
  direction="row"
  justifyContent="center"
  alignItems="center"
>

自适应布局

自适应布局让 块（items） 平均地使用空间。这也意味着你可以显式设置一个 块（item） 的宽度，而使其他项的大小自动进行调整。

xs=6

<Grid container spacing={3}>
  <Grid item xs>
    <Item>xs</Item>
  </Grid>
  <Grid item xs={6}>
    <Item>xs=6</Item>
  </Grid>
  <Grid item xs>
    <Item>xs</Item>
  </Grid>
</Grid>

复杂的栅格

以下的演示不遵循 Material Design 规范，但说明了如何使用栅格构建复杂的布局。

Standard license

Full resolution 1920x1080 • JPEG

ID: 1030114

Remove

$19.00

嵌套栅格

容器（container） 和 块（item） 属性分别是两个独立的布尔值。它们可以组合起来使用，使 Grid 组件既是一个 flex 容器，又是一个子容器。

通过将计算过的将 flex 或 inline-flex 的显示赋予给一个元素，你可以生成一个 flex 的 容器（container ） 。 Flex 容器（container）的流入子容器称为 flex ** 项（items**），它们的布局基于 flex 布局模型。

https://www.w3.org/TR/css-flexbox-1/#box-model

Item

<Grid container spacing={1}>
  <Grid container item spacing={3}>
    <FormRow />
  </Grid>
  <Grid container item spacing={3}>
    <FormRow />
  </Grid>
  <Grid container item spacing={3}>
    <FormRow />
  </Grid>
</Grid>

⚠️ Defining an explicit width to a Grid element that is flex container, flex item, and has spacing at the same time lead to unexpected behavior, avoid doing it:

<Grid spacing={1} container item xs={12}>

If you need to do such, remove one of the props.

设计局限

负边距

当我们使用负边距来实现项目之间的间距的时候，会有一个限制。如果负边距超出<body>元素，则会出现水平滚动。我们提供了 3 种解决方案：

不使用 spacing 的特性，并且在用户层面设置成spacing={0}。

将间距（padding）应用于父级元素，并且将至少一半的间距值赋予子级元素：

<body>
  <div style={{ padding: 20 }}>
    <Grid container spacing={5}>
      //...
    </Grid>
  </div>
</body>

在父元素上添加 overflow-x: hidden;。

white-space: nowrap;

我们规定了 flex 元素的默认属性值为 min-width：auto。当子元素使用 white-space: nowrap;时，则会出现位置的冲突。以下的案例直观的反应了这个问题：

<Grid item xs>
  <Typography noWrap>

若想让子项继续在容器内展示，您需要设置 min-width: 0。若想让子项继续在容器内展示，您需要设置 min-width: 0。

<Grid item xs zeroMinWidth>
  <Typography noWrap>

Truncation should be conditionally applicable on this long line of text as this is a much longer line than what the container can support.

direction: column | column-reverse

direction="column" 和 direction="column-reverse" 的容器不支持和断点有关的 xs, sm, md, lg，以及 xl 这几个属性。

它们决定在某个断点下组件占几个网格。它们是为了在 row 容器中使用 flex-basis 来控制 width，但这样做会影响 column 容器的高度。如果使用这些属性，可能会对 Grid 块元素的高度产生副作用。

CSS 栅格布局

Material-UI 本身不提供任何 CSS Grid 功能，但如下所示，您可以轻松使用 CSS Grid 来布局您的页面。

xs=8

xs=4

xs=8

<Box display="grid" gridTemplateColumns="repeat(12, 1fr)" gap={2}>
  <Box gridColumn="auto / span 8">
    <Item>xs=8</Item>
  </Box>
  <Box gridColumn="auto / span 4">
    <Item>xs=4</Item>
  </Box>
  <Box gridColumn="auto / span 4">
    <Item>xs=4</Item>
  </Box>
  <Box gridColumn="auto / span 8">
    <Item>xs=8</Item>
  </Box>
</Box>

API

<Grid />