AppDir

next.js์—์„œ layout๊ณผ routing ๊ฒฝํ—˜์„ ๊ฐœ์„ ์‹œํ‚ค๊ณ  React ์ตœ์‹  ๊ธฐ์ˆ ์„ ์ง€์›ํ•˜๊ธฐ์œ„ํ•ด, next.js 13๋ถ€ํ„ฐ ์ง€์›ํ•˜๋Š” ๋””๋ ‰ํ„ฐ๋ฆฌ ๋ฐฉ์‹. ๊ธฐ์กด์˜ pages ๋””๋ ‰ํ„ฐ๋ฆฌ๋ฅผ ๋Œ€์ฒดํ•œ๋‹ค.

23๋…„ 04์›” ๊ธฐ์ค€์œผ๋กœ ์•„์ง์€ ๋ฒ ํƒ€๋ฒ„์ „์œผ๋กœ ํ”„๋กœ๋•์…˜์—์„œ ์‚ฌ์šฉํ•˜๋Š” ๊ฑด ์ถ”์ฒœํ•˜์ง€ ์•Š๋Š”๋‹ค๊ณ  ํ•œ๋‹ค. ํ•˜์ง€๋งŒ, ์ข‹์€ ๊ธฐ๋Šฅ๋“ค์ด ๋งŽ๊ธฐ์— ํ•™์Šตํ•ด๋ด๋„ ๊ดœ์ฐฎ์„ ๊ฑฐ ๊ฐ™๋‹ค.

file conventions

app directory์—์„œ ํŒŒ์ผ ์ปจ๋ฒค์…˜์€ ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

  • page.js : ํ•ด๋‹น path์˜ UI๋ฅผ ๋‹ด๋‹นํ•˜๋ฉฐ, publicํ•˜๊ฒŒ ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•จ.
    • route.js : ์„œ๋ฒ„ ์‚ฌ์ด๋“œ API endpoint
  • layout.js : route segment ๊ฐ„์— ๊ณต์œ  ๊ฐ€๋Šฅํ•œ UI. ์ž์‹ layout, page๋ฅผ ๊ฐ์Œˆ
    • template.js : layout ์•„๋ž˜์—์„œ ์ž์‹ layout, page๋ฅผ ๊ฐ์Œˆ.
  • loading.js : ํŽ˜์ด์ง€๋ฅผ ๋กœ๋”ฉ ์ค‘์ผ ๋•Œ ๋ณด์—ฌ์ฃผ๋Š” UI. ํŽ˜์ด์ง€๋‚˜ child segment๋ฅผ React Suspense๋กœ ๊ฐ์‹ผ๋‹ค.
  • error.js : page๋‚˜ child segment์—์„œ ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ–ˆ์„ ๊ฒฝ์šฐ ๋ณด์—ฌ์คŒ. React Error Boundary ์‚ฌ์šฉ.
    • global-error.js : root layout์—์„œ ์—๋Ÿฌ๋ฅผ ์žก์•˜์„ ๋•Œ ๋ณด์—ฌ์ฃผ๋Š” UI
  • not-found.js : ํ•ด๋‹น route segment ์•„๋ž˜์—์„œ ๋งค์น˜๋˜๋Š” route๊ฐ€ ์—†์„ ๋•Œ ๋ณด์—ฌ์ฃผ๋Š” UI

Layout

next.js 13๋ถ€ํ„ฐ๋Š” path๊ฐ€ ๋ฐ”๋€Œ๋”๋ผ๋„ ๋ฆฌ๋ Œ๋”๋ง ์—†์ด ์ด์ „ ๋ ˆ์ด์•„์›ƒ์„ ์œ ์ง€ํ•  ์ˆ˜ ์žˆ๋‹ค. ์ด๋•Œ ์ƒํƒœ๋„ ์œ ์ง€๋œ๋‹ค.

์‚ฌ์šฉ๋ฒ•์€ ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

  1. app directory๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค.
  2. ํŠน์ • ํŽ˜์ด์ง€ ์•„๋ž˜์—์„œ ์–ด๋–ค ํŒŒ์ผ์„ layout.js๋กœ ์ƒ์„ฑํ•˜๋ฉด, ๊ทธ๊ฒƒ์ด ๋ ˆ์ด์•„์›ƒ ์ปดํฌ๋„ŒํŠธ์ด๋‹ค.
