plaintext
코드 복사
app/
├── layout.tsx          // 여기서는 `params`를 사용할 수 없음
├── teams/
│   ├── layout.tsx      // 여기서도 `params`를 사용할 수 없음 (정적 경로)
│   ├── [team]/
│   │   ├── layout.tsx  // 여기서는 `params`를 사용할 수 있음 (동적 경로)
│   │   └── page.tsx

페이지 접근 시 레이아웃 흐름 예시

동적 경로와 params의 역할

Next.js에서 동적 경로는 페이지의 URL을 기준으로 동적으로 콘텐츠를 생성할 수 있게 해주는 기능이야. 예를 들어, /teams/[team] 같은 URL 구조가 있다고 가정해보자. 이 URL은 팀 이름을 기준으로 페이지를 생성하게 되지. 여기서 [team] 부분이 바로 동적 경로 매개변수야.

params는 이 동적 경로 매개변수의 값을 담고 있는 객체로, Next.js가 해당 페이지에 접근할 때 자동으로 전달해줘. 이렇게 함으로써, 어떤 팀 페이지에 접근하더라도 [team]의 값이 params 객체를 통해 전달되며, 해당 값을 바탕으로 각 팀에 맞는 데이터를 렌더링할 수 있게 돼.

layout.tsx에서 params의 사용

layout.tsx는 Next.js에서 특정 경로에 맞는 레이아웃을 정의하는 파일이야. 만약 /teams/[team] 경로에 대해 layout.tsx 파일이 있다면, 이 파일에서 params 객체를 통해 URL의 team 값을 접근할 수 있어. 위 예시에서는 params가 Promise 객체로 전달되기 때문에 await 키워드로 값을 받아오고 있어.

예제 코드와 함께 다시 살펴볼게.

// app/teams/[team]/layout.tsx
export default async function Layout({
  children,
  params,
}: {
  children: React.ReactNode;
  params: Promise<{ team: string }>;
}) {
  const team = (await params).team;

  return (
    <div>
      <h1>{team} 팀 페이지</h1>
      <div>{children}</div>
    </div>
  );
}