Skip to content

Box

A basic layout container component that provides convenient configuration for styles like padding, margin, background color, border radius, and shadow, with Flex layout support.

Platform Compatibility

App(vue)App(nvue)H5Mini Programs

Code Examples

Basic Usage

padding controls inner spacing, bg-color controls background color.

html
<see-box padding="20rpx" bg-color="#f5f5f5">
  <text>This is a box with padding and background color</text>
</see-box>

Flex Layout

Use direction, justify, align and other props to quickly implement Flex layout.

html
<see-box direction="row" justify="space-between" align="center">
  <text>Left</text>
  <text>Center</text>
  <text>Right</text>
</see-box>

Shadow Effect

The shadow prop supports three shadow sizes: small / medium / large.

html
<see-box padding="30rpx" radius="12rpx" shadow="medium">
  <text>Card with shadow</text>
</see-box>

API

Props

PropDescriptionTypeDefaultAccepted Values
paddingInner paddingstring'0'CSS padding value
marginOuter marginstring'0'CSS margin value
bg-colorBackground colorstring-CSS color value
widthWidthstring'100%'CSS width value
heightHeightstring-CSS height value
radiusBorder radiusstring'0'CSS radius value
shadowShadow'small' | 'medium' | 'large'-small / medium / large
borderBorder widthstring'0'CSS width value
border-colorBorder colorstringvar(--see-border-color)CSS color value
directionFlex direction'row' | 'column''row'row / column
wrapFlex wrapstring'nowrap'nowrap / wrap / wrap-reverse
justifyMain axis alignmentstring'flex-start'flex-start / center / space-between, etc.
alignCross axis alignmentstring'stretch'flex-start / center / stretch, etc.
gapSpacing between flex itemsstring'0'CSS gap value

Slots

NameDescription
defaultBox content

Liao ICP No. 2025070134