// app/dashboard/layout.ts
export default function DashboardLayout({
  children, // will be a page or nested layout
}: {
  children: React.ReactNode,
}) {
  return (
    <section>
      {/* Include shared UI here e.g. a header or sidebar */}
      <nav></nav>
 
      {children}
    </section>
  );
}

์ฐธ๊ณ 

  • ๋ชจ๋“  route segment๋Š” ์ž์‹ ๋งŒ์˜ layout์„ ๊ฐ€์งˆ ์ˆ˜ ์žˆ๋‹ค. ์ด layout์€ ๊ทธ segment ์•„๋ž˜์˜ ๋ชจ๋“  ํŽ˜์ด์ง€์— ์ ์šฉ๋œ๋‹ค.
  • layout์€ ๋””ํดํŠธ๋กœ nested๋œ๋‹ค. ๊ฐ ๋ถ€๋ชจ layout์€ ์ž์‹ layout์„ ๊ฐ์‹ผ๋‹ค.
  • Route Groups๋ฅผ ์ง€์ •ํ•˜์—ฌ ํŠน์ •ํ•œ route segment์—๋งŒ layout์„ ๊ณต์œ ํ•  ์ˆ˜๋„ ์žˆ๋‹ค.
  • Layout์€ ๋””ํดํŠธ๋กœ Server Component์ด๋‹ค. ๋‹ค๋งŒ Client Component๋กœ ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.
  • ๋ถ€๋ชจ ์ž์‹ layout ๊ฐ„์— ๋ฐ์ดํ„ฐ๋ฅผ ์ฃผ๊ณ  ๋ฐ›๋Š”๊ฑด ๋ถˆ๊ฐ€๋Šฅํ•˜๋‹ค. ํ•˜์ง€๋งŒ, ๊ฐ™์€ ๋ฐ์ดํ„ฐ๋ฅผ fetch ํ•˜๋ฉด ๋ฆฌ์•กํŠธ์—์„œ ์ž๋™์œผ๋กœ ์š”์ฒญ์„ ์ค‘๋ณต์ œ๊ฑฐํ•œ๋‹ค.
  • layout.js์™€ page.js๋ฅผ ๊ฐ™์€ ํด๋”์— ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ๋‹ค. layout.js๊ฐ€ page.js๋ฅผ ๊ฐ์‹ผ๋‹ค.

Root Layout (Required)

app directory์˜ ์ตœ์ƒ๋‹จ์— ๋ฐ˜๋“œ์‹œ ์žˆ์–ด์•ผํ•จ. ์ด root layout์„ ํ†ตํ•ด ํด๋ผ์ด์–ธํŠธ์—์„œ ์ตœ์ดˆ์— ๋ฐ›๋Š” HTML์„ ์ˆ˜์ •ํ•  ์ˆ˜ ์žˆ๋‹ค. (pages ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ์˜ _document.js ๊ฐ™์€ ๋А๋‚Œ)

์ฐธ๊ณ 

  • <html>, <body>๋ฅผ ๋ฐ˜๋“œ์‹œ ๊ฐ€์ง€๊ณ  ์žˆ์–ด์•ผํ•œ๋‹ค.
  • <head>๋ฅผ ์ˆ˜์ •ํ•˜์—ฌ SEO๋ฅผ ์ง€์›ํ•  ์ˆ˜ ์žˆ์Œ.
  • Route Group์„ ์‚ฌ์šฉํ•˜์—ฌ ์—ฌ๋Ÿฌ root layout์„ ๊ฐ€์งˆ ์ˆ˜ ์žˆ์Œ.
  • root layout์€ ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ์ด๋ฉฐ, ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋กœ ์„ค์ •ํ•  ์ˆ˜ ์—†๋‹ค.

template

