ListItemButton API
导入
import ListItemButton from '@mui/material/ListItemButton';
// 或
import { ListItemButton } from '@mui/material';
组件名称
在主题中,名称“MuiListItemButton
”可用于提供默认属性(props),或者样式覆盖属性
ButtonBase 组件的属性也是可用的。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
alignItems | 'center' | 'flex-start' | 'center' | Defines the align-items style property. |
autoFocus | bool | false | If true , the list item is focused during the first mount. Focus will also be triggered if the value changes from false to true. |
children | node | The content of the component if a ListItemSecondaryAction is used it must be the last child. | |
classes | object | Override or extend the styles applied to the component. See CSS API below for more details. | |
component | elementType | The component used for the root node. Either a string to use a HTML element or a component. | |
dense | bool | false | If true , compact vertical padding designed for keyboard and mouse input is used. The prop defaults to the value inherited from the parent List component. |
disabled | bool | false | 如果被设置为 true ,那么该组件将会被禁用。 |
disableGutters | bool | false | If true , the left and right padding is removed. |
divider | bool | false | If true , a 1px light border is added to the bottom of the list item. |
focusVisibleClassName | string | This prop can help identify which element has keyboard focus. The class name will be applied when the element gains the focus through keyboard interaction. It's a polyfill for the CSS :focus-visible selector. The rationale for using this feature is explained here. A polyfill can be used to apply a focus-visible class to other components if needed. | |
selected | bool | false | Use to apply selected styling. |
sx | Array<func | object | bool> | func | object | The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details. |
ref
则会被传递到根元素中。继承
尽管上文没有明文记录, ButtonBase 组件 的属性(props) 在组件ListItemButton上同样是可用的。 你可以利用这一点来 指向嵌套组件CSS
规则名称 | 全局类名 | 描述 |
---|---|---|
root | .MuiListItemButton-root | Styles applied to the root element. |
focusVisible | .Mui-focusVisible | Pseudo-class applied to the `component`'s `focusVisibleClassName` prop. |
dense | .MuiListItemButton-dense | Styles applied to the component element if dense. |
alignItemsFlexStart | .MuiListItemButton-alignItemsFlexStart | Styles applied to the component element if alignItems="flex-start" . |
disabled | .Mui-disabled | Pseudo-class applied to the inner `component` element if disabled={true} . |
divider | .MuiListItemButton-divider | Styles applied to the inner `component` element if divider={true} . |
gutters | .MuiListItemButton-gutters | Styles applied to the inner `component` element unless disableGutters={true} . |
selected | .Mui-selected | Pseudo-class applied to the root element if selected={true} . |
您可以使用组件自定义选项对组件进行个性化:
- 具备 全局类名.
- 在自定义主体中,设定一个规则名称作为组件的
styleOverrides
属性的一部分。