跳到主要内容

Col 栅格列 ​

uni-appH5微信小程序App

24 栅格布局列,支持占比、偏移和推拉。

何时使用 ​

作为 Row 的子级进行 24 栅格分栏;缩窄视口可看到响应式断点切换。

何时不使用 ​

脱离 Row 单独使用无意义(gutter 依赖 Row 注入)。

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

9:41
Col 栅格列 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
spannumber24占据列数(0-24),映射为 rn-col--xs-<n> 基线类
offsetnumber0左侧偏移列数(0-24),margin-left 百分比
pushnumber0向右移动列数(相对定位,不挤占其他列)
pullnumber0向左移动列数(相对定位)
xsnumber-<640px 时的 span,缺省沿用 span
smnumber-≥640px 时的 span
mdnumber-≥768px 时的 span
lgnumber-≥1024px 时的 span
xlnumber-≥1280px 时的 span

Slots ​

名称说明
default列内容

示例 ​

偏移 ​

vue
<Row :gutter="8">
  <Col :span="8"><view class="demo-box"><text>8</text></view></Col>
  <Col :span="8" :offset="8"><view class="demo-box"><text>offset 8</text></view></Col>
</Row>

响应式占位 ​

vue
<Row :gutter="8">
  <Col :span="24"><view class="demo-box"><text>整行</text></view></Col>
  <Col :span="12"><view class="demo-box"><text>半行</text></view></Col>
  <Col :span="12"><view class="demo-box"><text>半行</text></view></Col>
</Row>

push / pull 换位 ​

vue
<Row :gutter="8">
  <Col :span="12" :push="12"><view class="demo-box"><text>左 → 右</text></view></Col>
  <Col :span="12" :pull="12"><view class="demo-box"><text>右 → 左</text></view></Col>
</Row>

响应式断点 ​

vue
<Row :gutter="8">
  <Col :xs="24" :sm="12" :md="8" :lg="6"><view class="demo-box"><text>响应式</text></view></Col>
  <Col :xs="24" :sm="12" :md="8" :lg="6"><view class="demo-box"><text>响应式</text></view></Col>
</Row>