layout๊ณผ ๊ฐ™์ด child layout, page๋ฅผ ๊ฐ์‹ธ์ง€๋งŒ, routing์— ๊ฑฐ์ณ ์ƒํƒœ๊ฐ€ ์œ ์ง€๋˜์ง€์•Š๋Š”๋‹ค. path๊ฐ€ ๋ณ€๊ฒฝ๋˜๋ฉด ๋ฆฌ๋ Œ๋”๋ง๋œ๋‹ค. ์‚ฌ์šฉํ•˜๋ ค๋ฉด, route segment์— template.js๋กœ ์ƒ์„ฑํ•˜๋ฉด ๋œ๋‹ค. ๊ทธ๋Ÿผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด layout ์•„๋ž˜์—์„œ ์ž์‹ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๊ฐ์‹ธ๋„๋ก ์ ์šฉ๋œ๋‹ค.

<Layout>
  {/* Note that the template is given a unique key. */}
  <Template key={routeParam}>{children}</Template>
</Layout>

Server component

app directory๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด, ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ ๊ฐ„ํŽธํ•˜๊ฒŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด, ํด๋ผ์ด์–ธํŠธ์—๊ฒŒ ์ตœ์ดˆ๋กœ ๋ณด๋‚ด์ง€๋Š” JS ์ฝ”๋“œ๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ์–ด ๋น ๋ฅธ ํŽ˜์ด์ง€๋กœ๋”ฉ์— ๋„์›€์„ ์ค€๋‹ค.

app directory ์•„๋ž˜์— ์žˆ๋Š” ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ๋Š” ๊ธฐ๋ณธ์ ์œผ๋กœ ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ์ด๋‹ค. ๋”ฐ๋ผ์„œ ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•ด ๋ณ„๋‹ค๋ฅธ ์ž‘์—…์ด ํ•„์š”์—†๋‹ค.

route๊ฐ€ next.js์—์„œ ๋กœ๋”ฉ๋˜๋ฉด, ์ตœ์ดˆ์˜ HTML์€ ์„œ๋ฒ„์—์„œ ๋ Œ๋”๋ง ๋œ๋‹ค. ๊ทธ๋ฆฌ๊ณ  ๊ทธ HTML๋Š” ์ ์ง„์ ์œผ๋กœ ๋ธŒ๋ผ์šฐ์ €์— ์ „๋‹ฌ๋œ๋‹ค. ์ด๋•Œ next.js์™€ react client-side runtime์„ ๋น„๋™๊ธฐ์ ์œผ๋กœ ๋กœ๋”ฉํ•œ๋‹ค. ์ด๋กœ์จ ํด๋ผ์ด์–ธํŠธ๊ฐ€ ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋‹ค๋ฃจ๊ณ , ์ธํ„ฐ๋ž™์…˜ํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋œ๋‹ค.

์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ตœ์ดˆ ํŽ˜์ด์ง€ ๋กœ๋”ฉ์€ ๋นจ๋ผ์ง€๊ณ , client-side runtime์€ ์บ์‹œ๋  ์ˆ˜ ์žˆ์œผ๋ฉฐ ์‚ฌ์ด์ฆˆ๋ฅผ ์˜ˆ์ธกํ•  ์ˆ˜ ์žˆ๋‹ค. ๊ทธ๋ฆฌ๊ณ  ์ด ์ตœ์ดˆ๋กœ ๋‚ด๋ ค์ง€๋Š” JS ๋ฒˆ๋“ค ์‚ฌ์ด์ฆˆ๋Š” ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜ ํฌ๊ธฐ๊ฐ€ ์ปค์ง€๋Š”๋งŒํผ ๋”ฐ๋ผ ์ปค์ง€์ง€ ์•Š๋Š”๋‹ค. ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋ฅผ ํ†ตํ•ด ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜์— ์ถ”๊ฐ€๋œ client-side interactivity ๋งŒํผ๋งŒ ์ฆ๊ฐ€ํ•˜๊ฒŒ ๋œ๋‹ค.

app directory์—์„œ network boundary๋Š” ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ๋ƒ, ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋ƒ์— ๋‹ฌ๋ ค์žˆ๋‹ค. pages directory์—์„œ๋Š” getStaticProps, getServerSideProps์— ๋‹ฌ๋ ค์žˆ๋‹ค.

Client Component

next.js์—์„œ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋Š” ์„œ๋ฒ„์—์„œ prerender ๋˜๊ณ  ํด๋ผ์ด์–ธํŠธ์—์„œ hydration ๋œ๋‹ค. pages/ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ๋™์ž‘ํ•˜๋Š” ๋ฐฉ์‹์ด๋‹ค. app ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํŒŒ์ผ ์ƒ๋‹จ์— "use client";๋ฅผ ์ž‘์„ฑํ•˜๋ฉด ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ๋œ๋‹ค.

