跳到主要内容跳到主要内容

BottomNavigationActionAPI

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

演示

导入

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

通过阅读这篇关于最小化 bundle size 的指南,了解它们之间的区别。

Props

ButtonBase 组件的 props 也可用。

名称类型描述
childrenunsupportedProp

不支持此 prop。如果需要更改 children 结构,请使用 component prop。

classesobject

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

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

iconnode

要显示的图标。

labelnode

标签元素。

showLabelbool

如果为 trueBottomNavigationAction 将显示其标签。默认情况下,只有 BottomNavigation 内选定的 BottomNavigationAction 才会显示其标签。
此 prop 默认为从父 BottomNavigation 组件继承的值 (false)。

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

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

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

valueany

您可以提供自己的 value。否则,我们将回退到子位置索引。

ref 被转发到根元素。

继承

虽然上面没有明确记录,但 ButtonBase 组件的 props 也可在 BottomNavigationAction 中使用。您可以利用这一点来定位嵌套组件。

主题默认 props

您可以使用 MuiBottomNavigationAction 通过主题更改此组件的默认 props。

CSS classes

这些类名对于使用 CSS 进行样式设置很有用。当特定状态被触发时,它们会被应用于组件的 slots。

类名规则名称描述
.Mui-selected如果已选择,则应用于根元素的状态类。
.MuiBottomNavigationAction-iconOnlyiconOnly如果 showLabel={false} 且未选择,则应用于根元素的状态类。
.MuiBottomNavigationAction-labellabel应用于标签 span 元素的样式。
.MuiBottomNavigationAction-rootroot应用于根元素的样式。

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

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

源代码

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