React children 사용법 컴포넌트 합성과 재사용 UI 설계

TaskFlow는 작업을 추가·완료·삭제하는 할 일 앱입니다. 이 선택 실습에서는 React로 화면과 상태를 이어서 만듭니다.

이번 단계에서는 TaskCard라는 공통 틀을 만들고 내부 영역을 조합합니다.

선택: 연재 프로젝트와 전체 자료

연재 프로젝트를 이어 만드는 분을 위한 자료입니다. 이 글의 개념과 예제만 찾으셨다면 필요한 파일과 실행 방법만 펼쳐보세요.

TaskFlow 프로젝트 적용

시작 체크포인트: 이전: React props 사용법 부모에서 자식으로 데이터 전달하는 구조의 완료 상태에서 이어갑니다.

이전 회차 완료 ZIP으로 시작하기. 새 폴더에 풀어 현재 회차 완료본과 나란히 비교합니다.

이전 완료본과 달라진 파일: package.json, src/components/TaskCard.tsx, src/components/TaskItem.tsx. 아래 변경 설명을 따라 수정하고 전체 코드의 같은 파일과 대조합니다.

변경 순서: src/components/TaskCard.tsx에 children과 actions 영역을 만들고 TaskItem.tsx의 공통 틀을 이 컴포넌트로 교체합니다. 아래 완료 코드와 비교한 뒤 기존 실행 확인 절차를 수행합니다.

완료 코드 ZIP 다운로드 — step-06-composition

이전 체크포인트:

step-05-props

지금 TaskItem은 task 데이터와 이벤트 함수를 받아 한 컴포넌트 안에서 모든 구조를 직접 렌더링합니다.

이번 단계에서는 TaskCard라는 공통 틀을 만들고 내부 영역을 조합합니다.

변경 파일

src/
├─ components/
│  ├─ Header.tsx
│  ├─ TaskCard.tsx
│  ├─ TaskItem.tsx
│  └─ TaskList.tsx
├─ App.tsx
└─ types/task.ts

Before

<li>
  <button>완료</button>
  <span>{task.title}</span>
  <button>삭제</button>
</li>

After

<TaskCard
  actions={
    <>
      <button type="button" onClick={() => onToggle(task.id)}>
        {task.completed ? '완료 취소' : '완료'}
      </button>
      <button type="button" onClick={() => onDelete(task.id)}>
        삭제
      </button>
    </>
  }
>
  <span>{task.title}</span>
</TaskCard>

TaskCard는 공통 구조만 담당하고 TaskItem은 task 데이터와 이벤트 의미를 담당합니다.

TaskList와 App의 데이터 흐름은 이전 단계와 동일합니다.

실행 확인

npm run build

• 작업 제목이 기존처럼 표시되는지 확인합니다.
• 완료/삭제 버튼 이벤트가 그대로 동작하는지 확인합니다.
• TaskCard가 task의 데이터 처리 로직을 알지 않아도 되는지 확인합니다.

완료 체크포인트:

step-06-composition

전체 코드 뷰어의 모든 파일은 다운로드 ZIP과 같습니다. ZIP은 독립 실행할 수 있는 완료 시점의 코드입니다. Node.js 22.12 이상에서 npm install 후 npm run dev로 실행하고, npm run build로 검사합니다.

<!doctype html>
<html lang="ko"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>TaskFlow</title></head><body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body></html>

{
  "name": "taskflow-step-06-composition",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "engines": {
    "node": ">=22.12.0"
  },
  "scripts": {
    "dev": "vite --host 127.0.0.1",
    "build": "tsc --noEmit && vite build",
    "preview": "vite preview --host 127.0.0.1"
  },
  "dependencies": {
    "react": "19.3.0",
    "react-dom": "19.3.0"
  },
  "devDependencies": {
    "typescript": "7.0.2",
    "vite": "8.3.0",
    "@vitejs/plugin-react": "6.1.1",
    "@types/react": "19.3.0",
    "@types/react-dom": "19.3.0",
    "@types/node": "26.6.2"
  }
}

import Header from './components/Header';
import TaskList from './components/TaskList';
import type { Task } from './types/task';

const tasks: Task[] = [
  { id: 'task-1', title: 'props 구조 익히기', completed: true },
  { id: 'task-2', title: '이벤트 함수 전달하기', completed: false },
];

function App() {
  const handleToggle = (id: string) => {
    console.log('toggle', id);
  };

  const handleDelete = (id: string) => {
    console.log('delete', id);
  };

  return (
    <main className="app">
      <Header />
      <TaskList
        tasks={tasks}
        onToggle={handleToggle}
        onDelete={handleDelete}
      />
    </main>
  );
}

export default App;

export default function Header() {
  return (
    <header>
      <p className="eyebrow">React Learning Project</p>
      <h1>TaskFlow</h1>
      <p>오늘 할 일을 하나씩 정리해 보세요.</p>
    </header>
  );
}