'use client';
import { useState } from 'react';
 
export default function Counter() {
  const [count, setCount] = useState(0);
 
  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>Click me</button>
    </div>
  );
}

์ด๋•Œ ํด๋ผ์ด์–ธํŠธ ๋ฒˆ๋“ค๋กœ ํฌํ•จ๋˜๋Š” ์ปดํฌ๋„ŒํŠธ๋“ค์€ ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

  • "use client";๊ฐ€ ์ž‘์„ฑ๋œ ์ปดํฌ๋„ŒํŠธ
  • "use client";๊ฐ€ ์ž‘์„ฑ๋œ ์ปดํฌ๋„ŒํŠธ์— import๋œ ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ๋“ค
  • ์ž์‹์ปดํฌ๋„ŒํŠธ

๋”ฐ๋ผ์„œ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ๋Š” ์ตœ๋Œ€ํ•œ ๋ง๋‹จ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•  ๊ฒƒ์„ ์ถ”์ฒœํ•˜๊ณ  ์žˆ๋‹ค.

when to use server component vs client component?

next.js ํŒ€์—์„œ๋Š” ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์‚ฌ์šฉํ•˜๋‹ค๊ฐ€ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋Š” ํ•„์š”ํ•  ๋•Œ๋งŒ ์‚ฌ์šฉํ•  ๊ฒƒ์„ ์ถ”์ฒœํ•œ๋‹ค. ๊ทธ๋Ÿผ ์–ธ์ œ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ํ•„์š”ํ• ๊นŒ?

  • interactivity๋‚˜ event listener(onClick(), onChange() ๋“ฑ)๊ฐ€ ํ•„์š”ํ•  ๋•Œ.
  • lifecycle effect๋‚˜ state๊ฐ€ ํ•„์š”ํ•  ๋•Œ
  • browser-only API๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ
  • React Class Component๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ

ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ ์‚ฌ์šฉํ•˜๊ธฐ

๋ฆฌ์•กํŠธ์—์„œ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์•ˆ์— ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ importing ํ•˜๋Š” ๊ฑด ์ œ์•ฝ์ด ์žˆ๋‹ค. ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ๋Š” server-only code ์ด๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ๋”ฐ๋ผ์„œ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„  ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ๋ฅผ importํ•  ์ˆ˜ ์—†๋‹ค.

'use client';
 
// โŒ This pattern will not work. You cannot import a Server
// Component into a Client Component
import ServerComponent from './ServerComponent';
 
export default function ClientComponent() {
  return (
    <>
      <ServerComponent />
    </>
  );
}

ํ•˜์ง€๋งŒ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์— props๋กœ ๋„˜๊ธฐ๋Š” ๊ฒƒ์€ ๊ฐ€๋Šฅํ•˜๋‹ค

'use client';
 
export default function ClientComponent({children}) {
  return (
    <>
      {children}
    </>
  );
}
// โœ… This pattern works. You can pass a Server Component
// as a child or prop of a Client Component.
import ClientComponent from "./ClientComponent";
import ServerComponent from "./ServerComponent";
 
// Pages are Server Components by default
export default function Page() {
  return (
    <ClientComponent>
      <ServerComponent />
    </ClientComponent>
  );
}

์ด๋ ‡๊ฒŒ ์‚ฌ์šฉํ•˜๋ฉด ๋ฆฌ์•กํŠธ๋Š” ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋กœ child๋ฅผ ๋„˜๊ธฐ๊ธฐ ์ „์— <ServerComponent/>๋ฅผ ์„œ๋ฒ„์—์„œ ๋ Œ๋”๋งํ•ด์•ผํ•œ๋‹ค๋Š” ๊ฒƒ์„ ์•ˆ๋‹ค. ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์˜ ์ž…์žฅ์—์„œ๋Š” child ๊ฐ€ ์ด๋ฏธ ๋ Œ๋”๋ง ๋˜์–ด์žˆ๋‹ค. layout์ด ์ด ๋ฐฉ์‹์œผ๋กœ ๊ตฌํ˜„๋˜์–ด์žˆ๋‹ค.

passing props from server to client component

