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
}