Tailwind CSS List - React

Use our responsive React and Tailwind CSS vertical List component anywhere on your web app!

A List component displays a list of items containing images, icons, and text that represents a specific action.

See below our List component examples that you can use in your Tailwind CSS and React project. The examples comes in different styles, so you can adapt them easily to your needs.

List Demo

Here's how to implement a simple List component. It can be used to display a list of items on your website like a navigation menu.

  • Inbox
  • Trash
  • Settings
import { List } from "@material-tailwind/react";

export function ListDemo() {
  return (
    <List>
      <List.Item>Inbox</List.Item>
      <List.Item>Trash</List.Item>
      <List.Item>Settings</List.Item>
    </List>
  );
}
import { List } from "@material-tailwind/react";

export function ListDemo() {
  return (
    <List>
      <List.Item>Inbox</List.Item>
      <List.Item>Trash</List.Item>
      <List.Item>Settings</List.Item>
    </List>
  );
}

List with Icon

You can add icons to your List items using the List.ItemStart component. In the example below, we've showcased a navigation menu with icons useful for a dashboard.

In the example below we've used the Iconoir icons, but you can use any other icon library you prefer.

  • Inbox
  • Trash
  • Settings
import { List } from "@material-tailwind/react";
import { Bin, Mail, Settings } from "iconoir-react";

