2016-04-20 18:51:31 +08:00
---
category: Components
2016-11-09 14:43:32 +08:00
type: General
2016-04-22 14:52:19 +08:00
title: Button
2016-04-20 18:51:31 +08:00
---
2016-04-22 14:52:19 +08:00
To trigger an operation.
2016-05-25 09:43:26 +08:00
## When To Use
2016-04-22 14:52:19 +08:00
2016-11-29 17:13:24 +08:00
A button means an operation (or a series of operations). Clicking a button will trigger corresponding business logic.
2016-04-22 14:52:19 +08:00
## API
To get a customized button, just set `type` /`shape`/`size`/`loading`/`disabled`.
2017-10-25 10:25:44 +08:00
| Property | Description | Type | Default |
2019-05-07 14:57:32 +08:00
| --- | --- | --- | --- |
2018-06-24 17:09:18 +08:00
| disabled | disabled state of button | boolean | `false` |
2019-03-29 20:43:33 +08:00
| ghost | make background transparent and invert text and border colors, added in 2.7 | boolean | `false` |
2017-12-29 20:22:58 +08:00
| href | redirect url of link button | string | - |
2017-10-25 10:25:44 +08:00
| htmlType | set the original html `type` of `button` , see: [MDN ](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type ) | string | `button` |
| icon | set the icon of button, see: Icon component | string | - |
2019-04-01 21:05:50 +08:00
| loading | set the loading status of button | boolean \| { delay: number } | `false` |
2019-01-10 11:15:43 +08:00
| shape | can be set to `circle` , `round` or omitted | string | - |
2017-10-25 10:25:44 +08:00
| size | can be set to `small` `large` or omitted | string | `default` |
2017-12-29 20:22:58 +08:00
| target | same as target attribute of a, works when href is specified | string | - |
2019-05-06 12:04:39 +08:00
| type | can be set to `primary` `ghost` `dashed` `danger` `link` (added in 3.17) or omitted (meaning `default` ) | string | `default` |
2018-10-28 20:57:23 +08:00
| onClick | set the handler to handle `click` event | (event) => void | - |
2018-07-29 16:33:26 +08:00
| block | option to fit button width to its parent width | boolean | `false` |
2016-04-22 14:52:19 +08:00
2018-10-28 20:57:23 +08:00
It accepts all props which native button support.
2019-01-10 11:47:11 +08:00
## FAQ
2019-06-21 00:28:33 +08:00
### How to remove space between 2 chinese characters?
Following Ant Design specification, we will add one space between if Button contains two chinese characters only. If you don't need that, you can use [ConfigProvider ](/components/config-provider/#API ) to set `autoInsertSpaceInButton` as `false` .
2019-01-10 11:47:11 +08:00
2019-06-21 00:28:33 +08:00
![](https://gw.alipayobjects.com/zos/antfincdn/Hz5HL9gsT4/f29f170d-b78d-4d2b-aa71-0da6a9ead4d9.png)
2019-01-10 11:47:11 +08:00
2016-04-22 14:52:19 +08:00
< style >
2016-12-09 13:02:16 +08:00
[id^=components-button-demo-] .ant-btn {
2016-04-22 14:52:19 +08:00
margin-right: 8px;
margin-bottom: 12px;
}
2018-02-08 15:51:53 +08:00
[id^=components-button-demo-] .ant-btn-group > .ant-btn,
[id^=components-button-demo-] .ant-btn-group > span > .ant-btn {
2016-12-02 15:06:59 +08:00
margin-right: 0;
}
2016-04-22 14:52:19 +08:00
< / style >