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

ListItemButtonAPI

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

演示

导入

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

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

Props

ButtonBase 组件的 Props 也可用。

名称类型默认值描述
alignItems'center'
| 'flex-start'
'center'

定义 align-items 样式属性。

autoFocusboolfalse

如果为 true,则列表项在首次挂载期间获得焦点。如果值从 false 变为 true,也会触发焦点。

childrennode-

组件的内容;如果使用了 ListItemSecondaryAction,则它必须是最后一个子元素。

classesobject-

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

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

componentelementType-

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

denseboolfalse

如果为 true,则使用专为键盘和鼠标输入设计的紧凑型垂直内边距。 该 prop 默认为从父 List 组件继承的值。

disabledboolfalse

如果为 true,则禁用该组件。

disableGuttersboolfalse

如果为 true,则移除左右内边距。

dividerboolfalse

如果为 true,则在列表项的底部添加 1px 的浅色边框。

focusVisibleClassNamestring-

此 prop 可以帮助识别哪个元素具有键盘焦点。 当元素通过键盘交互获得焦点时,将应用类名。 它是 CSS :focus-visible 选择器的 polyfill。 使用此功能的理由在此处进行了解释。 如果需要,可以使用 polyfillfocus-visible 类应用于其他组件。

selectedboolfalse

用于应用选定的样式。

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

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

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

ref 被转发到根元素。

继承

虽然上面没有明确说明,但 ButtonBase 组件的 props 也可在 ListItemButton 中使用。 您可以利用它来定位嵌套组件

主题默认 props

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

CSS 类

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

类名规则名称描述
.Mui-disabled如果 disabled={true},则应用于内部 component 元素的状态类。
.Mui-focusVisible应用于 componentfocusVisibleClassName prop 的状态类。
.Mui-selected如果 selected={true},则应用于根元素的状态类。
.MuiListItemButton-alignItemsFlexStartalignItemsFlexStart如果 alignItems="flex-start",则应用于组件元素。
.MuiListItemButton-densedense如果 dense,则应用于组件元素。
.MuiListItemButton-dividerdivider如果 divider={true},则应用于内部 component 元素。
.MuiListItemButton-guttersgutters除非 disableGutters={true},否则应用于内部 component 元素。
.MuiListItemButton-rootroot应用于根元素的样式。

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

源代码

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