按钮基础API

React ButtonBase 组件的 API 参考文档。了解此导出模块的属性、CSS 和其他 API。

演示

有关此 React 组件的用法示例和详细信息，请访问组件演示页面

按钮

导入

import ButtonBase from '@mui/material/ButtonBase';
// or
import { ButtonBase } from '@mui/material';

阅读关于最小化 bundle 大小的指南，了解更多差异。

ButtonBase 包含尽可能少的样式。它的目标是成为创建按钮的简单构建块。它包含大量的样式重置和一些焦点/涟漪逻辑。

属性

原生组件的属性也可用。

名称	类型	默认值	描述
action	ref	-	用于命令式操作的 ref。目前仅支持 `focusVisible()` 操作。
centerRipple	bool	false	如果为 `true`，则涟漪居中。它们不会从光标交互位置开始。
children	node	-	组件的内容。
classes	object	-	覆盖或扩展应用于组件的样式。有关更多详细信息，请参阅下面的CSS 类 API。
component	元素类型	-	用于根节点的组件。可以是用于 HTML 元素的字符串或组件。此需要能够容纳 ref。
disabled	bool	false	如果为 `true`，则禁用该组件。
disableRipple	bool	false	如果为 `true`，则禁用涟漪效果。 ⚠️ 如果没有涟漪，则默认情况下没有 :focus-visible 的样式。请务必使用 `.Mui-focusVisible` 类应用单独的样式来突出显示元素。
disableTouchRipple	bool	false	如果为 `true`，则禁用触摸涟漪效果。
focusRipple	bool	false	如果为 `true`，则基本按钮将具有键盘焦点涟漪。
focusVisibleClassName	string	-	此属性可以帮助识别哪个元素具有键盘焦点。当元素通过键盘交互获得焦点时，将应用类名。它是 CSS :focus-visible 选择器的 polyfill。使用此功能的理由在此处进行了解释。如果需要，可以使用 polyfill 将 `focus-visible` 类应用于其他组件。
LinkComponent	elementType	'a'	当提供 `href` 属性时，用于渲染链接的组件。
onFocusVisible	func	-	当组件通过键盘获得焦点时触发的回调。我们也会触发 `onFocus` 回调。
sx	Array<func \| object \| bool> \| func \| object	-	允许定义系统覆盖以及其他 CSS 样式的系统属性。有关更多详细信息，请参阅`sx` 页面。
TouchRippleProps	object	-	应用于 `TouchRipple` 元素的属性。
touchRippleRef	func \| { current?: { pulsate: func, start: func, stop: func } }	-	指向 `TouchRipple` 元素的 ref。

ref 被转发到根元素。

主题默认属性

您可以使用 MuiButtonBase 通过主题更改此组件的默认属性。

CSS 类

这些类名对于使用 CSS 设置样式很有用。当触发特定状态时，它们将应用于组件的插槽。

类名	规则名称	描述
.Mui-disabled		如果 `disabled={true}`，则应用于根元素的状态类。
.Mui-focusVisible		如果键盘聚焦，则应用于根元素的状态类。
.MuiButtonBase-root	root	应用于根元素的样式。

您可以使用以下自定义选项之一覆盖组件的样式

使用全局类名。
使用规则名称作为自定义主题中组件的styleOverrides 属性的一部分。

源代码

如果您在此页面中找不到信息，请考虑查看组件的实现以获取更多详细信息。