Skip to content

Button 按钮

按钮用于触发一个即时操作,如提交表单、确认操作、取消操作等。

类型

按钮有多种类型,用不同的颜色来区分不同的操作含义:

  • 主要按钮:用于强调页面上最主要的操作
  • 次要按钮:用于一般性的操作
  • 成功按钮:表示成功、确认类操作
  • 警告按钮:需要谨慎操作的场景
  • 危险按钮:表示危险、删除类操作

尺寸

按钮提供了三种尺寸:大、中(默认)、小。 根据使用场景选择合适的按钮尺寸。

圆形按钮

圆形按钮常用于图标按钮的展示,适合放置在一些特定区域。

禁用状态

当操作不可用时,可以使用禁用状态的按钮来阻止用户进行操作。

加载状态

用于操作需要一段时间才能完成的场景,可以使用加载状态来给予用户反馈。

朴素按钮

朴素按钮的样式更加简约,适用于次要操作或需要弱化展示的场景。

文本按钮

文本按钮没有边框和背景色,常用于表格内的编辑、删除等操作,或者一些不需要强调的操作。

按钮组

按钮组可以将一组相关的按钮放在一起,用于展示一组相关的操作选项。

属性

继承的属性可以在类型中找到。

ts
type ButtonType = ColorType

/** 按钮属性类型 */
interface ButtonProps extends ComponentProps {
  /** 按钮类型 */
  type?: ButtonType
  /** 是否以文本形式展示 */
  text?: boolean
  /** 朴素模式 */
  plain?: boolean
  /** 加载中 */
  loading?: boolean
  /** 加载图标 */
  loadingIcon?: Component
  /** 圆形 */
  circle?: boolean
  /** 禁用 */
  disabled?: boolean
  /** 图标 */
  icon?: Component
  /** 图标大小, 单位px */
  iconSize?: number
  /** 图标位置 */
  iconPosition?: 'left' | 'right'
}

事件

ts
interface ButtonEmits {
  /** 点击事件 */
  (name: 'click', e: MouseEvent): void
}

基于 MIT 协议