React: A small task board

Apply the whole process to a task board: hierarchy, static version, minimal state, where it lives, and callbacks back up.

What to build

A three-column task board where cards move between columns.

Requirements

  • Columns To do, Doing and Done are section elements with the class column and the attribute data-status (planned, doing, done), each with an h2 showing the name and the number of cards, as To do (2).
  • Each card is an article with the class card showing its title in a span, with a button ← (not in To do) and a button → (not in Done) that move it one column.
  • A form with an input with the id new-task and a submit button Add adds a card to To do (ignoring empty titles). The board starts with Write report in To do, Fix login in Doing and Plan sprint in To do.

Constraints

The only state is the list of tasks (and the new task's text); columns and counts are computed.

Example

Moving Write report right, and adding "Email Ada", gives To do (2), Doing (2) and Done (0).

Why it works

Every column and count is derived from one list of tasks, so a card can never be in two columns, and the cards report moves to App through callbacks, which is the inverse data flow of the process.

Hints

Hint 1

Hierarchy: App (state) > Board > Column > Card. The only state is the list of tasks, each with a status.

Hint 2

Moving a card changes its status to the previous or next of ["planned", "doing", "done"].

Solution

Show one correct solution (try it yourself first)
import { useState } from "react";

const STATUSES = ["planned", "doing", "done"];
const NAMES = { planned: "To do", doing: "Doing", done: "Done" };
let nextId = 4;

function Card({ task, onMove }) {
  const at = STATUSES.indexOf(task.status);
  return (
    <article className="card">
      <span>{task.title}</span>
      {at > 0 && <button onClick={() => onMove(task.id, -1)}>←</button>}
      {at < STATUSES.length - 1 && <button onClick={() => onMove(task.id, 1)}>→</button>}
    </article>
  );
}

function Column({ status, tasks, onMove }) {
  return (
    <section className="column" data-status={status}>
      <h2>
        {NAMES[status]} ({tasks.length})
      </h2>
      {tasks.map((t) => (
        <Card key={t.id} task={t} onMove={onMove} />
      ))}
    </section>
  );
}

function Board({ tasks, onMove }) {
  return (
    <div className="board">
      {STATUSES.map((s) => (
        <Column key={s} status={s} tasks={tasks.filter((t) => t.status === s)} onMove={onMove} />
      ))}
    </div>
  );
}

export default function App() {
  const [tasks, setTasks] = useState([
    { id: 1, title: "Write report", status: "planned" },
    { id: 2, title: "Fix login", status: "doing" },
    { id: 3, title: "Plan sprint", status: "planned" },
  ]);
  const [title, setTitle] = useState("");

  function move(id, by) {
    setTasks(tasks.map((t) => (t.id === id ? { ...t, status: STATUSES[STATUSES.indexOf(t.status) + by] } : t)));
  }

  function handleSubmit(event) {
    event.preventDefault();
    if (title.trim() === "") return;
    setTasks([...tasks, { id: nextId++, title: title.trim(), status: "planned" }]);
    setTitle("");
  }

  return (
    <div>
      <form onSubmit={handleSubmit}>
        <input id="new-task" value={title} onChange={(e) => setTitle(e.target.value)} />
        <button type="submit">Add</button>
      </form>
      <Board tasks={tasks} onMove={move} />
    </div>
  );
}

Lesson: Thinking in React →