Button 按钮 ​

常用的操作按钮。

基础用法 ​

使用 type、plain、round、circle 、 link 和 text 来定义按钮的样式。使用 disabled 属性来控制按钮是否为禁用状态,该属性接受一个 Boolean 类型的值,可通过示例顶部开关统一切换查看各形态的禁用效果。通过 tight 属性设置紧凑版,调整左右间距均为 8px,适用于空间位置不够时使用。

禁用状态:
默认样式
轻量按钮:plain: boolean
链接按钮:link: boolean
文字按钮:由于 type 属性会同时控制按钮的样式, 因此我们通过一个新的 API text: boolean 来控制文字按钮
圆形按钮:circle: boolean
圆角按钮:round: boolean
🎉 紧凑模式:tight: Boolean 默认是开启的

智能按钮组(根据容器宽度自动排版、空间不够时折叠) 0.0.8 ​

使用 smart 属性额外配置智能按钮组,根据容器宽度自动排版、空间不够时折叠到”更多“中。使用 discrete 设置按钮组是否离散,使用 position 设置左/右侧。权限控制:通过 inactive-ids 属性设置哪些按钮不显示,需要先对按钮设置 visible-id 属性。”更多“文案经国际化生成(el.buttonGroup.more),可通过 more-button-text 自定义或通过 ConfigProvider 切换语言。

宽度:400px
药品数据

智能按钮组(根据个数判断是否折叠) 0.0.8 ​

通过 max-visible 按按钮个数判断是否折叠,超出部分收起到「更多」下拉中,优先级高于容器宽度测量。设置 max-visible 为 0 会把所有业务按钮折叠进「更多」(只显示「更多」下拉)。权限控制:先给 w-button 设置 visible-id,再通过 inactive-ids 指定需要隐藏的按钮 id 列表。可通过 more-button-text 自定义「更多」按钮文案,未设置时取国际化 el.buttonGroup.more。

药品数据

防抖、全局防抖 0.0.8 ​

使用 debounce 属性额外配置防抖,通过 debounce-time 来配置防抖时间,单位为毫秒。

开启防抖
输入防抖时间:

加载状态按钮 ​

点击按钮来加载数据,并向用户反馈加载状态。

通过设置 loading 属性为 true 来显示加载中状态。

TIP

您可以使用 loading 插槽、loading-ball 属性或 loadingIcon属性自定义您的 loading 图标

ps: loading 插槽优先级高于loadingIcon属性

调整尺寸 ​

除了默认的大小,按钮组件还提供了几种额外的尺寸可供选择,以便适配不同的场景。

使用 size 属性额外配置尺寸,可使用 large、small 和 mini 三种值。

图标按钮 ​

使用图标为按钮添加更多的含义。 你也可以单独使用图标不添加文字来节省显示区域占用。

使用 icon 属性来为按钮添加图标。 您可以在我们的 Icon 组件中找到所需图标。 通过向右方添加<i>标签来添加图标, 你也可以使用自定义图标。

按钮组 ​

以按钮组的方式出现,常用于多项类似操作。

使用 <w-button-group> 对多个按钮分组。您可以使用 direction 属性来控制按钮组的排列方向 1.3.4,智能按钮组(smart)下不生效。

Tag ​

您可以自定义元素标签。例如,按钮,div,路由链接,nuxt 链接。

div
a

自定义颜色 ​

您可以自定义按钮的颜色。

我们将自动计算按钮处于 hover 和 active 状态时的颜色。

通栏按钮 1.3.4 ​

long 属性:使按钮宽度随容器铺满,常用于表单提交、弹窗底部操作区等通栏场景。

悬浮提示 1.3.4 ​

tip 属性:传入提示文字内容后按钮会被 w-tooltip 包裹(默认 hover 触发),配合 tip-placement 指定弹层位置;禁用状态的按钮同样可以展示提示。

自定义禁用透明度 1.3.4 ​

disabled-opacity 属性自定义按钮在禁用或加载中状态下的透明度,仅 disabled / loading 状态生效,未传值时不覆盖基线样式。

Button API ​

Attributes ​

参数说明类型默认值
size尺寸enum—
type按钮类型,在设置color时,后者优先。enum—
plain是否为朴素按钮booleanfalse
text是否为文字按钮booleanfalse
bg是否显示文字按钮背景颜色booleanfalse
link是否为链接按钮booleanfalse
round是否为圆角按钮booleanfalse
circle是否为圆形按钮booleanfalse
loading是否为加载中状态booleanfalse
loading-icon自定义加载中状态图标组件string / ComponentLoading
disabled按钮是否为禁用状态booleanfalse
icon图标组件string / Component—
autofocus原生 autofocus 属性booleanfalse
native-type原生 type 属性enumbutton
auto-insert-space自动在两个中文字符之间插入空格boolean—
color自定义按钮颜色, 并自动计算 hover 和 active 触发后的颜色string—
darkdark 模式, 意味着自动设置 color 为 dark 模式的颜色booleanfalse
tag自定义元素标签string / Componentbutton
tight是否为紧凑按钮booleantrue
debounce是否开启防抖booleanfalse
debounce-time防抖时间number1000
loading-ball是否显示加载中小球弹跳booleanfalse
winmonitor 1.0.2是否开启按钮点击上报日志booleantrue
disabled-opacity按钮禁用或加载中时的自定义透明度,仅 disabled / loading 状态生效;未传值时不输出 opacity 样式number—
long按钮宽度随着容器宽度进行适配booleanfalse
tip提示文字内容(文本而非开关),非空时按钮被 w-tooltip 包裹,触发方式为 hoverstring''
tip-placement提示文字位置,仅在 tip 非空时透传给 tooltip 的 placement,支持 popper 全部取值enumtop
visible-id 0.0.8按钮唯一标识,供父级智能按钮组通过 inactive-ids 控制是否显示string—

Slots ​

插槽名说明
default自定义默认内容
loading自定义加载中组件
icon自定义图标组件

Exposes ​

属性名说明类型
ref按钮 html 元素object
size按钮尺寸object
type按钮类型object
disabled按钮已禁用object
shouldAddSpace是否在两个字符之间插入空格object

ButtonGroup API ​

Attributes ​

参数说明类型默认值
size用于控制该按钮组内按钮的大小enum—
type用于控制该按钮组内按钮的类型enum—
direction按钮组排列方向,智能按钮组(smart)下不生效enumhorizontal
smart是否开启智能按钮组booleanfalse
discrete是否离散按钮组booleanfalse
position按钮组位置enumleft
smart-link是否开启智能链接按钮组booleanfalse
smart-type智能按钮组类型enum—
inactive-ids 0.0.8智能按钮组中需要隐藏的按钮 visible-id 列表(需先给按钮设置 visible-id)string[][]
max-visible 0.0.8智能按钮组最大可见按钮数,超出部分折叠到「更多」中;未设置时按容器宽度自动折叠,设置为 >= 0 的数字时按数量折叠(0 表示全部折叠)number—
more-button-text 0.0.8自定义「更多」按钮文案,未设置时取国际化 el.buttonGroup.morestring—

Slots ​

插槽名说明子标签
default自定义按钮组内容Button

Copyright 2025 Winning Health 版权所有