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

Что делает компонент Link

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

Link из next/link создает HTML-ссылку и добавляет клиентскую навигацию и предзагрузку маршрутов Next.js.

Вопрос

Как переходить между страницами приложения и зачем использовать Link вместо обычной ссылки?

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

Обычная внутренняя ссылка <a href="/catalog"> обычно запрашивает новый HTML-документ. Link позволяет Next.js обработать переход внутри приложения: получить нужную часть интерфейса и обновить экран без полной перезагрузки документа.

При этом сохраняются общие layout и их состояние. Изменяемая страница может размонтироваться, поэтому обещать сохранение состояния всех компонентов нельзя.

Link остается настоящей ссылкой. Браузер поддерживает открытие в новой вкладке, копирование адреса и переход с клавиатуры.

<a href><Link href>router.push()
Новый HTML-документДаНет — клиентский переходНет
Сохранение общих layout и их состоянияНетДаДа
PrefetchНетДа (во вьюпорте, в production)Нет (только router.prefetch)
Открыть в новой вкладке, копировать адресДаДа (это настоящий <a>)Нет
Видна поисковикамДаДаНет
КогдаВнешние ссылки, переход между разными приложениямиОбычная навигация внутри приложенияПереход после действия (сохранили форму)
<Link href="/catalog">Каталог</Link>                                  // обычная ссылка
<Link href={{ pathname: "/search", query: { q: "react" } }}>Поиск</Link> // объект с query
<Link href="/catalog" replace>Каталог</Link>                          // без новой записи в истории
<Link href="/catalog#filters" scroll={false}>К фильтрам</Link>        // без прокрутки наверх
<Link href="/admin" prefetch={false}>Админка</Link>                   // без предзагрузки

Активный пункт меню определяют через usePathname() в клиентском компоненте и помечают aria-current="page".

Пример: меню и динамический адрес

Предполагается, что страницы /, /catalog и /products/[id] существуют:

// app/page.tsx
import Link from "next/link";
 
export default function HomePage() {
  const product = { id: "1", name: "Учебник React" };
 
  return (
    <main>
      <nav>
        <Link href="/">Главная</Link>{" "}
        <Link href="/catalog">Каталог</Link>
      </nav>
      <p>
        <Link href={`/products/${product.id}`}>{product.name}</Link>
      </p>
      <a href="https://nextjs.org/docs">Документация Next.js</a>
    </main>
  );
}

Нажатие «Каталог» откроет /catalog, а ссылка товара — /products/1. Для внешнего ресурса в примере использован обычный <a>.

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

Современный Link рендерит <a> сам. Не вкладывай в него еще один <a>: получится некорректная вложенность ссылок. className, target и другие атрибуты ссылки передают прямо в Link.

replace заменяет текущую запись истории вместо добавления новой. scroll={false} отключает стандартное управление прокруткой при переходе. prefetch={false} позволяет отказаться от автоматической предзагрузки.

Для обычного перехода используй ссылку. useRouter нужен, когда навигация является частью действия в коде, например после успешного сохранения формы.

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

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

  • Импорт: import Link from "next/link".
  • href содержит адрес назначения.
  • Link уже является HTML-ссылкой.
  • Обычно он переиспользует общие части интерфейса при навигации.

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

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

Поиск

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