ant-design/components/button/index.zh-CN.md
2018-10-28 20:57:23 +08:00

2.1 KiB
Raw Blame History

category type title subtitle
Components General Button 按钮

按钮用于开始一个即时操作。

何时使用

标记了一个(或封装一组)操作命令,响应用户点击行为,触发相应的业务逻辑。

API

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

按钮的属性说明如下:

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

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

<Button>Hello world!</Button> 最终会被渲染为 <button><span>Hello world!</span></button>,并且除了上表中的属性,其它属性都会直接传到原生 button 上。

<Button href="http://example.com">Hello world!</Button> 则会渲染为 <a href="http://example.com"><span>Hello world!</span></a>