Col 栅格列
uni-appH5微信小程序App
24 栅格布局列,支持占比、偏移和推拉。
何时使用
作为 Row 的子级进行 24 栅格分栏;缩窄视口可看到响应式断点切换。
何时不使用
脱离 Row 单独使用无意义(gutter 依赖 Row 注入)。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
span | number | 24 | 占据列数(0-24),映射为 rn-col--xs-<n> 基线类 |
offset | number | 0 | 左侧偏移列数(0-24),margin-left 百分比 |
push | number | 0 | 向右移动列数(相对定位,不挤占其他列) |
pull | number | 0 | 向左移动列数(相对定位) |
xs | number | - | <640px 时的 span,缺省沿用 span |
sm | number | - | ≥640px 时的 span |
md | number | - | ≥768px 时的 span |
lg | number | - | ≥1024px 时的 span |
xl | number | - | ≥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>