Компоненты и макет в Next.js

Компоненты и возможности макета Next.js предоставляют разработчикам мощные инструменты, помогающие создавать модульные, поддерживаемые веб-приложения.

ХарактеристикаОписание
КомпонентыКомпоненты страниц, UI-компоненты и компоненты функций, используемые для создания различных частей приложения.
LayoutГлобальный макет, вложенный макет, динамический макет, используемые для определения структуры страницы и общих элементов.
Специальные файлы (устаревшая версия)_app.js、_document.js、_error.jsИспользуется для определения глобального макета и структуры документа.

В Next.js 13 каталог app заменяет традиционный каталог pages для управления маршрутами и структурой страниц. Каталог app вводит более гибкие механизмы макета, маршрутизации, получения данных и улучшенные возможности параллельного рендеринга.

Пример структуры каталога app:

├── app/
│   ├── page.js           # 默认首页
│   ├── about/
│   │   ├── page.js       # About 页
│   └── layout.js         # 根布局
└── public/                # 静态文件目录

Компоненты

Компоненты — это базовые строительные блоки приложений Next.js. Они могут быть компонентами страниц, UI-компонентами или компонентами функций.

В Next.js все страницы и макеты по сути являются компонентами React. Вы можете создавать и использовать компоненты так же, как в любом приложении React.

Компоненты страниц

Компоненты страниц — это основа маршрутизации в Next.js; каждый компонент страницы соответствует маршруту.

Компоненты страниц обычно хранятся в каталоге app или pages.

Пример

// pages/about.js или app/about/page.js
export default function About() {
  return <div>Страница о нас</div>;
}

UI-компоненты

UI-компоненты — это переиспользуемые элементы интерфейса, такие как кнопки, карточки, панели навигации и т.д.

UI-компоненты обычно хранятся в каталоге components.

Пример

// components/Button.js
export default function Button({ children }) {
  return <button>{children}</button>;
}

Компоненты функций

Компоненты функций — это компоненты, которые реализуют определённые функции, такие как получение данных, управление состоянием и т.д.

Функциональные компоненты обычно хранятся в каталоге hooks или utils.

Пример

// hooks/useData.js
import { useEffect, useState } from 'react';

export default function useData(url) {
  const [data, setData] = useState(null);

  useEffect(() => {
    fetch(url)
      .then((res) => res.json())
      .then((data) => setData(data));
  }, [url]);

  return data;
}

Пример

Создание компонента:Создайте Hello.js в каталоге app/components/ со следующим кодом:

Пример

// app/components/Hello.js
const Hello = () => {
  return <h1>Hello, Next.js 13!</h1>;
};

export default Hello;

Использование компонента:В каталоге app компоненты страниц экспортируются из page.js, и вы можете использовать компоненты внутри них:

Пример

// app/page.js
import Hello from './components/Hello';

export default function Home() {
  return (
    <div>
      <Привет />
    </div>
  );
}

Layout

Макеты — это компоненты, используемые для определения структуры страницы, обычно содержащие такие общие элементы, как шапки, подвалы, панели навигации и т. д.

Глобальный макет

Глобальные макеты применяются ко всему приложению и обычно определяются в app/layout.js или _app.js.

Пример

// pages/_app.js или app/layout.js
import Header from '../components/Header';
import Footer from '../components/Footer';

export default function Layout({ children }) {
  return (
    <div>
      <Заголовок />
      <main>{children}</main>
      <Нижний колонтитул />
    </div>
  );
}

Вложенный макет

Вложенные макеты позволяют определять разные макеты для разных сегментов маршрута.

В каталоге app каждый сегмент маршрута может содержать файл layout.js.

app/
├── layout.js        // 根布局
├── about/
│   ├── layout.js    // /about 的布局
│   └── page.js      // /about 页面
└── dashboard/
    ├── layout.js    // /dashboard 的布局
    └── page.js      // /dashboard 页面

Пример

// app/dashboard/layout.js
export default function DashboardLayout({ children }) {
  return (
    <div>
      <h1>Макет панели управления</h1>
      {children}
    </div>
  );
}

Динамический макет

Динамические макеты позволяют динамически выбирать макет в зависимости от условий.

Пример

// app/layout.js
export default function Layout({ children, isDashboard }) {
  return (
    <div>
      {isDashboard ? <DashboardLayout>{children}</DashboardLayout> : <MainLayout>{children}</MainLayout>}
    </div>
  );
}

Специальные файлы (устаревшая версия)

Next.js предоставляет некоторые специальные файлы для определения глобальных макетов, структуры документа и страниц ошибок.

_app.js

_app.js — это глобальный компонент в Next.js, используемый для обёртывания всех компонентов страниц.

Пример

// pages/_app.js
import Layout from '../components/Layout';

export default function MyApp({ Component, pageProps }) {
  return (
    <Layout>
      <Component {...pageProps} />
    </Layout>
  );
}

_document.js

_document.js используется для настройки структуры HTML-документа.

Пример

// pages/_document.js
import { Html, Head, Main, NextScript } from 'next/document';

export default function Document() {
  return (
    <Html lang="en">
      <Head />
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  );
}

_error.js

_error.js используется для настройки страниц ошибок.

Пример

// pages/_error.js
export default function Error({ statusCode }) {
  return (
    <div>
      <h1>{statusCode} Error</h1>
      <p>Извините, что-то пошло не так.</p>
    </div>
  );
}
Другие расширения