跳到主要内容跳到主要内容
🚀 影响 Material UI 2025 年路线图！参与最新的开发者调查

ButtonGroupAPI

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

演示

导入

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

阅读关于最小化捆绑包大小的指南，了解它们之间的区别。

属性

原生组件的属性也可用。

名称类型默认值描述
childrennode-

组件的内容。

classesobject-

覆盖或扩展应用于组件的样式。

有关更多详细信息，请参阅下面的 CSS 类 API。

color'inherit'
| 'primary'
| 'secondary'
| 'error'
| 'info'
| 'success'
| 'warning'
| string		'primary'

组件的颜色。它同时支持默认主题颜色和自定义主题颜色，自定义主题颜色可以按照调色板自定义指南中所示的方式添加。

componentelementType-

用于根节点的组件。可以是用于 HTML 元素的字符串，也可以是组件。

disabledboolfalse

如果为 true，则组件被禁用。

disableElevationboolfalse

如果为 true，则不使用阴影。

disableFocusRippleboolfalse

如果为 true，则禁用按钮键盘焦点涟漪效果。

disableRippleboolfalse

如果为 true，则禁用按钮涟漪效果。

fullWidthboolfalse

如果为 true，则按钮将占据其容器的全部宽度。

orientation'horizontal'
| 'vertical'		'horizontal'

组件方向（布局流方向）。

size'small'
| 'medium'
| 'large'
| string		'medium'

组件的尺寸。small 等同于精简按钮样式。

sxArray<func
| object
| bool>
| func
| object		-

允许定义系统覆盖以及其他 CSS 样式的系统属性。

有关更多详细信息，请参阅 `sx` 页面。

variant'contained'
| 'outlined'
| 'text'
| string		'outlined'

要使用的变体。

ref 被转发到根元素。

主题默认属性

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

CSS 类

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

类名规则名称描述
.Mui-disabled如果 disabled={true}，则应用于子元素的状态类。
.MuiButtonGroup-colorPrimarycolorPrimary如果 color="primary"，则应用于根元素的样式
.MuiButtonGroup-colorSecondarycolorSecondary如果 color="secondary"，则应用于根元素的样式
.MuiButtonGroup-containedcontained如果 variant="contained"，则应用于根元素的样式。
.MuiButtonGroup-disableElevationdisableElevation如果 disableElevation={true}，则应用于根元素的样式。
.MuiButtonGroup-firstButtonfirstButton应用于按钮组中第一个按钮的样式。
.MuiButtonGroup-fullWidthfullWidth如果 fullWidth={true}，则应用于根元素的样式。
.MuiButtonGroup-groupedgrouped应用于子元素的样式。
.MuiButtonGroup-groupedContainedgroupedContained如果 variant="contained"，则应用于子元素的样式。
.MuiButtonGroup-groupedContainedHorizontalgroupedContainedHorizontal如果 variant="contained" 和 orientation="horizontal"，则应用于子元素的样式。
.MuiButtonGroup-groupedContainedPrimarygroupedContainedPrimary如果 variant="contained" 和 color="primary"，则应用于子元素的样式。
.MuiButtonGroup-groupedContainedSecondarygroupedContainedSecondary如果 variant="contained" 和 color="secondary"，则应用于子元素的样式。
.MuiButtonGroup-groupedContainedVerticalgroupedContainedVertical如果 variant="contained" 和 orientation="vertical"，则应用于子元素的样式。
.MuiButtonGroup-groupedHorizontalgroupedHorizontal如果 orientation="horizontal"，则应用于子元素的样式。
.MuiButtonGroup-groupedOutlinedgroupedOutlined如果 variant="outlined"，则应用于子元素的样式。
.MuiButtonGroup-groupedOutlinedHorizontalgroupedOutlinedHorizontal如果 variant="outlined" 和 orientation="horizontal"，则应用于子元素的样式。
.MuiButtonGroup-groupedOutlinedPrimarygroupedOutlinedPrimary如果 variant="outlined" 和 color="primary"，则应用于子元素的样式。
.MuiButtonGroup-groupedOutlinedSecondarygroupedOutlinedSecondary如果 variant="outlined" 和 color="secondary"，则应用于子元素的样式。
.MuiButtonGroup-groupedOutlinedVerticalgroupedOutlinedVertical如果 variant="outlined" 和 orientation="vertical"，则应用于子元素的样式。
.MuiButtonGroup-groupedTextgroupedText如果 variant="text"，则应用于子元素的样式。
.MuiButtonGroup-groupedTextHorizontalgroupedTextHorizontal如果 variant="text" 和 orientation="horizontal"，则应用于子元素的样式。
.MuiButtonGroup-groupedTextPrimarygroupedTextPrimary如果 variant="text" 和 color="primary"，则应用于子元素的样式。
.MuiButtonGroup-groupedTextSecondarygroupedTextSecondary如果 variant="text" 和 color="secondary"，则应用于子元素的样式。
.MuiButtonGroup-groupedTextVerticalgroupedTextVertical如果 variant="text" 和 orientation="vertical"，则应用于子元素的样式。
.MuiButtonGroup-groupedVerticalgroupedVertical如果 orientation="vertical"，则应用于子元素的样式。
.MuiButtonGroup-horizontalhorizontal如果 orientation="horizontal"，则应用于根元素的样式。
.MuiButtonGroup-lastButtonlastButton应用于按钮组中最后一个按钮的样式。
.MuiButtonGroup-middleButtonmiddleButton应用于按钮组中间按钮的样式。
.MuiButtonGroup-outlinedoutlined如果 variant="outlined"，则应用于根元素的样式。
.MuiButtonGroup-rootroot应用于根元素的样式。
.MuiButtonGroup-texttext如果 variant="text"，则应用于根元素的样式。
.MuiButtonGroup-verticalvertical如果 orientation="vertical"，则应用于根元素的样式。

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

源代码

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