@react-md/list

@react-md/list

Create lists of content that can have optional supplementary icons, avatars, or images placed with the text.

Installation

npm install --save @react-md/list

It is also recommended to install the following packages as they normally work together well with lists:

npm install --save @react-md/theme \
  @react-md/typography \
  @react-md/divider \
  @react-md/avatar \
  @react-md/icon \
  @react-md/media

Documentation

You should check out the full documentation for live examples and more customization information, but an example usage is shown below.

Usage

import React from "react";
import { render } from "react-dom";
import { Divider } from "@react-md/divider";
import { List, ListItem } from "@react-md/list";
import { FontIcon } from "@react-md/icon";

const App = () => (
  <List>
    <ListItem id="item-1">Item 1</ListItem>
    <ListItem id="item-2" secondaryText="This is secondary text">
      Item 2 Primary Text
    </ListItem>
    <ListItem id="item-3" disabled>
      Item 3 Disabled
    </ListItem>
    <Divider />
    <ListSubheader>Sub actions</ListSubheader>
    <ListItem id="item-4" leftAddon={<FontIcon>close</FontIcon>}>
      Close
    </ListItem>
    <ListItem
      id="item-5"
      leftAddon={
        <Avatar
          src="https://picsum.photos/40?random"
          alt="A random image from https://picsum.photos"
        />
      }
      leftAddonType="avatar"
    >
      With Avatar
    </ListItem>
  </List>
);

render(<App />, document.getElementById("root"));

Changelog

2.8.5 (2021-07-03)

Bug Fixes

• @react-md/form: MenuItemCheckbox added missing indeterminate state (aa2c552), closes #1186
• @react-md/form: useIndeterminateChecked correctly uses readonly prefix (7f69a71)
• @react-md/form: useIndeterminateChecked supports MenuItemCheckbox with new option (9ab67bf)
• @react-md/form: MenuItemCheckbox, MenuItemRadio, and MenuItemSwitch styles on light themes (fc4dcd9)

Documentation

• @react-md/form: Updated documentation for useIndeterminateChecked (8646c28)

Other Internal Changes

• @react-md/dev-utils: Updated release script to allow custom CHANGELOG updates (dde151b)
• @react-md/form: Added tests for useIndeterminateChecked (cc2a422)
• react-md.dev: Updated MenuWithFormControls example for indeterminate checkboxes (2d20848)