์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋กœ props๋ฅผ ๋„˜๊ธธ ๋• serialization ๋  ํ•„์š”๊ฐ€ ์žˆ๋‹ค. function, Date ๋“ฑ์€ ์ง์ ‘ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋กœ ๋„˜๊ธธ ์ˆ˜ ์—†๋‹ค๋Š” ๊ฒƒ์ด๋‹ค.

server-only code๊ฐ€ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‹คํ–‰๋˜๋Š” ๊ฒƒ์„ ๋ง‰๋Š” ๋ฐฉ๋ฒ•

server-only ํŒจํ‚ค์ง€๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ, ์„œ๋ฒ„์—์„œ๋งŒ ์‹คํ–‰๋˜์–ด์•ผํ•˜๋Š” ์ฝ”๋“œ๊ฐ€ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉ๋˜๋ฉด build-time error๋ฅผ ๋‚ด๋„๋ก ํ•  ์ˆ˜ ์žˆ๋‹ค.

import "server-only";
 
export async function getData() {
  let resp = await fetch("https://external-service.com/data", {
    headers: {
      authorization: process.env.API_KEY,
    },
  });
 
  return resp.json();
}

๋งˆ์ฐฌ๊ฐ€์ง€๋กœ client-only ํŒจํ‚ค์ง€๋„ ์ œ๊ณตํ•œ๋‹ค. ์ด ํŒจํ‚ค์ง€๋Š” window ๊ฐ์ฒด๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ํ•จ์ˆ˜์™€ ๊ฐ™์ด ํด๋ผ์ด์–ธํŠธ์—์„œ๋งŒ ์‚ฌ์šฉ๋˜์–ด์•ผํ•˜๋Š” ํ•จ์ˆ˜์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

third party packages

ํ˜„์žฌ ๋งŽ์€ ์„œ๋“œํŒŒํ‹ฐ ํŒจํ‚ค์ง€๋“ค์€ useState ๋“ฑ์„ ์‚ฌ์šฉํ•จ์—๋„ use client๋ฅผ ๋ถ™์ด์ง€ ์•Š์€ ๊ฒฝ์šฐ๊ฐ€ ๋งŽ๋‹ค. ์ด๋Ÿฌํ•œ ์„œ๋“œํŒŒํ‹ฐ ํŒจํ‚ค์ง€๋ฅผ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์€ ํฐ ๋ฌธ์ œ๊ฐ€ ์—†๋‹ค. ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์— ์ด๋ฏธ use client๊ฐ€ ๋ถ™์–ด์žˆ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ํ•˜์ง€๋งŒ ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•  ๋• ์˜ค๋ฅ˜๊ฐ€ ๋œฐ ๊ฒƒ์ด๋‹ค. ๋”ฐ๋ผ์„œ ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•  ๊ฒฝ์šฐ์—” ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์„œ๋“œํŒŒํ‹ฐ ํŒจํ‚ค์ง€๋ฅผ ๊ฐ์‹ธ๊ณ  ์‚ฌ์šฉํ•˜๋ฉด ๋œ๋‹ค.

'use client';
 
import { AcmeCarousel } from 'acme-carousel';
 
export default AcmeCarousel;
import Carousel from './carousel';
 
export default function Page() {
  return (
    <div>
      <p>View pictures</p>
 
      {/* ๐ŸŸข Works, since Carousel is a Client Component */}
      <Carousel />
    </div>
  );
}

data fetching

ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ๋„ data feching์€ ํ•  ์ˆ˜ ์žˆ์ง€๋งŒ, ๊ฐ€๋Šฅํ•œ ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ ํ•˜๋Š” ๊ฒƒ์ด ์„ฑ๋Šฅ์ƒ ์ข‹๋‹ค.

context

ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ๋Š” context๋‚˜ provider๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ context๋ฅผ ๊ณต์œ ํ•  ์ˆ˜ ์žˆ๋‹ค. ํ•˜์ง€๋งŒ, ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ๋Š” react state๋ฅผ ๊ฐ€์ง€๊ณ  ์žˆ์ง€ ์•Š๋‹ค.

