Button 按钮
WebH5
按钮。触发操作,支持主要/次要/幽灵/危险四种变体,内置加载态与移动端触摸反馈。
何时使用
用户触发即时操作:提交表单、确认、跳转。
何时不使用
纯导航跳转用链接;一组平级操作超过 3 个时考虑收到菜单里。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
variant | string:'primary' | 'secondary' | 'ghost' | 'danger' | "primary" | 按钮变体:primary 主操作、secondary 次操作、ghost 边框型、danger 危险操作 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;移动端建议 md 或 lg(触摸目标 ≥ 36px) |
disabled | boolean | false | 禁用 |
loading | boolean | false | 加载中,自动禁用并显示 spinner |
block | boolean | false | 撑满父容器宽度,移动端表单底部按钮常用 |
nativeType | string:'button' | 'submit' | 'reset' | "button" | 原生 type 属性 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | MouseEvent | 点击时触发;disabled/loading 时不触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 按钮文本或内容 |
示例
变体
示例加载中…
<Stack direction="row" :gap="12" wrap align="center">
<Button variant="primary">主要按钮</Button>
<Button variant="secondary">次要按钮</Button>
<Button variant="ghost">幽灵按钮</Button>
<Button variant="danger">危险按钮</Button>
</Stack>尺寸
示例加载中…
<Stack :gap="16">
<Stack direction="row" :gap="12" wrap align="center">
<Button size="sm" variant="primary">小号主按钮</Button>
<Button size="sm" variant="secondary">小号次按钮</Button>
<Button size="sm" variant="ghost">小号幽灵</Button>
<Button size="sm" variant="danger">小号危险</Button>
</Stack>
<Stack direction="row" :gap="12" wrap align="center">
<Button size="md" variant="primary">中号主按钮</Button>
<Button size="md" variant="secondary">中号次按钮</Button>
<Button size="md" variant="ghost">中号幽灵</Button>
<Button size="md" variant="danger">中号危险</Button>
</Stack>
<Stack direction="row" :gap="12" wrap align="center">
<Button size="lg" variant="primary">大号主按钮</Button>
<Button size="lg" variant="secondary">大号次按钮</Button>
<Button size="lg" variant="ghost">大号幽灵</Button>
<Button size="lg" variant="danger">大号危险</Button>
</Stack>
</Stack>加载态
示例加载中…
<Stack direction="row" :gap="12" wrap align="center">
<Button loading variant="primary">保存中</Button>
<Button loading variant="secondary">上传中</Button>
<Button loading variant="ghost">刷新中</Button>
<Button loading variant="danger">删除中</Button>
</Stack>禁用态
示例加载中…
<Stack direction="row" :gap="12" wrap align="center">
<Button disabled variant="primary">已提交</Button>
<Button disabled variant="secondary">已收藏</Button>
<Button disabled variant="ghost">无权限</Button>
<Button disabled variant="danger">不可删除</Button>
</Stack>通栏按钮
示例加载中…
<Stack :gap="12" style="max-width:360px;">
<Button block size="lg">提交订单</Button>
<Button block variant="secondary" size="lg">保存草稿</Button>
<Button block variant="ghost">返回修改</Button>
</Stack>操作栏按钮组
示例加载中…
<Stack :gap="20">
<Stack direction="row" :gap="12" wrap align="center">
<Button variant="primary">确认审核</Button>
<Button variant="ghost">退回修改</Button>
</Stack>
<Stack direction="row" :gap="12" wrap align="center">
<Button variant="primary" size="sm">新建商品</Button>
<Button variant="secondary" size="sm">批量导出</Button>
<Button variant="danger" size="sm" disabled>批量删除</Button>
</Stack>
</Stack>表单提交(nativeType)
示例加载中…
<form @submit.prevent style="max-width:360px;padding:var(--rn-spacing-4);border:1px solid var(--rn-color-border);border-radius:var(--rn-radius-md);">
<div :style="{ marginBottom: 'var(--rn-spacing-4)' }">
<div :style="{ fontSize:'var(--rn-font-size-sm)',color:'var(--rn-color-text-secondary)',marginBottom:'var(--rn-spacing-1)' }">用户名</div>
<input placeholder="请输入用户名" :style="{ width:'100%',padding:'var(--rn-spacing-2) var(--rn-spacing-3)',border:'1px solid var(--rn-color-border)',borderRadius:'var(--rn-radius-sm)',fontSize:'var(--rn-font-size-md)',boxSizing:'border-box' }" />
</div>
<Stack direction="row" :gap="12">
<Button native-type="submit" variant="primary">登录</Button>
<Button native-type="reset" variant="ghost">重置</Button>
</Stack>
</form>图标按钮
示例加载中…
<Stack :gap="12">
<Stack direction="row" :gap="12" wrap align="center">
<Button variant="primary"><Icon name="plus" :size="16" /> 新建项目</Button>
<Button variant="secondary"><Icon name="upload" :size="16" /> 上传文件</Button>
<Button variant="ghost"><Icon name="download" :size="16" /> 下载报表</Button>
<Button variant="danger"><Icon name="trash" :size="16" /> 删除</Button>
</Stack>
<Stack direction="row" :gap="8" wrap align="center">
<Button variant="ghost" size="sm" style="min-width:var(--rn-size-control-sm);padding:0;"><Icon name="search" :size="16" /></Button>
<Button variant="ghost" size="sm" style="min-width:var(--rn-size-control-sm);padding:0;"><Icon name="edit" :size="16" /></Button>
<Button variant="ghost" size="sm" style="min-width:var(--rn-size-control-sm);padding:0;"><Icon name="trash" :size="16" /></Button>
</Stack>
</Stack>点击事件
示例加载中…
<Stack :gap="12">
<Stack direction="row" :gap="12" wrap align="center">
<Button variant="primary" @click="console.log('下单')">立即下单</Button>
<Button variant="secondary" @click="console.log('加入购物车')">加入购物车</Button>
<Button variant="danger" @click="console.log('清空')">清空购物车</Button>
</Stack>
<div :style="{ fontSize:'var(--rn-font-size-xs)',color:'var(--rn-color-text-placeholder)' }">点击按钮后查看控制台输出</div>
</Stack>业务场景:电商结算
示例加载中…
<Stack :gap="16" style="max-width:400px;">
<div :style="{ padding:'var(--rn-spacing-4)',border:'1px solid var(--rn-color-border)',borderRadius:'var(--rn-radius-md)',background:'var(--rn-color-bg-soft)' }">
<Stack :gap="12">
<Stack direction="row" justify="space-between">
<span :style="{ color:'var(--rn-color-text-secondary)' }">商品合计</span>
<span>¥ 2,399.00</span>
</Stack>
<Stack direction="row" justify="space-between">
<span :style="{ color:'var(--rn-color-text-secondary)' }">运费</span>
<span>免运费</span>
</Stack>
<Divider />
<Stack direction="row" justify="space-between">
<span :style="{ fontWeight:'var(--rn-font-weight-semibold)' }">实付金额</span>
<span :style="{ fontWeight:'var(--rn-font-weight-bold)',fontSize:'var(--rn-font-size-xl)',color:'var(--rn-color-danger)' }">¥ 2,399.00</span>
</Stack>
</Stack>
</div>
<Button block size="lg">提交订单</Button>
<Button block variant="ghost">返回购物车</Button>
</Stack>Playground
加载中…
primary
md
button
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Button 文档(含手机预览)。