---
title: Lists
description: "A row for each item: map over the list, give each row a key, and keep the list in state to add, change and take away rows."
section: Learn
order: 4
---

# Lists

To draw a row for each item, `map` over the list. Give each row a `key`, and React keeps each row with its item as the list changes around it.

**In this lesson**

- how to draw a row for each item;
- why each row needs a key;
- how to add, change and take away rows;
- what to show when the list is empty.

## A row for each item

```tsx try
const PEOPLE = [
  { id: "ada", name: "Ada Lovelace", role: "Mathematician" },
  { id: "grace", name: "Grace Hopper", role: "Rear admiral" },
  { id: "alan", name: "Alan Turing", role: "Codebreaker" },
];

export default function App() {
  return (
    <ul className="grid gap-1">
      {PEOPLE.map((p) => (
        <li key={p.id} className="flex justify-between rounded-md bg-muted px-3 py-2">
          <span className="font-medium">{p.name}</span>
          <span className="text-sm text-muted-foreground">{p.role}</span>
        </li>
      ))}
    </ul>
  );
}
```

## Keys

`key` tells React which row is which item. When the list changes, a row moves with its item instead of being drawn again for another one, so what it holds (a field being typed in, a row being animated) stays with the right item. Use what identifies the item: its `id`, a slug, a code. The position in the list is a key only for a list that never changes.

## A list that changes

Keep the list in state, and change it by making a new one:

```tsx try
import { useState } from "react";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";

export default function App() {
  const [todos, setTodos] = useState([{ id: 1, title: "Buy milk" }]);
  const [title, setTitle] = useState("");
  const add = (e) => {
    e.preventDefault();
    if (!title.trim()) return;
    setTodos((list) => [...list, { id: Date.now(), title: title.trim() }]);
    setTitle("");
  };
  return (
    <div className="grid gap-3">
      <form className="flex gap-2" onSubmit={add}>
        <Input aria-label="New todo" placeholder="What needs doing?" value={title} onChange={(e) => setTitle(e.target.value)} />
        <Button type="submit">Add</Button>
      </form>
      {todos.length === 0 && <p className="text-sm text-muted-foreground">Nothing to do.</p>}
      <ul className="grid gap-1">
        {todos.map((t) => (
          <li key={t.id} className="flex items-center justify-between rounded-md bg-muted px-3 py-1.5">
            {t.title}
            <Button variant="ghost" size="sm" onClick={() => setTodos((list) => list.filter((x) => x.id !== t.id))}>Done</Button>
          </li>
        ))}
      </ul>
    </div>
  );
}
```

- **Add:** `[...list, item]`.
- **Take away:** `list.filter((x) => x.id !== id)`.
- **Change one:** `list.map((x) => (x.id === id ? { ...x, done: true } : x))`.
- **Empty:** a condition beside the list says so, and offers what to do.

A list kept in the database, live in every tab, is in [Loading data](/docs/learn/loading-data).

Next: respond to clicks and typing, in [Events and forms](/docs/learn/events-and-forms).
