Button
Button
触发一个操作。支持 5 种 variant、3 种 size、3 种 shape,以及 loading / danger / block 状态。
基础 Variants
<Button
appearance={{
variant: 'primary'
}}
content={{
children: 'Primary'
}}
/>
<Button
appearance={{
variant: 'secondary'
}}
content={{
children: 'Secondary'
}}
/>
<Button
appearance={{
variant: 'ghost'
}}
content={{
children: 'Ghost'
}}
/>
<Button
appearance={{
variant: 'link'
}}
content={{
children: 'Link'
}}
/>
<Button
appearance={{
variant: 'text'
}}
content={{
children: 'Text'
}}
/>
Size
<Button
appearance={{
size: 'sm',
variant: 'primary'
}}
content={{
children: 'Small'
}}
/>
<Button
appearance={{
size: 'md',
variant: 'primary'
}}
content={{
children: 'Medium'
}}
/>
<Button
appearance={{
size: 'lg',
variant: 'primary'
}}
content={{
children: 'Large'
}}
/>
Shape
<Button
appearance={{
shape: 'default',
variant: 'primary'
}}
content={{
children: 'Default'
}}
/>
<Button
appearance={{
shape: 'round',
variant: 'primary'
}}
content={{
children: 'Round'
}}
/>
<Button
appearance={{
shape: 'circle',
variant: 'primary'
}}
content={{
icon: '+'
}}
/>
状态 · Loading / Disabled
<Button
state={{
loading: true
}}
appearance={{
variant: 'primary'
}}
content={{
children: 'Loading'
}}
/>
<Button
state={{
disabled: true
}}
appearance={{
variant: 'primary'
}}
content={{
children: 'Disabled'
}}
/>
状态 · Danger
<Button
appearance={{
danger: true,
variant: 'primary'
}}
content={{
children: '删除'
}}
/>
<Button
appearance={{
danger: true,
variant: 'secondary'
}}
content={{
children: '确认删除'
}}
/>
<Button
appearance={{
danger: true,
variant: 'link'
}}
content={{
children: '不可恢复'
}}
/>
状态 · Block(撑满父容器)
<Button
appearance={{
block: true,
variant: 'primary'
}}
content={{
children: 'Full Width Button'
}}
/>
Props
stateState 状态
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
loading | boolean | false | 是否加载中(加载时禁用点击) |
disabled | boolean | false | 是否禁用 |
appearanceAppearance 外观
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
variant | 'primary' | 'secondary' | 'ghost' | 'link' | 'text' | 'primary' | 按钮类型 |
size | 'sm' | 'md' | 'lg' | 'md' | 按钮尺寸 |
shape | 'default' | 'round' | 'circle' | 'default' | 按钮形状 |
danger | boolean | false | 危险操作样式 |
block | boolean | false | 是否撑满父容器宽度 |
contentContent 内容
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
children | React.ReactNode | — | 按钮文本内容 |
icon | React.ReactNode | — | 前置图标 |
suffix | React.ReactNode | — | 后置内容 |
interactionInteraction 交互
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
onClick | MouseEventHandler<HTMLButtonElement> | — | 点击回调(value-first 不适用,透传原生事件) |
overrideOverride 样式覆盖
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
className | string | — | 追加到 BEM 根节点的类名 |
style | React.CSSProperties | — | 内联样式覆盖 |
a11yA11y 无障碍
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ariaLabel | string | — | 无障碍标签 |
ariaDescribedBy | string | — | 关联描述元素 id |
role | React.AriaRole | — | ARIA role |
tabIndex | number | — | Tab 键序 |
nativeNative 原生透传
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
type | 'button' | 'submit' | 'reset' | — | 原生 button type |
form | string | — | 关联表单 id |
name | string | — | 原生 name |
autoFocus | boolean | — | 挂载时自动聚焦 |
formNoValidate | boolean | — | 提交时跳过表单校验 |
样式覆盖
消费者可通过三条路径覆盖样式,优先级从低到高:
- Design Token(推荐)— 覆盖
:root上的 CSS 变量,一处改全局生效。--mq-color-primary--mq-button-radius--mq-spacing-*--mq-font-size-* - override.className — 通过 props 追加类名到 BEM 根节点。
- BEM 选择器 — 直接选中组件类名定制。
.mq-button.mq-button__icon.mq-button__loading.mq-button__suffix