Button按钮
按钮用于开始一个即时操作。
何时使用
标记了一个(或封装一组)操作命令,响应用户点击行为,触发相应的业务逻辑。
在 Ant Design 中,我们有四种按钮。
- 主按钮:用于主行动点,一个操作区域只能有一个主按钮。
- 默认按钮:用于没有主次之分的一组行动点。
- 虚线按钮:常用于添加操作。
- 链接按钮:用于次要或外链的行动点。
以及四种状态属性与上面配合使用。
- 危险:删除/移动/修改权限等危险操作,一般需要二次确认。
- 幽灵:用于背景色比较复杂的地方,常用在首页/产品页等展示场景。
- 禁用:行动点不可用的时候,一般需要文案解释。
- 加载中:用于异步操作等待反馈的时候,也可以避免多次提交。
Examples
Button API#
属性 | 描述 | 类型 | 默认值 |
---|---|---|---|
AriaLabel | 属性设置 aria-label 属性的值 | String | -- |
Color | 属性设置按钮的颜色。 | Color | Color.None |
Block | 属性使按钮宽度适合其父宽度的选项 | Boolean | false |
ChildContent | 属性按钮的内容。 | RenderFragment | -- |
Danger | 属性设置按钮的危险状态。 | Boolean | false |
Disabled | 属性`Button` 是否被禁用。 | Boolean | false |
Ghost | 属性使背景透明并反转文本和边框颜色 | Boolean | false |
HtmlType | 属性设置按钮元素的原始 html 类型。 | String | button |
Icon | 属性设置按钮的图标组件。 | String | -- |
Loading | 属性显示加载指示器。您必须自己编写加载逻辑。 | Boolean | false |
AutoLoading | 属性是否触发并保持加载状态,直到事件回调完成。 | Boolean | -- |
OnClick | 属性单击“按钮”时的回调 | EventCallback<MouseEventArgs> | -- |
OnClickStopPropagation | 属性单击按钮时不传播事件。 | Boolean | -- |
Shape | 属性可以设置按钮形状:`circle` | `round` 或 `null`(默认为矩形)。 | String | null |
Size | 属性设置按钮的大小。 | String | AntSizeLDSType.Default |
Type | 属性按钮的类型。 | String | ButtonType.Default |
NoSpanWrap | 属性不要用 包裹 | Boolean | -- |
Id | 属性组件 HTML 的 ID | String | Uniquely Generated ID |
Class | 属性为 DOM 元素指定一个或多个类名。 | String | -- |
Style | 属性指定 DOM 元素的内联样式。 | String | -- |
RefBack | 属性一个 ForwardRef 实例。您可以使用 AntDesign.ForwardRef.Current 获取对内部 DOM 的引用。 |
ForwardRef | -- |
DownloadButton API#
属性 | 描述 | 类型 | 默认值 |
---|---|---|---|
Url | 属性文件的下载地址 | String | -- |
FileName | 属性文件名 | String | -- |
AriaLabel | 属性设置 aria-label 属性的值 | String | -- |
Color | 属性设置按钮的颜色。 | Color | Color.None |
Block | 属性使按钮宽度适合其父宽度的选项 | Boolean | false |
ChildContent | 属性按钮的内容。 | RenderFragment | -- |
Danger | 属性设置按钮的危险状态。 | Boolean | false |
Disabled | 属性`Button` 是否被禁用。 | Boolean | false |
Ghost | 属性使背景透明并反转文本和边框颜色 | Boolean | false |
HtmlType | 属性设置按钮元素的原始 html 类型。 | String | button |
Icon | 属性设置按钮的图标组件。 | String | -- |
Loading | 属性显示加载指示器。您必须自己编写加载逻辑。 | Boolean | false |
AutoLoading | 属性是否触发并保持加载状态,直到事件回调完成。 | Boolean | -- |
OnClick | 属性单击“按钮”时的回调 | EventCallback<MouseEventArgs> | -- |
OnClickStopPropagation | 属性单击按钮时不传播事件。 | Boolean | -- |
Shape | 属性可以设置按钮形状:`circle` | `round` 或 `null`(默认为矩形)。 | String | null |
Size | 属性设置按钮的大小。 | String | AntSizeLDSType.Default |
Type | 属性按钮的类型。 | String | ButtonType.Default |
NoSpanWrap | 属性不要用 包裹 | Boolean | -- |
Id | 属性组件 HTML 的 ID | String | Uniquely Generated ID |
Class | 属性为 DOM 元素指定一个或多个类名。 | String | -- |
Style | 属性指定 DOM 元素的内联样式。 | String | -- |
RefBack | 属性一个 ForwardRef 实例。您可以使用 AntDesign.ForwardRef.Current 获取对内部 DOM 的引用。 |
ForwardRef | -- |