跳到主要内容

Button 按钮 ​

uni-appH5微信小程序App

uni-app 跨端按钮。触发操作,支持主要/次要/幽灵/危险四种变体,内置加载态。

何时使用 ​

用户触发即时操作。

何时不使用 ​

纯导航跳转用链接。

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

9:41
Button 按钮 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
variantstring:'primary' | 'secondary' | 'ghost' | 'danger'"primary"按钮变体
sizestring:'sm' | 'md' | 'lg'"md"尺寸;移动端建议 md 或 lg
disabledbooleanfalse禁用
loadingbooleanfalse加载中,自动禁用并显示 spinner
blockbooleanfalse撑满父容器宽度
nativeTypestring:'button' | 'submit' | 'reset'"button"原生 type 属性

Events ​

名称载荷说明
clickEvent点击时触发;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>