mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-29 13:47:02 +08:00
fb0b4f0fc9
* docs: add api first appearance * docs: fix auto-complete doc * docs: replace Version Added with Version * docs: date picker common method * docs: date picker common method * docs: tree * docs: remove meaningless 3.0.0
52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
---
|
|
category: Components
|
|
type: General
|
|
title: Button
|
|
---
|
|
|
|
To trigger an operation.
|
|
|
|
## When To Use
|
|
|
|
A button means an operation (or a series of operations). Clicking a button will trigger corresponding business logic.
|
|
|
|
## API
|
|
|
|
To get a customized button, just set `type`/`shape`/`size`/`loading`/`disabled`.
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| disabled | disabled state of button | boolean | `false` | 3.5.1 |
|
|
| ghost | make background transparent and invert text and border colors, added in 2.7 | boolean | `false` | |
|
|
| href | redirect url of link button | string | - | |
|
|
| 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 | - | |
|
|
| loading | set the loading status of button | boolean \| { delay: number } | `false` | |
|
|
| shape | can be set to `circle`, `round` or omitted | string | - | |
|
|
| size | can be set to `small` `large` or omitted | string | `default` | |
|
|
| target | same as target attribute of a, works when href is specified | string | - | |
|
|
| type | can be set to `primary` `ghost` `dashed` `danger` `link`(added in 3.17) or omitted (meaning `default`) | string | `default` | |
|
|
| onClick | set the handler to handle `click` event | (event) => void | - | |
|
|
| block | option to fit button width to its parent width | boolean | `false` | 3.8.0 |
|
|
|
|
It accepts all props which native button support.
|
|
|
|
## FAQ
|
|
|
|
### 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`.
|
|
|
|
|
|
|
|
<style>
|
|
[id^=components-button-demo-] .ant-btn {
|
|
margin-right: 8px;
|
|
margin-bottom: 12px;
|
|
}
|
|
[id^=components-button-demo-] .ant-btn-group > .ant-btn,
|
|
[id^=components-button-demo-] .ant-btn-group > span > .ant-btn {
|
|
margin-right: 0;
|
|
}
|
|
</style>
|