๋”ฐ๋ผ์„œ next.js ํŒ€์€ ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ ๊ฐ„์— ๋ฐ์ดํ„ฐ ๊ตํ™˜์„ ์œ„ํ•ด native javascript ํŒจํ„ด์„ ์ œ์•ˆํ•œ๋‹ค. ์˜ˆ๋ฅผ๋“ค์–ด ๋งŒ์•ฝ ์—ฌ๋Ÿฌ ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ ์‚ฌ์ด์—์„œ DB connection์„ ๊ณต์œ ํ•ด์•ผํ•œ๋‹ค๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

// utils/database.js
export const db = new DatabaseConnection(...);
// app/users/layout.js
import { db } from "@utils/database";
 
export async function UsersLayout() {
  let users = await db.query(...);
  // ...
}
// app/users/[id]/pages.js
import { db } from "@utils/database";
 
export async function DashboardPage() {
  let user = await db.query(...);
  // ...
}

์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ๋Š” ๊ฐ™์€ context์—์„œ fetch ์ค‘๋ณต๋œ ์š”์ฒญ์„ ์ž๋™์œผ๋กœ ์ œ๊ฑฐ๋œ๋‹ค. ๋”ฐ๋ผ์„œ fetch request result๋ฅผ ์–ด๋–ป๊ฒŒ ๊ณต์œ ํ• ์ง€๋Š” ๊ฑฑ์ •ํ•˜์ง€ ์•Š์•„๋„ ๋œ๋‹ค. revalidate ๋“ฑ์€ ์–ด๋–ป๊ฒŒ ํ•˜๋Š”์ง€๋Š” ๋ฐ‘์— data fetching ์„น์…˜์—์„œ ๋‹ค๋ฃฌ๋‹ค.

Support for data fetching

fetch Web API๋Š” React์™€ next.js์—์„œ ํ™•์žฅ๋˜์—ˆ๋‹ค.

  • React์—์„œ๋Š” automatic request deduping์„ ์œ„ํ•ด fetch๋ฅผ ํ™•์žฅํ•˜์˜€๋‹ค.
  • next.js์—์„œ๋Š” options๋ฅผ ํ™•์žฅํ•˜์—ฌ caching/revalidating ๊ทœ์น™์„ ์„ค์ •ํ•˜์˜€๋‹ค.

์ด๋ฅผ ํ†ตํ•ด next.js์—์„œ๋Š” ํ•˜๋‚˜์˜ API๋กœ SSG, SSR, ISR์„ ์‚ฌ์šฉ๊ฐ€๋Šฅํ•˜๋‹ค. (fetch์— ๋Œ€ํ•ด์„œ)

// This request should be cached until manually invalidated.
// Similar to `getStaticProps`.
// `force-cache` is the default and can be omitted.
fetch(URL, { cache: 'force-cache' });
 
// This request should be refetched on every request.
// Similar to `getServerSideProps`.
fetch(URL, { cache: 'no-store' });
 
// This request should be cached with a lifetime of 10 seconds.
// Similar to `getStaticProps` with the `revalidate` option.
fetch(URL, { next: { revalidate: 10 } });

next.js์—์„œ๋Š” ์›ฌ๋งŒํ•˜๋ฉด ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ์—์„œ data fetching ์ˆ˜ํ–‰์„ ๊ถŒ์žฅํ•œ๋‹ค. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์ด์ ์ด ์žˆ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.

  • ๋ฐ์ดํ„ฐ ๋ฆฌ์†Œ์Šค๋กœ์˜ ์ง์ ‘ ์ ‘๊ทผ
  • API key์™€ ๊ฐ™์€ ๋ฏผ๊ฐํ•œ ์ •๋ณด์˜ ๋…ธ์ถœ ์˜ˆ๋ฐฉ
  • data fetching๊ณผ render๊ฐ€ ๊ฐ™์€ ํ™˜๊ฒฝ์—์„œ ์ด๋ฃจ์–ด์ง. ๋”ฐ๋ผ์„œ ํด๋ผ์ด์–ธํŠธ์™€ ์„œ๋ฒ„ ์‚ฌ์ด์˜ ํ†ต์‹ ์ด ์ค„์–ด๋“ ๋‹ค.
  • multiple data fetching์„ ํ•˜๋‚˜์˜ round-trip์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค. ํด๋ผ์ด์–ธํŠธ์—์„œ ๊ฐœ๋ณ„์ ์œผ๋กœ ์ด๋ฃจ์–ด์ง€๋Š” ๊ฒƒ๊ณผ ๋‹ค๋ฅด๋‹ค.
  • ํด๋ผ์ด์–ธํŠธ-์„œ๋ฒ„ waterfall์„ ์ค„์ž„
  • ์„œ๋ฒ„๊ฐ€ ๋ฐ์ดํ„ฐ ๋ฆฌ์†Œ์Šค์— ๊ฐ€๊นŒ์ด ์žˆ๋‹ค๋ฉด ์„ฑ๋Šฅ ํ–ฅ์ƒ์˜ ํšจ๊ณผ๊ฐ€ ์žˆ์Œ.

ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ์—์„œ๋„ data fetching์€ ๊ฐ€๋Šฅํ•˜์ง€๋งŒ, ๊ทธ๋•Œ๋Š” SWR๋‚˜ React Query ์‚ฌ์šฉ์„ ์ถ”์ฒœํ•˜๊ณ  ์žˆ๋‹ค. ํ–ฅํ›„ React์˜ use() hook์„ ์‚ฌ์šฉํ•  ์ˆ˜๋„ ์žˆ๋‹ค๊ณ  ํ•œ๋‹ค.

