Skip to content

Button 按钮

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

基础用法

使用 typesize 和其他属性来定义按钮的样式。

朴素按钮

使用 plain 属性创建朴素按钮,朴素按钮具有透明背景和彩色边框。

按钮尺寸

使用 size 属性设置按钮大小,可选值为 tinysmallmediumlarge,默认为 medium

禁用状态

使用 disabled 属性禁用按钮。

加载状态

使用 loading 属性设置按钮加载状态。

图标按钮

使用 icon 属性设置按钮图标。

圆形按钮

使用 circle 属性将按钮设置为圆形。

自定义样式

按钮组件支持通过 customClasscustomStyle 属性自定义样式,同时也支持直接传递 classstyle 属性。

按钮组

使用 vk-button-group 将多个按钮组合在一起,形成一个按钮组。

属性继承

按钮组件支持标准的 HTML 属性继承,包括 data-*aria-* 等属性。

API

Props

名称类型默认值说明
type'default' | 'tertiary' | 'primary' | 'success' | 'info' | 'warning' | 'danger''default'按钮类型
size'tiny' | 'small' | 'medium' | 'large''medium'按钮大小
disabledbooleanfalse是否禁用
loadingbooleanfalse是否加载中
colorstring按钮颜色
textColorstring按钮文字颜色
customClassstring自定义类名
customStylestring | object自定义样式
tagstring'button'按钮标签
ghostbooleanfalse是否为幽灵按钮
roundbooleanfalse是否为圆角按钮
circlebooleanfalse是否为圆形按钮
strongbooleanfalse是否加粗
secondarybooleanfalse是否为次要按钮
tertiarybooleanfalse是否为第三级按钮
quaternarybooleanfalse是否为第四级按钮
focusablebooleantrue是否可聚焦
keyboardbooleantrue是否支持键盘操作
dashedbooleanfalse是否为虚线边框
iconstring | VNode图标名称或组件,支持 Iconify 图标名称(如 mdi:magnify)、图片 URL 或本地图片路径
iconPosition'left' | 'right''left'图标位置
wavebooleantrue是否有波纹效果
borderedbooleantrue是否有边框
plainbooleanfalse是否为朴素按钮(透明背景,有边框)

Events

名称参数说明
click(e: MouseEvent) => void点击按钮时触发

Slots

名称说明
default按钮内容

ButtonGroup API

ButtonGroup Props

ButtonGroup 组件没有特定的 props,它只是一个容器组件,用于将多个按钮组合在一起。

ButtonGroup Slots

名称说明
default按钮组内容,通常包含多个按钮

基于 MIT 协议发布