---
title: "Grid"

doc_type: static
doc_category: static
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/grid'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/grid.md'
---
# Grid

Gird 用于以行和列的矩阵形式布局内容。

## 预览

![Grid&GridItem.jpg](https://s2cdn.myshopline.com/slfs/op-new/177512191416109/Grid&GridItem.jpg)

## 示例代码

```jsx
render('Checkout::Dynamic::Render', (root) => {
  return <>
    <Grid
      columns={[100, 'fill', '20%']}
      rows={['auto', 100, 'auto']}
      spacing="loose"
      padding="loose"
      >
      <GridItem columnSpan={3}>
        <View> Grid: </View>
      </GridItem>
      <View border="base" padding="base">
        100 / 100
      </View>
      <View border="base" padding="base">
        fill / 100
      </View>
      <View border="base" padding="base">
        20% / 100
      </View>
      <GridItem columnSpan={2}>
        <View border="base" padding="base">
          100 + fill / auto
        </View>
      </GridItem>
      <View border="base" padding="base">
        20% / auto
      </View>
    </Grid>
  </>;
});
```

## GridProps
> **提示**
>
> 标注 `?` 的属性为可选，未标注 `?` 的属性为必选。

### columns?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[GridItemSize](#griditemsize)[] | [GridItemSize](#griditemsize)\></code>

<Margin p="8px" m="8px" />

布局中每一列的尺寸。

----

### rows?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[GridItemSize](#griditemsize)[] | [GridItemSize](#griditemsize)\></code>

<Margin p="8px" m="8px" />

布局中每一行的尺寸。

----

### spacing?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[Spacing](#spacing-1) | [[Spacing](#spacing-1), [Spacing](#spacing-1)]\></code>

<Margin p="8px" m="8px" />

子元素之间的间距；传两个的情况，第一个为行间距，第二个为列间距。

----

### border?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[MaybeShorthandProperty](#maybeshorthandproperty)\<[BorderStyle](#borderstyle)\>\></code>

<Margin p="8px" m="8px" />

边框类型，<code data-code-gray>MaybeShorthandProperty</code> 代表支持传入个数可以为 1 或 2 或 4。
- 传入 1 个值，作用所有边框。
- 传入 2 个值，第一个值作用上下边框，第二个值作用左右边框。
- 传入 4 个值，分别作用上右下左。

----

### cornerRadius?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[MaybeShorthandProperty](#maybeshorthandproperty)&lt;[CornerRadius](#cornerradius-1)&gt;\></code>

<Margin p="8px" m="8px" />

圆角大小。

----

### padding?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[MaybeShorthandProperty](#maybeshorthandproperty)&lt;[Spacing](#spacing-1)&gt;\></code>

<Margin p="8px" m="8px" />

布局的内边距。

----

### overflow?
<code data-code-gray>hidden</code> <code data-code-gray>visible</code> <code data-code-white>默认值：visible</code>

<Margin p="8px" m="8px" />

超出展示或者隐藏。

----

### inlineAlignment?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;'start' | 'center' | 'end'&gt;</code>

<Margin p="8px" m="8px" />

横轴元素对齐方式。

----

### blockAlignment?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;'start' | 'center' | 'end'｜'baseline'&gt;</code>

<Margin p="8px" m="8px" />

纵轴元素对齐方式。

----

## 类型说明
### GridItemSize
<code data-code-gray>auto</code>
<code data-code-gray>fill</code>
<code data-code-gray>number</code>
<code data-code-gray>$\{number\}fr</code>
<code data-code-gray>$\{number\}%</code>
<Margin p="8px" m="8px" />
<Margin p="8px" m="8px" />

+ <code data-code-gray>auto</code>：由内容撑开，不会主动填满剩余空间。
+ <code data-code-gray>$\{number\}fr</code>：均分剩余空间，<code data-code-gray>number</code>表示占其中的几份。
+ <code data-code-gray>fill</code>：像 <code data-code-gray>1fr</code> 一样填满空间，但内容超长时能收缩到 0，防止溢出。
+ <code data-code-gray>number</code>：按照配置的值进行内容空间分配，如配置 <code data-code-gray>30</code>  则占据 30px。
+ <code data-code-gray>$\{number\}%</code>：按照配置的百分比进行内容空间的占位，如配置 <code data-code-gray>30%</code> 则占据内容空间的 30%。

<Margin p="8px" m="8px" />
----

### Spacing
<code data-code-gray>none</code> <code data-code-gray>base</code> <code data-code-gray>extraTight</code> <code data-code-gray>tight</code> <code data-code-gray>loose</code> <code data-code-gray>extraLoose</code>
<Margin p="8px" m="8px" />
----

### BorderStyle
<code data-code-gray>base</code> <code data-code-gray>dotted</code> <code data-code-gray>none</code>
<Margin p="8px" m="8px" />
----

### CornerRadius
<code data-code-gray>base</code> <code data-code-gray>small</code> <code data-code-gray>large</code> <code data-code-gray>fullyRounded</code> <code data-code-gray>none</code>
<Margin p="8px" m="8px" />
----
### MaybeResponsiveConditionalStyle
<code data-code-gray>T | [ConditionalStyle](#conditionalstyle)\<T, [ViewportSizeCondition](#viewportsizecondition)\></code>
<Margin p="8px" m="8px" />

+ 普通值示例：<code data-code-gray>base</code>
+ 条件值示例：<code data-code-gray>\{ defaultValue: 'tight', conditionals: [\{ conditions: \{ viewportInlineSize: \{ min: 'medium' } }, value: 'loose' }] }</code>

----

### ConditionalStyle
<code data-code-gray>\{ defaultValue?: T; conditionals: [ConditionalValue](#conditionalvalue)&lt;T, [Conditions](#conditions)&gt;[] }</code>
<Margin p="8px" m="8px" />

----

### ConditionalValue
<code data-code-gray>\{ conditions: [Conditions](#conditions); value: T }</code>
<Margin p="8px" m="8px" />

----

### Conditions
<code data-code-gray>[AtLeastOne](#atleastone)&lt;[ViewportSizeCondition](#viewportsizecondition)&gt;</code>
<Margin p="8px" m="8px" />

----

### ViewportSizeCondition
<code data-code-gray>\{ viewportInlineSize: \{ min: T } }</code>
<Margin p="8px" m="8px" />

----

### AtLeastOne
<code data-code-gray>Partial&lt;T&gt; &amp; U[keyof U]</code>
<Margin p="8px" m="8px" />

----

### ViewportInlineSize
<code data-code-gray>extraSmall</code> <code data-code-gray>small</code> <code data-code-gray>medium</code> <code data-code-gray>large</code>
<Margin p="8px" m="8px" />

参考 [视口断点](https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/component-utilities/style-helper.md#视口断点)。

----
### MaybeShorthandProperty
<code data-code-gray>T | [ShorthandProperty](#shorthandproperty)&lt;T&gt;</code>
<Margin p="8px" m="8px" />

----

### ShorthandProperty
<code data-code-gray>[T, T]</code><code data-code-gray>[T, T, T, T]</code>
<Margin p="8px" m="8px" />
----