

<DemoTitle title="Button" desc="按钮用于开始一个即时操作。">
#### API

| 属性名 | 描述 | 类型 | 默认值 | 
|--------|--------|--------|--------|
| size | 按钮大小 | 'small' \| 'middle' \| 'large' | 'middle' | 
| type | 类型 | \| 'primary'
    \| 'dashed'
    \| 'link'
    \| 'text'
    \| 'default'
    \| 'primaryLess'
    \| 'textCompact' | 'deafult' | 
| tooltipContent | hover上去tooltip的内容 | string \| ReactNode |  | 
| iconType | 百炼图标iconfont的key，依赖ConfigProvider传入的iconfont，例如bl-icon-add | string |  | 
| iconSize | 图标大小 | SparkIconFontProps['size'] |  | 

<AntdApiRef url="https://ant.design/components/button-cn/#api"></AntdApiRef>


## antd API

通用属性参考：[通用属性](/docs/react/common-props)

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

按钮的属性说明如下：

| 属性 | 说明 | 类型 | 默认值 | 版本 | 
|--------|--------|--------|--------|--------|
| autoInsertSpace | 我们默认提供两个汉字之间的空格，可以设置  | boolean | true | 5.17.0 | 
| block | 将按钮宽度调整为其父宽度的选项 | boolean | false |  | 
| classNames | 语义化结构 class |  | - | 5.4.0 | 
| color | 设置按钮的颜色 | default | - | default | 
| danger | 语法糖，设置危险按钮。当设置  | boolean | false |  | 
| disabled | 设置按钮失效状态 | boolean | false |  | 
| ghost | 幽灵属性，使按钮背景透明 | boolean | false |  | 
| href | 点击跳转的地址，指定此属性 button 的行为和 a 链接一致 | string | - |  | 
| htmlType | 设置  | submit | button |  | 
| iconPosition | 设置按钮图标组件的位置 | start | start | 5.17.0 | 
| loading | 设置按钮载入状态 | boolean \| { delay: number, icon: ReactNode } | false | icon: 5.23.0 | 
| styles | 语义化结构 style |  | - | 5.4.0 | 
| target | 相当于 a 链接的 target 属性，href 存在时生效 | string | - |  | 
| onClick | 点击按钮时的回调 | (event: React.MouseEvent) => void | - |  | 
| variant | 设置按钮的变体 | outlined | - | 5.21.0 | 


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

### PresetColors

type PresetColors = 'blue' | 'purple' | 'cyan' | 'green' | 'magenta' | 'pink' | 'red' | 'orange' | 'yellow' | 'volcano' | 'geekblue' | 'lime' | 'gold';