---
title: "View"

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

View 是一个通用的容器组件，它能让其内部内容保持原始大小，不会被强制拉伸。该组件在布局组件（如 [Grid](https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/grid.md)、[BlockStack](https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/block-stack.md)、[InlineLayout](https://developer.shopline.com/zh-hans-cn/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/inline-layout.md)）中非常适用，可以避免布局组件自动调整子组件大小带来的意外变形。

## 预览
![View.jpg](https://s2cdn.myshopline.com/slfs/op-new/177512440330475/View.jpg)

## 示例代码
```tsx
render('Checkout::Dynamic::Render', (props) => {
  return (
    <View border="base">
        View
    </View>
  );
});
```


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


### display?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Display](#display-1)&gt;</code><code data-code-white>默认值：block</code>


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

排列方向。

----

### maxBlockSize?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Sizing](#sizing)&gt;</code>

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

最大纵向尺寸。

----

### maxInlineSize?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Sizing](#sizing)&gt;</code>

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

最大横向尺寸。

----

### minBlockSize?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Sizing](#sizing)&gt;</code>

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

最小纵向尺寸。

----

### minInlineSize?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)&lt;[Sizing](#sizing)&gt;</code>

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

最小横向尺寸。

----

### opacity?
<code data-code-gray>[Opacity](#opacity-1)</code>

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

透明度。

----

### overflow?
<code data-code-gray>[Overflow](#overflow-1)</code>

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

内容溢出控制。

----

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

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

边框样式。

----

### 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)&gt;\></code>

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

内边距。

----

### borderWidth?
<code data-code-gray>[MaybeResponsiveConditionalStyle](#mayberesponsiveconditionalstyle)\<[MaybeShorthandProperty](#maybeshorthandproperty)&lt;[BorderWidth](#borderwidth-1)&gt;\></code>

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

边框宽度（需要先开启边框 <code data-code-gray>border</code>），支持自定义宽度如 <code data-code-gray>20</code>。

----

### backgroundColor
<code data-code-gray>string</code>

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

支持输入自定义背景颜色，如：
- 颜色名称：<code data-code-gray>red</code>
- Hex：<code data-code-gray>#FF0000</code>
- RGB：<code data-code-gray>rgb(255, 0, 0)</code>
- RGBA：<code data-code-gray>rgba(255, 0, 0, 0.5)</code>
- HSL：<code data-code-gray>hsl(0, 100%, 50%)</code>
- HSLA：<code data-code-gray>hsla(0, 100%, 50%, 0.5)</code>

> **注意**
>
> 输入非法值将会设置无效。

----

### borderColor
<code data-code-gray>string</code>

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

支持输入自定义边框颜色（需要先开启边框 <code data-code-gray>border</code>），如：
- 颜色名称：<code data-code-gray>red</code>
- Hex：<code data-code-gray>#FF0000</code>
- RGB：<code data-code-gray>rgb(255, 0, 0)</code>
- RGBA：<code data-code-gray>rgba(255, 0, 0, 0.5)</code>
- HSL：<code data-code-gray>hsl(0, 100%, 50%)</code>
- HSLA：<code data-code-gray>hsla(0, 100%, 50%, 0.5)</code>

> **注意**
>
> 输入非法值将会设置无效。

----

## 类型说明
### Display
<code data-code-gray>block</code> <code data-code-gray>inline</code>
<Margin p="8px" m="8px" />
<Margin p="8px" m="8px" />
+ <code data-code-gray>block</code>：纵向排列
+ <code data-code-gray>inline</code>：横向排列
----

### Sizing
<code data-code-gray>number</code>
<code data-code-gray>$\{number\}%</code>
<code data-code-gray>fill</code>
<Margin p="8px" m="8px" />
<Margin p="8px" m="8px" />
----

### Opacity
<code data-code-gray>10</code>
<code data-code-gray>20</code>
<code data-code-gray>30</code>
<code data-code-gray>40</code>
<code data-code-gray>50</code>
<code data-code-gray>60</code>
<code data-code-gray>70</code>
<code data-code-gray>80</code>
<code data-code-gray>90</code>
<Margin p="8px" m="8px" />
----

### Overflow
<code data-code-gray>hidden</code> <code data-code-gray>visible</code>
<Margin p="8px" m="8px" />
<Margin p="8px" m="8px" />
+ <code data-code-gray>hidden</code>：溢出内容隐藏
+ <code data-code-gray>visible</code>：溢出内容可见
----

### BorderStyle
<code data-code-gray>base</code> <code data-code-gray>dotted</code> <code data-code-gray>none</code>
<Margin p="8px" m="8px" />
<Margin p="8px" m="8px" />
+ <code data-code-gray>base</code>：实线边框
+ <code data-code-gray>dotted</code>：虚线边框
+ <code data-code-gray>none</code>：无边框

----

### 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" />
----
### 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" />
----
### BorderWidth
<code data-code-gray>base</code> <code data-code-gray>medium</code> <code data-code-gray>number</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" />
----