Skip to main content

List Item

The List Item component is a text-based item contained within a list.

Properties

NameTypeDefaultDescription
textstringSpecifies the text for the list item.
buttonboolfalseIf true, the list item is a button and enables the selected and disabled properties.
selectedboolfalseIf true, a selected style is applied to the list item.
disabledboolfalseIf true, the list item is disabled.
tooltipTitlestringDefines a tooltip for the list item.
tooltipPlacementbottom-end
bottom-start
bottom
left-end
left-start
left
right-end
right-start
right
top-end
top-start
top
string
bottomDefines the placement of the tooltip on the list item.
loopDataarrayDefines an array of options in the format id, label, value. The id must be is small letters.
itemNamestringDefines a unique identifier name for each menu item.

You do not need to add a Looper component to a List to create list items dynamically. Each List Item has a built-in looper, called a Loop, that allows you to create list items dynamically.

The Add Left Component allows the placement of an icon, badge, chip or container to the left-hand side of a list item.

Style Attributes

NameTypeDefaultDescription
alignItemscenter
flex-start
centerDefines the alignment applied to the list item.
denseboolfalseIf true, compact vertical padding is used for the list item.
disableGuttersboolfalseIf true, removes the gutter on the left-hand side of the list item.
dividerboolfalseIf true, adds a line beneath the list item.

For more detail on the List Item component, see the MUI developer docs.