Button 按钮
uni-appH5微信小程序App
uni-app 跨端按钮。触发操作,支持主要/次要/幽灵/危险四种变体,内置加载态。
何时使用
用户触发即时操作。
何时不使用
纯导航跳转用链接。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
Button 按钮 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
variant | string:'primary' | 'secondary' | 'ghost' | 'danger' | "primary" | 按钮变体 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;移动端建议 md 或 lg |
disabled | boolean | false | 禁用 |
loading | boolean | false | 加载中,自动禁用并显示 spinner |
block | boolean | false | 撑满父容器宽度 |
nativeType | string:'button' | 'submit' | 'reset' | "button" | 原生 type 属性 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | Event | 点击时触发;disabled/loading 时不触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 按钮文本 |
示例
变体
vue
<view class="row">
<Button variant="primary">主要</Button>
<Button variant="secondary">次要</Button>
<Button variant="ghost">幽灵</Button>
<Button variant="danger">危险</Button>
</view>尺寸
vue
<view class="row">
<Button size="sm">小按钮</Button>
<Button size="md">中按钮</Button>
<Button size="lg">大按钮</Button>
</view>禁用与加载
vue
<view class="row">
<Button disabled>禁用</Button>
<Button loading>加载中</Button>
<Button variant="secondary" disabled>次要禁用</Button>
</view>通栏与图标
vue
<Button block variant="primary"><Icon name="plus" :size="16" /> 创建订单</Button>
<Button block variant="ghost" style="margin-top:10px"><Icon name="download" :size="16" /> 导出报表</Button>