跳到主要内容

Stack 堆叠布局 ​

uni-appH5微信小程序App

跨端 flex 堆叠布局,支持方向、间距、对齐和换行。

何时使用 ​

一组子项需要等距排列(表单字段、按钮组、卡片列表),尤其需要按断点调整间距时。

何时不使用 ​

复杂二维网格布局用 Row/Col 栅格;仅一两个元素时直接用 CSS。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Stack 堆叠布局 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
directionstring:'row' | 'column'"column"排列方向:row 水平、column 垂直
gapnumber0子项间距(px);支持响应式,如 { base: 8, md: 16 },未指定的断点向下取最近已定义值
alignstring:'start' | 'center' | 'end' | 'stretch'"stretch"交叉轴对齐
justifystring:'start' | 'center' | 'end' | 'between'"start"主轴对齐,between 即 space-between
wrapbooleanfalse是否允许换行

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>