Stack 堆叠布局
uni-appH5微信小程序App
跨端 flex 堆叠布局,支持方向、间距、对齐和换行。
何时使用
一组子项需要等距排列(表单字段、按钮组、卡片列表),尤其需要按断点调整间距时。
何时不使用
复杂二维网格布局用 Row/Col 栅格;仅一两个元素时直接用 CSS。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
direction | string:'row' | 'column' | "column" | 排列方向:row 水平、column 垂直 |
gap | number | 0 | 子项间距(px);支持响应式,如 { base: 8, md: 16 },未指定的断点向下取最近已定义值 |
align | string:'start' | 'center' | 'end' | 'stretch' | "stretch" | 交叉轴对齐 |
justify | string:'start' | 'center' | 'end' | 'between' | "start" | 主轴对齐,between 即 space-between |
wrap | boolean | false | 是否允许换行 |
Slots
| 名称 | 说明 |
|---|---|
default | 布局子项 |
示例
纵向间距
vue
<Stack :gap="12">
<view class="demo-box"><text>gap 12</text></view>
<view class="demo-box"><text>自动拉伸</text></view>
</Stack>横向排列
vue
<Stack direction="row" :gap="10" align="center">
<view class="demo-box"><text>A</text></view>
<view class="demo-box"><text>B</text></view>
<view class="demo-box"><text>C</text></view>
</Stack>换行堆叠
vue
<Stack direction="row" :gap="8" wrap>
<Tag>Vue 3</Tag>
<Tag>uni-app</Tag>
<Tag>uni-app X</Tag>
<Tag>Vite</Tag>
<Tag>TypeScript</Tag>
<Tag>Tokens</Tag>
</Stack>