Button 按钮
常用的操作按钮。
基础用法
使用 type、plain、round、circle 、 link 和 text 来定义按钮的样式。使用 disabled 属性来控制按钮是否为禁用状态,该属性接受一个 Boolean 类型的值,可通过示例顶部开关统一切换查看各形态的禁用效果。通过 tight 属性设置紧凑版,调整左右间距均为 8px,适用于空间位置不够时使用。
智能按钮组(根据容器宽度自动排版、空间不够时折叠) 0.0.8
使用 smart 属性额外配置智能按钮组,根据容器宽度自动排版、空间不够时折叠到”更多“中。使用 discrete 设置按钮组是否离散,使用 position 设置左/右侧。权限控制:通过 inactive-ids 属性设置哪些按钮不显示,需要先对按钮设置 visible-id 属性。”更多“文案经国际化生成(el.buttonGroup.more),可通过 more-button-text 自定义或通过 ConfigProvider 切换语言。
智能按钮组(根据个数判断是否折叠) 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 链接。
自定义颜色
您可以自定义按钮的颜色。
我们将自动计算按钮处于 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 | 是否为朴素按钮 | boolean | false |
| text | 是否为文字按钮 | boolean | false |
| bg | 是否显示文字按钮背景颜色 | boolean | false |
| link | 是否为链接按钮 | boolean | false |
| round | 是否为圆角按钮 | boolean | false |
| circle | 是否为圆形按钮 | boolean | false |
| loading | 是否为加载中状态 | boolean | false |
| loading-icon | 自定义加载中状态图标组件 | string / Component | Loading |
| disabled | 按钮是否为禁用状态 | boolean | false |
| icon | 图标组件 | string / Component | — |
| autofocus | 原生 autofocus 属性 | boolean | false |
| native-type | 原生 type 属性 | enum | button |
| auto-insert-space | 自动在两个中文字符之间插入空格 | boolean | — |
| color | 自定义按钮颜色, 并自动计算 hover 和 active 触发后的颜色 | string | — |
| dark | dark 模式, 意味着自动设置 color 为 dark 模式的颜色 | boolean | false |
| tag | 自定义元素标签 | string / Component | button |
| tight | 是否为紧凑按钮 | boolean | true |
| debounce | 是否开启防抖 | boolean | false |
| debounce-time | 防抖时间 | number | 1000 |
| loading-ball | 是否显示加载中小球弹跳 | boolean | false |
| winmonitor 1.0.2 | 是否开启按钮点击上报日志 | boolean | true |
| disabled-opacity | 按钮禁用或加载中时的自定义透明度,仅 disabled / loading 状态生效;未传值时不输出 opacity 样式 | number | — |
| long | 按钮宽度随着容器宽度进行适配 | boolean | false |
| tip | 提示文字内容(文本而非开关),非空时按钮被 w-tooltip 包裹,触发方式为 hover | string | '' |
| tip-placement | 提示文字位置,仅在 tip 非空时透传给 tooltip 的 placement,支持 popper 全部取值 | enum | top |
| 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)下不生效 | enum | horizontal |
| smart | 是否开启智能按钮组 | boolean | false |
| discrete | 是否离散按钮组 | boolean | false |
| position | 按钮组位置 | enum | left |
| smart-link | 是否开启智能链接按钮组 | boolean | false |
| 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.more | string | — |
Slots
| 插槽名 | 说明 | 子标签 |
|---|---|---|
| default | 自定义按钮组内容 | Button |
Copyright 2025 Winning Health 版权所有

