Button 按钮

常用的操作按钮。

基础用法

使用 typeplainoutlinerounddashedcircle 属性来定义按钮的样式。

禁用状态

使用 disabled 属性来定义按钮是否已被禁用。

使用 disabled 属性来控制按钮的禁用状态。该属性接受一个 Boolean 类型的值。

链接按钮

使用 link 属性来定义链接按钮。

Basic link button

Disabled link button

文字按钮

使用 text 属性来定义文字按钮。

没有边框和背景色的按钮。

Basic text button

Background color always on

Disabled text button

图标按钮

带图标的按钮可增强辨识度(有文字)或节省空间(无文字)。当只有图标且需要悬浮说明时,设置非空的 tooltip 即可自动使用紧凑的纯图标样式并包裹 Tooltip(例如 <u-button type="primary" :icon="Edit" tooltip="编辑" />),一般不必再写 icon-button。若纯图标按钮不需要 Tooltip,但仍希望紧凑方形样式,可继续设置 icon-button

使用 icon 属性来为按钮添加图标。你可以在 Uniboot UI 的图标组件中找到对应的图标名。使用 <i> 标签则可以将图标添加在文字右侧,也可以使用自定义图标。

非空 tooltip 与仅图标(无默认插槽文字)组合时会自动使用紧凑样式;通过 tooltip-placement 可调整 Tooltip 位置。

按钮组

以按钮组的方式出现,常用于将多个对立的操作进行类似分组的操作。

你可以使用 direction 属性来控制按钮组方向。

使用 <u-button-group> 标签来嵌套你的按钮。



加载中按钮

点击按钮后进行数据加载操作,在按钮上显示加载状态。

要设置为加载中状态,只要设置 loading 属性为 true 即可。

TIP

你可以使用 loading 插槽或 loadingIcon 属性来自定义你的加载组件。

提示:loading 插槽具有比 loadingIcon 更高的优先级。

尺寸

除了默认的大小,按钮组件还提供了额外的三种尺寸,以便你在不同的场景下选择合适的按钮大小。

设置 largesmallsize 属性来改变按钮尺寸。

自定义标签

你可以自定义渲染元素的标签。例如 buttondivarouter-linknuxt-link

div
a

自定义颜色

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

我们将会自动计算出 hoveractive 的颜色。

color 属性同样支持应用在 linktext 按钮中。

按钮 API

按钮 属性

名称说明类型默认值
size按钮尺寸enum
type按钮类型,当设置 color 时,后者优先enum
plain是否为朴素按钮booleanfalse
outline是否为全镂空反白按钮(附带交互颜色变化效果)booleanfalse
text是否为文字按钮booleanfalse
bg是否让文字按钮的背景色一直处于显示状态booleanfalse
link是否为链接按钮booleanfalse
round是否为圆角按钮booleanfalse
circle是否为圆形按钮booleanfalse
dashed是否为虚线框按钮booleanfalse
loading是否为加载中状态booleanfalse
loading-icon自定义加载中状态图标组件string / ComponentLoading
disabled是否为禁用状态booleanfalse
icon图标组件string / Component
autofocus同原生 button 组件的 autofocusbooleanfalse
native-type同原生 button 组件的 typeenumbutton
auto-insert-space自动在两个中文字符之间插入空格(只有在文本长度为2且都是中文字符的时候才生效)booleanfalse
color自定义按钮颜色, 自动计算 hoveractive 的颜色。 能够作用于 linktext 按钮string
dark暗黑模式,配合 color 能够自动转换为暗黑模式适应的色彩booleanfalse
tag自定义渲染元素的标签string / Componentbutton
icon-button是否强制为纯图标紧凑样式;未设置时,若非空 tooltipicon(或 icon 插槽)组合且无默认插槽,也会自动使用该样式booleanfalse
tooltip鼠标悬浮时显示的文字提示;非空时包裹 Tooltip。与仅图标组合时自动使用紧凑图标按钮样式string
tooltip-placementTooltip 的弹出位置,仅在设置了 tooltip 时生效enumtop

按钮 插槽

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

按钮 暴露

名称说明类型
refbutton 原生 HTML 元素object
size按钮尺寸object
type按钮组件的类型object
disabled按钮是否处于禁用状态object
shouldAddSpace是否需要在按钮文字间添加空格object

按钮组 API

按钮组 属性

名称说明类型默认值
size控制该按钮组内按钮的尺寸enum
type控制该按钮组内按钮的类型enum
direction按钮组的方向enumhorizontal

按钮组 插槽

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