Начать новый React-проект

Если вы хотите создать новое приложение или веб-сайт с помощью React, мы рекомендуем выбрать один из популярных в сообществе фреймворков на базе React.

Вы можете использовать React без фреймворка, но известно, что большинство приложений и веб-сайтов всё равно решают одни и те же проблемы разделения кода, загрузки данных и генерации HTML. Эти проблемы актуальны для всех UI-библиотек, не только для React.

Взяв готовое решение, вы можете быстро начать решать свои задачи с React и избежать необходимости писать собственный фреймворк в будущем.

Deep Dive

Можно ли использовать React без фреймворка?

Конечно! Так, например, вы можете использовать React только для определённой части страницы. Однако, если вы создаёте приложение или веб-сайт с нуля, мы рекомендуем взять один из фреймворков.

И вот почему.

Даже если поначалу вам не понадобились маршрутизация или загрузка данных, скорее всего, вы захотите добавить библиотеки для их поддержки позже. Ваш JavaScript-бандл будет расти вместе с вашим приложением, и вам придётся задуматься как разделять код для разных маршрутов. Ваше приложение будет загружать всё больше данных, и в итоге вы можете столкнуться с каскадными запросами, которые замедлят ваше приложение. Среди ваших пользователей появятся те, кто пользуется низкоскоростным интернетом или старыми устройствами, и вы захотите генерировать HTML на сервере или во время сборки. Поменять настройки большого проекта так, чтобы запускать код на сервере, может оказаться затруднительным.

Эти проблемы не являются специфичными для React. У Svelte есть SvelteKit, у Vue — Nuxt, и т.д. Чтобы решить эти проблемы, вам придётся интегрировать ваш бандлер с выбранными библиотеками для маршрутизации и загрузки данных. Сделать первичную настройку и заставить всё это работать вместе может оказаться не так сложно, но вам придётся поддерживать производительность приложения по мере его роста и узнать о множестве подводных камней. Вы захотите отправлять как можно меньше кода, и в то же время уменьшить количество взаимодействий между клиентом и сервером, а ещё параллельно загружать необходимые для страницы данные. Вы можете захотеть, чтобы страница была интерактивной ещё до запуска Javascript-кода, и пользователи любых браузеров могли работать с ней одинаково. Или вам потребуется добавить папку статических HTML-файлов для маркетинговых страниц, которые могут работать с отключённым на странице Javascript. Поддержка этих возможностей требует большого труда.

Рекомендованные React-фреймворки помогают решить эти проблемы из коробки и не требуют от вас дополнительных усилий. Вы можете начать с малого и добавлять необходимую функциональность по мере необходимости. У каждого фреймворка есть сообщество, которое поможет найти ответы на ваши вопросы и без труда обновляться до новых версий. Кроме того, фреймворки помогают структурировать ваш код и делают его понятным для других разработчиков. Верно и обратное, сделав собственное решение, есть риск застрять на поддержке зависимостей и в результате создать свой собственный фреймворк без сообщества и пути развития (и, скорее всего, он окажется спроектирован хуже чем уже существующие решения от команд, которые посвятили этим проблемам большое количество времени).

Если мы не смогли вас убедить, или при разработке вы столкнулись с необычными ситуациями, для которых эти фреймворки не предлагают решений, мы не вправе вас останавливать - создайте свою конфигурацию! Установите react и react-dom из npm, настройте свою собственную сборку с бандлерами, такими как Vite или Parcel, и добавьте все необходимые инструменты для маршрутизации, статической генерации кода, серверного рендеринга или любые другие.

Новейшие React-фреймворки

По мере того как мы развивали React, мы поняли, что лучшая интеграция с фреймворками (особенно в вопросах маршрутизации, сборки и серверных технологий) принесёт наибольшую пользу нашим пользователям. Команда Next.js согласилась взаимодействовать с нами в поиске, разработке, внедрении и тестировании новейших подходов, которые не зависят от конкретного фреймворка, например серверные React-компоненты.

Мы работаем над тем, чтобы новые возможности стали доступны в продакшене как можно скорее, и договариваемся с разработчиками бандлеров и фреймворков об их интеграции. Мы рассчитываем, что через год-два все перечисленные фреймворки будут полностью поддерживать эти возможности. (Если вы разработчик фреймворка и хотите помочь нам в экспериментах, пожалуйста, дайте нам знать!)

Next.js (Маршрутизатор приложения)

Маршрутизатор приложения Next.js (Next.js App Router) — обновлённый API Next.js, отвечающий тому, как команда React видит архитектуру фулстек-приложений сегодня. Маршрутизатор позволяет загружать данные в асинхронных компонентах на сервере или во время сборки.

Deep Dive

Что включает архитектурное видение фулстек-приложений командой React?

Бандлер маршрутизатора приложения Next.js полностью реализует официальную спецификацию серверных React-компонентов. Это даёт возможность сочетать компоненты, сгенерированные во время сборки, на сервере и на клиенте в одном React-дереве.

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

// Этот компонент запускается *только* на сервере (или во время сборки).
async function Talks({ confId }) {
  // 1. Это серверный код, вы можете напрямую обратиться к вашей базе данных без запросов к API.
  const talks = await db.Talks.findAll({ confId });

  // 2. Добавьте любую логику рендеринга. Это не увеличит ваш JavaScript-бандл.
  const videos = talks.map(talk => talk.video);

  // 3. Передайте данные ниже по дереву в компонент, который будет запускаться в браузере.
  return <SearchableVideoList videos={videos} />;
}

Маршрутизатор приложения Next.js также поддерживает загрузку данных с задержкой (Suspense). Так вы можете задать вид различных частей вашего приложения при загрузке (например, показать заглушки) прямо в React-дереве:

<Suspense fallback={<TalksLoading />}>
  <Talks confId={conf.id} />
</Suspense>

Серверные компоненты и задержка — скорее возможности React, чем Next.js. Однако, команда фреймворка должна подписаться на их внедрение и провести нетривиальную работу. В данный момент маршрутизатор приложения Next.js является наиболее полной реализацией этих возможностей. Команда React продолжает совместную работу с разработчиками бандлеров над предоставлением новых возможностей в следующем поколении фреймворков.

PreviousInstallation

NextAdd React to an Existing Project

Начать новый React-проект

Deep Dive

Можно ли использовать React без фреймворка?

Рекомендуемые React-фреймворки

Next.js

Remix

Gatsby

Expo (для нативных приложений)

Новейшие React-фреймворки

Next.js (Маршрутизатор приложения)

Deep Dive

Что включает архитектурное видение фулстек-приложений командой React?