Button 按钮组件

介绍

按钮用于触发一个操作,如提交表单。

安装

  1. import { createApp } from 'vue';
  2. import { Button } from '@nutui/nutui';
  3. const app = createApp();
  4. app.use(Button);

代码演示

按钮类型

按钮支持 defaultprimaryinfowarningdangersuccess 六种类型,默认为 default

  1. <nut-button type="primary">主要按钮</nut-button>
  2. <nut-button type="info">信息按钮</nut-button>
  3. <nut-button type="default">默认按钮</nut-button>
  4. <nut-button type="danger">危险按钮</nut-button>
  5. <nut-button type="warning">警告按钮</nut-button>
  6. <nut-button type="success">成功按钮</nut-button>

朴素按钮

通过 plain 属性将按钮设置为朴素按钮,朴素按钮的文字为按钮颜色,背景为白色。

  1. <nut-button plain type="primary">朴素按钮</nut-button>
  2. <nut-button plain type="info">朴素按钮</nut-button>

禁用状态

通过 disabled 属性来禁用按钮,禁用状态下按钮不可点击。

  1. <nut-button disabled type="primary">禁用状态</nut-button>
  2. <nut-button plain disabled type="info">禁用状态</nut-button>
  3. <nut-button plain disabled type="primary">禁用状态</nut-button>

按钮形状

通过 shape 属性设置按钮形状,支持圆形、方形按钮,默认为圆形。

  1. <nut-button shape="square" type="primary">方形按钮</nut-button>
  2. <nut-button type="info">圆形按钮</nut-button>

加载状态

  1. <nut-button loading></nut-button>
  2. <nut-button loading>加载中</nut-button>

图标按钮

  1. <nut-button shape="square" plain type="primary" icon="star-fill"></nut-button>
  2. <nut-button shape="square" type="primary" icon="star">收藏</nut-button>

按钮尺寸

支持 largenormalsmall 三种尺寸,默认为 normal

  1. <nut-button size="large" type="primary">大号按钮</nut-button>
  2. <nut-button type="primary">普通按钮</nut-button>
  3. <nut-button size="small" type="primary">小型按钮</nut-button>

块级元素

按钮在默认情况下为行内块级元素,通过 block 属性可以将按钮的元素类型设置为块级元素,常用来实现通栏按钮。

  1. <nut-button block type="primary">块级元素</nut-button>

自定义颜色

通过 color 属性可以自定义按钮的颜色。

  1. <nut-button color="#7232dd">单色按钮</nut-button>
  2. <nut-button color="#7232dd" plain>单色按钮</nut-button>
  3. <nut-button color="linear-gradient(to right, #ff6034, #ee0a24)">
  4. 渐变色按钮
  5. </nut-button>

API

Props

参数说明类型默认值
type类型,可选值为 primary info warning danger successStringdefault
size尺寸,可选值为 large smallStringnormal
shape形状,可选值为 squareStringround
color按钮颜色,支持传入 linear-gradient 渐变色String-
plain是否为朴素按钮Booleanfalse
disabled是否禁用按钮Booleanfalse
block是否为块级元素Booleanfalse
icon按钮图标,同Icon组件name属性String-
loading按钮loading状态Booleanfalse

Events

事件名说明回调参数
click点击按钮时触发event: MouseEvent

Button  按钮组件 - 图1