import type { ReactNode } from 'react';

type TaskCardProps = {
  children: ReactNode;
  actions?: ReactNode;
};

export default function TaskCard({
  children,
  actions,
}: TaskCardProps) {
  return (
    <li className="task-card">
      <div className="task-card__content">
        {children}
      </div>
      {actions ? (
        <div className="task-card__actions">
          {actions}
        </div>
      ) : null}
    </li>
  );
}

import type { Task } from '../types/task';
import TaskCard from './TaskCard';

type TaskItemProps = {
  task: Task;
  onToggle: (id: string) => void;
  onDelete: (id: string) => void;
};

export default function TaskItem({
  task,
  onToggle,
  onDelete,
}: TaskItemProps) {
  return (
    <TaskCard
      actions={
        <>
          <button
            type="button"
            onClick={() => onToggle(task.id)}
          >
            {task.completed ? '완료 취소' : '완료'}
          </button>
          <button
            type="button"
            onClick={() => onDelete(task.id)}
          >
            삭제
          </button>
        </>
      }
    >
      <span>{task.title}</span>
    </TaskCard>
  );
}

import TaskItem from './TaskItem';
import type { Task } from '../types/task';

type TaskListProps = {
  tasks: Task[];
  onToggle: (id: string) => void;
  onDelete: (id: string) => void;
};

export default function TaskList({
  tasks,
  onToggle,
  onDelete,
}: TaskListProps) {
  if (tasks.length === 0) {
    return <p>등록된 작업이 없습니다.</p>;
  }

  return (
    <section>
      <h2>작업 목록</h2>
      <ul>
        {tasks.map((task) => (
          <TaskItem
            key={task.id}
            task={task}
            onToggle={onToggle}
            onDelete={onDelete}
          />
        ))}
      </ul>
    </section>
  );
}

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: Arial, sans-serif;
  color: #111;
  background: #f5f5f5;
}

.app {
  width: min(720px, calc(100% - 32px));
  margin: 48px auto;
}

.eyebrow {
  color: #666;
  font-size: 14px;
}

ul {
  padding-left: 20px;
}

button, input, select { min-height: 44px; font: inherit; }
button, input, select { border: 1px solid #aaa; padding: 8px 12px; }
button { cursor: pointer; }
button:disabled { cursor: wait; opacity: .6; }
ul { list-style: none; padding: 0; display: grid; gap: 12px; }
.task-card { border: 1px solid #ccc; padding: 16px; display: flex; gap: 12px; flex-wrap: wrap; align-items: center; }
.task-card__content, .task-card__actions { display: flex; gap: 12px; flex-wrap: wrap; align-items: center; }
form, section { margin-block: 20px; }
input:not([type="checkbox"]), select { max-width: 100%; }
details { margin-block: 24px; } summary { cursor: pointer; min-height: 44px; }
body { overflow-wrap: anywhere; }
[role="dialog"], [data-radix-popper-content-wrapper] { --radius: 0; }

import { StrictMode } from 'react';
import { createRoot } from 'react-dom/client';
import './index.css';
import App from './App';

createRoot(document.getElementById('root')!).render(
  <StrictMode>
    <App />
  </StrictMode>,
);

export type Task = {
  id: string;
  title: string;
  completed: boolean;
};

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": [
      "ES2022",
      "DOM",
      "DOM.Iterable"
    ],
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "jsx": "react-jsx",
    "strict": true,
    "skipLibCheck": true,
    "noEmit": true,
    "allowImportingTsExtensions": true,
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "types": [
      "vite/client"
    ],
    "paths": {
      "@/*": [
        "./src/*"
      ]
    }
  },
  "include": [
    "src",
    "vite.config.ts"
  ]
}

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig({ plugins: [react()] });

글 소개·학습 준비·전체 목차

React · 6 / 32 · 필수 학습 · children·컴포넌트 합성

props로 값과 이벤트를 전달할 수 있게 되면 다음 단계는 “컴포넌트를 어떻게 조합할 것인가”입니다. 모든 UI를 하나의 거대한 props 객체로 제어하면 재사용하기 어렵고 API도 복잡해집니다.

이 글에서는 children을 이용해 컴포넌트 안에 다른 UI를 넣는 방법과, 데이터를 전달하는 props와 UI를 조합하는 children의 역할 차이를 설명합니다. 하단에서는 TaskFlow의 TaskItem을 TaskCard 구조로 정리합니다.

이번 글에서 배우는 내용

• children의 의미
• 데이터 props와 UI 합성의 차이
• wrapper 컴포넌트
• 여러 작은 컴포넌트를 조합하는 방법
• 재사용 가능한 컴포넌트 API 설계 기준
• 과도한 props를 줄이는 방법

목차