component-level data fetching

์ปดํฌ๋„ŒํŠธ์—์„œ data fetching์„ ์ˆ˜ํ–‰ํ• ๋•Œ ๋‘๊ฐ€์ง€ ๋ชจ๋ธ์ด ์žˆ๋‹ค.

  • parallel : route ๋‚ด request๊ฐ€ ๋™์‹œ์— ์ด๋ฃจ์–ด์ง„๋‹ค. ์ด๋Š” client-server waterfall์„ ์ค„์ด๋ฉฐ ๋ฐ์ดํ„ฐ ๋กœ๋”ฉ์— ๊ฑธ๋ฆฌ๋Š” ์ด ์‹œ๊ฐ„์„ ์ค„์ธ๋‹ค.
  • sequential : route ๋‚ด request๊ฐ€ ์ˆœ์ฐจ์ ์œผ๋กœ ์ด๋ฃจ์–ด์ง„๋‹ค. ํ•˜๋‚˜์˜ ์š”์ฒญ์ด ๋‹ค๋ฅธ ์š”์ฒญ์— ์˜์กด์ ์ผ๋•Œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

sequential-parallel-data-fetching

๋˜ํ•œ ์œ„์— ์–ธ๊ธ‰ํ–ˆ๋“ฏ์ด fetch()์€ ์ž๋™์œผ๋กœ deduping ๋œ๋‹ค. ๋งŒ์•ฝ ํŠธ๋ฆฌ๋‚ด ์—ฌ๋Ÿฌ ์ปดํฌ๋„ŒํŠธ์—์„œ ๊ฐ™์€ ๋ฐ์ดํ„ฐ๋ฅผ ์›ํ•œ๋‹ค๋ฉด, next.js๋Š” ์ž๋™์œผ๋กœ fetch request(GET)๋ฅผ ์บ์‹ฑํ•˜๊ณ  ๊ฐ™์€ ์š”์ฒญ์ด ๋ฐœ์ƒํ•˜๋ฉด ์ €์žฅํ–ˆ๋˜ ๊ฒƒ์„ ๋Œ๋ ค์ค€๋‹ค.

  • ์„œ๋ฒ„์—์„œ๋Š” ๋ Œ๋”๋ง ํ”„๋กœ์„ธ์Šค๊ฐ€ ์ข…๋ฃŒ๋ ๋•Œ๊นŒ์ง€ ์บ์‹œ๊ฐ€ ์œ ์ง€๋œ๋‹ค.
    • ์ด๋Š” Layout, Page, Server Component, generateMetadata, generateStaticParams์—์„œ ์ž‘์„ฑ๋œ fetch ์š”์ฒญ์— ์ ์šฉ๋œ๋‹ค.
    • static generation ๋™์•ˆ์—๋„ ์ ์šฉ๋œ๋‹ค.
  • ํด๋ผ์ด์–ธํŠธ์—์„œ๋Š” ์„ธ์…˜ ๋™์•ˆ ์บ์‹œ๊ฐ€ ์œ ์ง€๋œ๋‹ค.

