---
title: "InlineLayout"

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/inline-layout'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/inline-layout.md'
---
# InlineLayout

InlineLayout 用于在多列上布局内容。 默认情况下，所有列的大小相同并填充可用的行内空间。当未显式设置足够的列时，内容不会换行，而是将它们添加为新列并填充剩余的内联空间。

## 预览

![InlineLayout.jpg](https://s2cdn.myshopline.com/slfs/op-new/177512391477988/InlineLayout.jpg)


## 示例代码

```tsx
render('Checkout::Dynamic::Render', (props) => {
  return (
    <View border="base">
      <View>
        <Text size="extraExtraLarge">InlineLayoutDemo</Text>
      </View>
      <InlineLayout spacing="tight" columns={[64, 'fill', 'auto']}>
        <Text>InlineLayoutDemo1</Text>
        <Text>InlineLayoutDemo1</Text>
        <Text>InlineLayoutDemo1</Text>
      </InlineLayout>

      <InlineLayout
        spacing="extraTight"
        blockAlignment="center"
        columns={['auto', 'auto', 'auto', 'auto']}
        >
        <Text>InlineLayoutDemo2</Text>
        <Text>InlineLayoutDemo2</Text>
        <Text>InlineLayoutDemo2</Text>
        <Text>InlineLayoutDemo2</Text>
      </InlineLayout>

      <InlineLayout columns={['fill', 'auto']} blockAlignment="center" spacing="tight">
        <Text>InlineLayoutDemo3</Text>
        <Text>InlineLayoutDemo3</Text>
      </InlineLayout>

      <InlineLayout columns={['auto', 'auto']} blockAlignment="center" spacing="tight">
        <Text>InlineLayoutDemo4</Text>
        <Text>InlineLayoutDemo4</Text>
      </InlineLayout>
    </View>
  );
});
```

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

### columns?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Columns](#columns-1)&gt;</code>

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

显示列数。

----

### inlineAlignment?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[InlineAlignment](#inlinealignment-1)&gt;</code>

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

主轴对齐方式，主轴为 [行内轴](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_box_alignment/Box_alignment_in_grid_layout#content_alignment)。

----

### blockAlignment?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[BlockAlignment](#blockalignment-1)&gt;</code>

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

副轴对齐，副轴为 [网格区域内的块向轴](https://developer.mozilla.org/en-US/docs/Web/CSS/align-items)。

----

### spacing?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[Spacing](#spacing-1) | [[Spacing](#spacing-1), [Spacing](#spacing-1)]\></code> <code data-code-white>默认值：base</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" />

内边距。

----

## 类型说明
### BlockAlignment
<code data-code-gray>start</code> <code data-code-gray>center</code> <code data-code-gray>end</code> <code data-code-gray>baseline</code>
<Margin p="8px" m="8px" />
----

### InlineAlignment
<code data-code-gray>start</code> <code data-code-gray>center</code> <code data-code-gray>end</code>
<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" />
----

### Columns
<code data-code-gray>[GridItemSize[]](#griditemsize)</code>
<code data-code-gray>[GridItemSize](#griditemsize)</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%。
----
### 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" />
----