re:re:actable
Урок 062 минуты чтения

Что такое гибридный рендеринг в Next.js

На этой странице
Кратко

Гибридный рендеринг - сочетание серверной подготовки содержимого и клиентской интерактивности, а также разных стратегий подготовки маршрутов внутри приложения.

Вопрос

Как соединить готовое описание товара и интерактивную кнопку, не превращая всю страницу в клиентскую?

Основная идея

У страницы товара есть разные задачи. Описание нужно показать сразу, цену получить из источника данных, а выбранное количество менять по клику. Эти задачи не обязаны выполняться в одной среде.

App Router позволяет серверному компоненту подготовить содержимое и встроить клиентские компоненты для поведения. При первой загрузке браузер получает HTML, а затем подключает JavaScript интерактивных частей.

На уровне приложения справочная страница может быть статической, публичный каталог - обновляться через ISR, а кабинет - рендериться по запросу. Это еще один смысл сочетания стратегий.

Пример: товар и выбранное количество

// app/quantity.tsx
"use client";
 
import { useState } from "react";
 
export default function Quantity({ productName }: { productName: string }) {
  const [count, setCount] = useState(1);
 
  return (
    <button onClick={() => setCount(value => value + 1)}>
      {productName}: выбрано {count}
    </button>
  );
}
// app/book/page.tsx
import Quantity from "../quantity";
 
export default function Page() {
  const book = { name: "Введение в Next.js", description: "Учимся строить страницы." };
 
  return (
    <article>
      <h1>{book.name}</h1>
      <p>{book.description}</p>
      <Quantity productName={book.name} />
    </article>
  );
}

В примере используется локальный объект книги вместо настоящего API. Заголовок и описание подготавливает серверная страница. Кнопка сначала показывает количество 1, а после гидратации увеличивает его по нажатию. Покупка не отправляется на сервер: это демонстрация локального состояния.

Что важно помнить

Тип компонента и время рендеринга - разные понятия. Клиентский компонент может войти в заранее подготовленный HTML. Серверный компонент может выполняться при сборке или по запросу.

В обычном режиме без cacheComponents нельзя автоматически приписать каждому блоку независимый режим HTML-кэширования «этот SSG, этот SSR». Динамическая зависимость может сделать весь маршрут динамическим, даже если отдельные данные кэшируются. Частичный пререндеринг с Cache Components рассматривается отдельно.

Сочетание компонентов полезно оценивать по конкретному результату: объему JavaScript, времени показа содержимого и необходимой свежести данных.

Мини-шпаргалка

  • Сервер готовит данные и содержимое.
  • Клиент поддерживает интерактивность.
  • Граница компонентов не равна границе кэша HTML.
  • Разные маршруты могут иметь разные стратегии.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам