跳到主要内容

Button 按钮

按钮是一种命令组件,常用于发起一个即时操作。

CoDesign 设计稿


组件构成

元素说明是否必须
文本标签按钮的文本标签是按钮上最重要的元素,传达了按钮即将执行的操作。
背景容器承载文本标签和图标的容器。
图标如果不使用文本标签,可以使用一个图标来表示按钮的作用。可选

按钮类型

主要按钮

浅色按钮

次要按钮

虚线按钮

文字按钮

图标按钮

图标按钮由图标+文字图标构成。通过图标可增强识别性,以便直观理解。

有文字

纯图标

组合按钮

可用在同级多项操作,以按钮组合方式出现。

开发说明
  • 支持标签前面有无图标
  • 样式变化
  • 幽灵按钮

    不同尺寸

    大小高度 (px)
    sm24px
    md(默认)32px
    lg40px
    xl48px
    开发说明
  • 新增了一个 "XLarge" 尺寸,主要用于商城场景;
  • 样式变化
  • 禁用状态

    按钮的禁用状态。

    加载状态

    按钮的加载状态。

    何时使用

    • 当操作命令需要用户点击,触发相应内容和业务逻辑时。

    API

    通过设置 Button 的属性来产生不同的按钮样式,推荐顺序为:type -> shape -> size -> loading -> disabled

    支持原生 button 的其他所有属性。

    按钮的属性说明如下:

    属性说明类型默认值版本
    block将按钮宽度调整为其父宽度的选项booleanfalse
    danger设置危险按钮booleanfalse
    disabled按钮失效状态booleanfalse
    ghost幽灵属性,使按钮背景透明booleanfalse
    href点击跳转的地址,指定此属性 button 的行为和 a 链接一致string--
    htmlType设置button 原生的 type 值,可选值请参考 HTML 标准stringbutton
    icon设置按钮的图标组件ReactNode--
    loading设置按钮载入状态boolean| { delay: number }false
    shape设置按钮形状default | circle | rounddefault
    size设置按钮大小large | middle | smallmiddle
    target相当于 a 链接的 target 属性,href 存在时生效string--
    type设置按钮类型primary| subtle | ghost | dashed | link | text | defaultdefault
    onClick点击按钮时的回调(event) => void--