export function ListWithIcon() {
  return (
    <List>
      <List.Item>
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}
import { List } from "@material-tailwind/react";
import { Bin, Mail, Settings } from "iconoir-react";

export function ListWithIcon() {
  return (
    <List>
      <List.Item>
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}

List with Avatar

You can add avatars to your List items using the Avatar and List.ItemStart components. In the example below, we've showcased a list of users with their profile picture, name, and job title.

  • profile-picture

    Alex Andrew

    Software Engineer @ Material Tailwind
  • profile-picture

    Alexander

    Backend Developer @ Material Tailwind
  • profile-picture

    Emma Willever

    UI/UX Designer @ Material Tailwind
import * as React from "react";
import { List, Avatar, Typography } from "@material-tailwind/react";

const ListItem = React.forwardRef<
  typeof List.Item,
  {
    img: string;
    title: string;
    description: string;
  }
>(({ img, title, description, ...rest }, ref) => {
  return (
    <List.Item ref={ref as any} {...rest}>
      <List.ItemStart>
        <Avatar src={img} alt="profile-picture" />
      </List.ItemStart>
      <div>
        <Typography color="default" className="font-semibold">
          {title}
        </Typography>
        <Typography type="small" className="text-foreground">
          {description}
        </Typography>
      </div>
    </List.Item>
  );
});

export function ListWithAvatar() {
  return (
    <List>
      <ListItem
        img="https://dub.sh/TdSBP0D"
        title="Alex Andrew"
        description="Software Engineer @ Material Tailwind"
      />
      <ListItem
        img="https://dub.sh/rNFOKKJ"
        title="Alexander"
        description="Backend Developer @ Material Tailwind"
      />
      <ListItem
        img="https://dub.sh/6i238JA"
        title="Emma Willever"
        description="UI/UX Designer @ Material Tailwind"
      />
    </List>
  );
}
import * as React from "react";
import { List, Avatar, Typography } from "@material-tailwind/react";

const ListItem = React.forwardRef<
  typeof List.Item,
  {
    img: string;
    title: string;
    description: string;
  }
>(({ img, title, description, ...rest }, ref) => {
  return (
    <List.Item ref={ref as any} {...rest}>
      <List.ItemStart>
        <Avatar src={img} alt="profile-picture" />
      </List.ItemStart>
      <div>
        <Typography color="default" className="font-semibold">
          {title}
        </Typography>
        <Typography type="small" className="text-foreground">
          {description}
        </Typography>
      </div>
    </List.Item>
  );
});

export function ListWithAvatar() {
  return (
    <List>
      <ListItem
        img="https://dub.sh/TdSBP0D"
        title="Alex Andrew"
        description="Software Engineer @ Material Tailwind"
      />
      <ListItem
        img="https://dub.sh/rNFOKKJ"
        title="Alexander"
        description="Backend Developer @ Material Tailwind"
      />
      <ListItem
        img="https://dub.sh/6i238JA"
        title="Emma Willever"
        description="UI/UX Designer @ Material Tailwind"
      />
    </List>
  );
}

List with Badge

You can add badges to your List items using the Chip and List.ItemStart components. In the example below, we've showcased a list of items with a badge that represents the number of items in each category.

  • Inbox
    14
  • Trash
    40
  • Settings
import { List, Chip } from "@material-tailwind/react";
import { Mail, Settings, Bin } from "iconoir-react";

export function ListWithBadge() {
  return (
    <List>
      <List.Item>
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
        <List.ItemEnd>
          <Chip size="sm" variant="ghost">
            <Chip.Label>14</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
        <List.ItemEnd>
          <Chip size="sm" variant="ghost">
            <Chip.Label>40</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}
import { List, Chip } from "@material-tailwind/react";
import { Mail, Settings, Bin } from "iconoir-react";

export function ListWithBadge() {
  return (
    <List>
      <List.Item>
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
        <List.ItemEnd>
          <Chip size="sm" variant="ghost">
            <Chip.Label>14</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
        <List.ItemEnd>
          <Chip size="sm" variant="ghost">
            <Chip.Label>40</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item>
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}

List with Selected Item

You can add a selected state to your List items using the selected prop. In the example below, we've showcased a list of items with a selected state that represents the active item.

  • Inbox
  • Trash
  • Settings
import * as React from "react";
import { List } from "@material-tailwind/react";

export function ListWithSelectedItem() {
  const [selected, setSelected] = React.useState("inbox");

  return (
    <List>
      <List.Item
        selected={selected === "inbox"}
        onClick={() => setSelected("inbox")}
      >
        Inbox
      </List.Item>
      <List.Item
        selected={selected === "trash"}
        onClick={() => setSelected("trash")}
      >
        Trash
      </List.Item>
      <List.Item
        selected={selected === "settings"}
        onClick={() => setSelected("settings")}
      >
        Settings
      </List.Item>
    </List>
  );
}
import * as React from "react";
import { List } from "@material-tailwind/react";

export function ListWithSelectedItem() {
  const [selected, setSelected] = React.useState("inbox");

  return (
    <List>
      <List.Item
        selected={selected === "inbox"}
        onClick={() => setSelected("inbox")}
      >
        Inbox
      </List.Item>
      <List.Item
        selected={selected === "trash"}
        onClick={() => setSelected("trash")}
      >
        Trash
      </List.Item>
      <List.Item
        selected={selected === "settings"}
        onClick={() => setSelected("settings")}
      >
        Settings
      </List.Item>
    </List>
  );
}

List with Disabled Item

You can add a disabled state to your List items using the disabled prop. This way you can disable the list item and prevent the user from interacting with it.

  • Inbox
  • Trash
  • Settings
import { List } from "@material-tailwind/react";

export function ListWithDisabledItem() {
  return (
    <List>
      <List.Item disabled>Inbox</List.Item>
      <List.Item>Trash</List.Item>
      <List.Item>Settings</List.Item>
    </List>
  );
}
import { List } from "@material-tailwind/react";

export function ListWithDisabledItem() {
  return (
    <List>
      <List.Item disabled>Inbox</List.Item>
      <List.Item>Trash</List.Item>
      <List.Item>Settings</List.Item>
    </List>
  );
}

List with Link

You can use the List.Item component as a link by using the as prop. This way you can use the List.Item component as a link to navigate to another page or website.

import { List } from "@material-tailwind/react";

export function ListWithLink() {
  return (
    <List>
      <List.Item as="a" href="#">
        Inbox
      </List.Item>
      <List.Item as="a" href="#">
        Trash
      </List.Item>
      <List.Item as="a" href="#">
        Settings
      </List.Item>
    </List>
  );
}
import { List } from "@material-tailwind/react";

export function ListWithLink() {
  return (
    <List>
      <List.Item as="a" href="#">
        Inbox
      </List.Item>
      <List.Item as="a" href="#">
        Trash
      </List.Item>
      <List.Item as="a" href="#">
        Settings
      </List.Item>
    </List>
  );
}

List Custom Styles

You can customize the List component using the className prop. This way you can create your own styles for the List component.

  • Inbox
    14
  • Trash
    40
  • Settings
import { List, Chip } from "@material-tailwind/react";
import { Mail, Settings, Bin } from "iconoir-react";

export function ListCustomStyles() {
  return (
    <List>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
        <List.ItemEnd>
          <Chip
            size="sm"
            variant="ghost"
            color="info"
            className="transition-colors duration-300 group-hover:bg-white"
          >
            <Chip.Label>14</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
        <List.ItemEnd>
          <Chip
            size="sm"
            variant="ghost"
            color="info"
            className="transition-colors duration-300 group-hover:bg-white"
          >
            <Chip.Label>40</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}
import { List, Chip } from "@material-tailwind/react";
import { Mail, Settings, Bin } from "iconoir-react";

export function ListCustomStyles() {
  return (
    <List>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Mail className="h-5 w-5" />
        </List.ItemStart>
        Inbox
        <List.ItemEnd>
          <Chip
            size="sm"
            variant="ghost"
            color="info"
            className="transition-colors duration-300 group-hover:bg-white"
          >
            <Chip.Label>14</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Bin className="h-5 w-5" />
        </List.ItemStart>
        Trash
        <List.ItemEnd>
          <Chip
            size="sm"
            variant="ghost"
            color="info"
            className="transition-colors duration-300 group-hover:bg-white"
          >
            <Chip.Label>40</Chip.Label>
          </Chip>
        </List.ItemEnd>
      </List.Item>
      <List.Item className="group hover:bg-info hover:text-secondary focus:bg-info focus:text-secondary">
        <List.ItemStart>
          <Settings className="h-5 w-5" />
        </List.ItemStart>
        Settings
      </List.Item>
    </List>
  );
}