跳到主要内容

Button

General

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 状态

属性类型默认值说明
loadingbooleanfalse是否加载中(加载时禁用点击)
disabledbooleanfalse是否禁用

appearanceAppearance 外观

属性类型默认值说明
variant'primary' | 'secondary' | 'ghost' | 'link' | 'text''primary'按钮类型
size'sm' | 'md' | 'lg''md'按钮尺寸
shape'default' | 'round' | 'circle''default'按钮形状
dangerbooleanfalse危险操作样式
blockbooleanfalse是否撑满父容器宽度

contentContent 内容

属性类型默认值说明
childrenReact.ReactNode—按钮文本内容
iconReact.ReactNode—前置图标
suffixReact.ReactNode—后置内容

interactionInteraction 交互

属性类型默认值说明
onClickMouseEventHandler<HTMLButtonElement>—点击回调(value-first 不适用,透传原生事件)

overrideOverride 样式覆盖

属性类型默认值说明
classNamestring—追加到 BEM 根节点的类名
styleReact.CSSProperties—内联样式覆盖

a11yA11y 无障碍

属性类型默认值说明
ariaLabelstring—无障碍标签
ariaDescribedBystring—关联描述元素 id
roleReact.AriaRole—ARIA role
tabIndexnumber—Tab 键序

nativeNative 原生透传

属性类型默认值说明
type'button' | 'submit' | 'reset'—原生 button type
formstring—关联表单 id
namestring—原生 name
autoFocusboolean—挂载时自动聚焦
formNoValidateboolean—提交时跳过表单校验

样式覆盖

消费者可通过三条路径覆盖样式,优先级从低到高:

  1. Design Token(推荐)— 覆盖 :root 上的 CSS 变量,一处改全局生效。
    --mq-color-primary--mq-button-radius--mq-spacing-*--mq-font-size-*
  2. override.className — 通过 props 追加类名到 BEM 根节点。
  3. BEM 选择器 — 直接选中组件类名定制。
    .mq-button.mq-button__icon.mq-button__loading.mq-button__suffix