๋งŒ์•ฝ fetch() ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋Š” ์ƒํ™ฉ์ด๋ผ๋ฉด cache function์„ ์‚ฌ์šฉํ•ด๋„ ๋œ๋‹ค.

static and dynamic data fetches

๋‘๊ฐ€์ง€ ํƒ€์ž…์˜ ๋ฐ์ดํ„ฐ๊ฐ€ ์กด์žฌํ•œ๋‹ค.

  • static data : ์ž์ฃผ ๋ณ€๊ฒฝ๋˜์ง€ ์•Š๋Š” ๋ฐ์ดํ„ฐ
  • dynamic data : ์ž์ฃผ ๋ณ€๊ฒฝ๋˜๊ฑฐ๋‚˜ ์œ ์ € ๋ณ„๋กœ ๋‹ค๋ฅธ ๋ฐ์ดํ„ฐ

๊ธฐ๋ณธ์ ์œผ๋กœ next.js์—์„œ๋Š” static fetch๋ฅผ ํ•œ๋‹ค. ์ด๋Š” ๋นŒ๋“œํƒ€์ž„์— fetch๋˜์–ด ์บ์‹œ๋˜๊ณ  ๊ฐ ์š”์ฒญ๋งˆ๋‹ค ์‚ฌ์šฉํ•œ๋‹ค๋Š” ๋ง์ด๋‹ค. ํ•˜์ง€๋งŒ dynamic fetch๋ฅผ ํ•ด์•ผํ•  ๋•Œ๋„ ์žˆ๋Š”๋ฐ, next.js๋Š” ์บ์‹œ๋ฅผ ๋ฌดํšจํ™”ํ•˜๊ฑฐ๋‚˜ revalidating ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์ œ๊ณตํ•œ๋‹ค.

  • ์บ์‹œ ๋ฌดํšจํ™”
fetch(URL, { cache: 'no-store' });
  • revalidating
    • background : time interval์„ ์ฃผ์–ด ์ฃผ๊ธฐ์ ์œผ๋กœ ๋‹ค์‹œ fetch
fetch(URL, { next: { revalidate: 10 } });
- on-demand : update๊ฐ€ ์žˆ์„ ๋•Œ๋งˆ๋‹ค refetch ([์˜ˆ์ œ](https://beta.nextjs.org/docs/data-fetching/revalidating#on-demand-revalidation))

next.js์—์„œ๋Š” Streaming๊ณผ Suspense์— ๋Œ€ํ•œ ์ง€์›๋„ ์ž˜ ๋˜์–ด์žˆ๋‹ค. Layout ์„น์…˜์—์„œ ๋ณด์•˜๋“ฏ์ด ํ™”๋ฉด์˜ ์ผ๋ถ€๋Š” ์ฆ‰์‹œ ๋‚ด๋ ค๋ณด๋‚ด๊ณ , ์ผ๋ถ€๋Š” ๋น„๋™๊ธฐ์ ์œผ๋กœ loading ํ™”๋ฉด์„ ๋ณด์—ฌ์ฃผ์—ˆ๋‹ค๊ฐ€ data fetching์ด ์™„๋ฃŒ๋˜๋ฉด ๋‚ด๋ ค๋ณด๋‚ธ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ์œ ์ €๋Š” ํŽ˜์ด์ง€์˜ ๋ชจ๋“  ๋ถ€๋ถ„์„ ๋กœ๋“œํ•  ํ•„์š”๊ฐ€ ์—†๋‹ค.

caching data

The Next.js Cache is a persistent HTTP cache that can be globally distributed. This means the cache can scale automatically and be shared across multiple regions depending on your platform (e.g. Vercel).

next.js๋Š” fetch()์˜ options ๊ฐ์ฒด๋ฅผ ํ™•์žฅํ•˜์—ฌ ์„œ๋ฒ„์—์„œ ์ด๋ฃจ์–ด์ง€๋Š” ๊ฐ ์š”์ฒญ์ด persistent caching ๋™์ž‘์ด ์ด๋ฃจ์–ด์ง€๋„๋ก ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ๋ฐ์ดํ„ฐ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ์—์„œ ์บ์‹ฑ ๋™์ž‘์„ ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.

์ถœ์ฒ˜

https://beta.nextjs.org/docs/routing/fundamentals

review