Перейти до основного вмісту

Основи Next.js

Що таке Next.js?

Next.js — це прогресивний фреймворк для розробки веб-застосунків на основі React. Він розширює можливості React, додаючи готову інфраструктуру для Server-Side Rendering (SSR), генерації статичних сторінок, маршрутизації через файлову систему, а також можливість створювати backend-ендпоінти прямо в проєкті.

Чому він став популярним?

Next.js швидко здобув популярність завдяки тому, що пропонує:

  • SEO-дружні сторінки завдяки SSR / SSG;
  • швидкий перший рендер (First Page Load);
  • просту маршрутизацію без налаштування;
  • розгортання в один клік через Vercel;
  • вбудовану оптимізацію зображень та продуктивності.

Чим відрізняється від класичного React

У класичному React ми отримуємо лише клієнтську бібліотеку для побудови UI-компонентів. Усе інше (SSR, маршрути, API) треба налаштовувати вручну або через сторонні бібліотеки (наприклад, React Router, Redux, Express, etc.).

Next.js — це уже повноцінний фреймворк. Він одразу має:

  • серверний рендеринг (SSR);
  • static generation (SSG);
  • маршрутизацію через папку pages або app;
  • можливість створювати backend-функції в папці pages/api.

Наприклад, класичний React без SSR:


// App.jsx
function App() {
  return (
    <div>
      <h1>Hello React</h1>
    </div>
  );
}
export default App;

А в Next.js досить створити файл pages/index.js:


// pages/index.js
export default function Home() {
  return (
    <div>
      <h1>Hello Next.js</h1>
    </div>
  );
}

Головні можливості Next.js

Next.js пропонує набір функцій «з коробки», які значно спрощують розробку сучасних веб-застосунків:

  • Server-Side Rendering (SSR) — рендеринг сторінок на сервері перед відправкою користувачу.
  • Static Site Generation (SSG) — попередня генерація HTML під час зборки (build).
  • File-based Routing — автоматична маршрутизація на основі структури папки pages/ або app/.
  • API Routes — можливість створювати backend endpoint-и прямо всередині Next.js-проєкту.
  • Підтримка TypeScript — повна інтеграція без додаткових налаштувань.
  • Оптимізація зображень — компонент <Image /> забезпечує lazy-loading і responsive images.

Наприклад: створимо сторінку з SSR за допомогою getServerSideProps:


// pages/ssr-example.js
export async function getServerSideProps() {
  return {
    props: {
      time: new Date().toLocaleTimeString()
    }
  };
}

export default function SSRExample({ time }) {
  return (
    <div>
      <h2>Server-side rendered page</h2>
      <p>Time: {time}</p>
    </div>
  );
}

Для SSG (Static Generation) використовується getStaticProps():


// pages/static-example.js
export async function getStaticProps() {
  return {
    props: {
      message: "Це сторінка, згенерована на етапі build"
    }
  };
}

export default function StaticExample({ message }) {
  return (
    <div>
      <h2>Static Page</h2>
      <p>{message}</p>
    </div>
  );
}

Встановлення та перший проєкт

Для старту з Next.js потрібно мати встановлений Node.js (рекомендується версія 16+). Створити новий проєкт можна за допомогою інструменту Create Next App.

Команда для створення нового Next-проєкту:

npx create-next-app@latest my-next-app

Після створення проєкту структура папок виглядає приблизно так:


my-next-app/
├─ pages/
│   ├─ index.js
│   ├─ _app.js
│   └─ api/
│       └─ hello.js
├─ public/
│   └─ favicon.ico
├─ styles/
│   └─ globals.css
├─ package.json

Щоб запустити проєкт у режимі розробки:

cd my-next-app
npm run dev

Після запуску, застосунок буде доступний за адресою http://localhost:3000

Маршрути та сторінки

У Next.js маршрутизація побудована за принципом «файл = сторінка». Усе, що розміщується в папці pages, автоматично стає маршрутом.

Наприклад, файл pages/about.js автоматично стане сторінкою за адресою /about:


// pages/about.js
export default function About() {
  return (
    <div>
      <h1>Про нас</h1>
      <p>Це сторінка "About".</p>
    </div>
  );
}

Динамічні маршрути

Для динамічних сторінок використовуються квадратні дужки у назві файлу, наприклад [id].js.


// pages/products/[id].js
import { useRouter } from 'next/router';

export default function ProductPage() {
  const router = useRouter();
  const { id } = router.query;

  return (
    <div>
      <h2>Product ID: {id}</h2>
    </div>
  );
}

Вкладені маршрути

Створюються через вкладені папки:


pages/
├─ blog/
│   └─ first-post.js

Ця сторінка буде за шляхом /blog/first-post.

Головна сторінка

Файл pages/index.js — це корінь сайту (/):


// pages/index.js
export default function Home() {
  return (
    <div>
      <h1>Головна сторінка</h1>
    </div>
  );
}

Рендеринг: SSR vs SSG vs CSR

У Next.js можна використовувати різні стратегії рендерингу сторінок залежно від потреб.

  • CSR (Client-Side Rendering) — класичний React, коли все відбувається на стороні клієнта.
  • SSR (Server-Side Rendering) — сторінка генерується на сервері при кожному запиті за допомогою getServerSideProps().
  • SSG (Static Site Generation) — сторінка генерується під час збірки (build), використовуючи getStaticProps() і, при потребі, getStaticPaths().

SSR (Server-Side Rendering)


// pages/ssr-example.js
export async function getServerSideProps() {
  const data = { time: new Date().toISOString() };
  return { props: { data } };
}

export default function SSRExample({ data }) {
  return (
    <div>
      <h2>SSR Example</h2>
      <p>Time: {data.time}</p>
    </div>
  );
}

SSG (Static Generation)


// pages/ssg-example.js
export async function getStaticProps() {
  return {
    props: {
      message: "Ця сторінка створена під час build"
    }
  };
}

export default function SSGExample({ message }) {
  return (
    <div>
      <h2>SSG Example</h2>
      <p>{message}</p>
    </div>
  );
}

CSR (Client-Side Rendering)


// pages/csr-example.js
import { useEffect, useState } from "react";

export default function CSRExample() {
  const [time, setTime] = useState("");

  useEffect(() => {
    setTime(new Date().toISOString());
  }, []);

  return (
    <div>
      <h2>CSR Example</h2>
      <p>Time: {time}</p>
    </div>
  );
}

Використовуй SSR, якщо дані змінюються на кожному запиті (наприклад, профіль користувача або статистика в реальному часі). Використовуй SSG для статичних сторінок, наприклад, блог, маркетинг, документація. А CSR — якщо все може відрендеритися з API прямо в браузері.

Робота з API Routes

Next.js дозволяє створювати серверні функції (API endpoints) без потреби у зовнішньому сервері типу Express. Це зручно для обробки форм, авторизації, обміну даними з базою тощо.

Усі API-роути створюються в папці pages/api. Кожен файл у цій папці автоматично стає HTTP endpoint’ом.

Приклад простого API-роута:


// pages/api/hello.js
export default function handler(req, res) {
  res.status(200).json({ message: "Привіт з API!" });
}

Після запуску проєкту цей endpoint буде доступний за адресою: http://localhost:3000/api/hello

Обробка методів POST, GET, тощо


// pages/api/echo.js
export default function handler(req, res) {
  if (req.method === 'POST') {
    const { name } = req.body;
    res.status(200).json({ received: name });
  } else {
    res.status(405).json({ error: 'Метод не дозволено' });
  }
}

Як викликати API на клієнті:


// Виклик з React-компонента (CSR)
const response = await fetch('/api/hello');
const data = await response.json();
console.log(data.message);

API Routes зручно використовувати для невеликих проєктів або коли немає окремого бекенду. У складніших випадках зазвичай використовують зовнішній сервер (наприклад, NestJS) або хмарні функції.

Коментарі

Популярні публікації

Angular CLI

CLI (command-line interface) – інтерфейс командного рядка. Перед початком роботи має бути встановлений Node.js Встановлення: npm install -g @angular/cli Отримання допомоги: ng help Буде приблизно такий результат: add Adds support for an external library to your project. analytics Configures the gathering of Angular CLI usage metrics. See https://angular.io/cli/usage-analytics-gathering. build (b) Compiles an Angular app into an output directory named dist/ at the given output path. Must be executed from within a workspace directory. deploy Invokes the deploy builder for a specified project or for the default project in the workspace. config Retrieves or sets Angular configuration values in the angular.json file for the workspace. doc (d) Opens the official Angular documentation (angular.io) in a browser, and searches for a given keyword. e2e (e) Builds and serves an Angular app, then runs end-to-end tests. extract-i18n (i18n-extract, xi18n) Extracts i18n mes...

Створення нового Elixir-проєкту

Для створення новго Elixir-проєкту можна використати команду mix new first_project --sup Зрозуміло, що Elixir має бути встановлений раніше. Пояснення команди: mix — це вбудований інструмент для управління проєктами в Elixir (аналог maven у Java чи npm у JavaScript ). new — підкоманда mix, яка створює новий проєкт. first_project — назва твого нового проєкту. Папка з цією назвою буде створена у поточному каталозі. --sup — опціональний прапорець, який додає шаблон структури з Supervision Tree. Це означає, що створений проєкт одразу буде мати структуру, яка підтримує супервізор (супервізор керує життєвим циклом процесів у системі, перезапускаючи їх при падінні). Щоб створити файл з тестом, можна запустити команду із директорії проєкту mix test Приблизний вигляд структури проєкту:

Агрегати в DDD

Domain-Driven Design (DDD, предметно-орієнтоване проєктування) — це підхід до розробки програмного забезпечення, який зосереджується на моделюванні бізнес-логіки на основі реального домену (предметної області). Його запропонував Ерік Еванс у своїй книзі "Domain-Driven Design: Tackling Complexity in the Heart of Software". Основні принципи DDD Фокус на домені – головна увага приділяється предметній області, а не технічним деталям. Єдина мова (Ubiquitous Language) – розробники, бізнес-аналітики та інші учасники проєкту використовують спільну термінологію, щоб уникнути непорозумінь. Бізнес-логіка відокремлена від технічної реалізації – код моделюється так, щоб він чітко відображав реальний бізнес-процес. Основні концепції DDD Entity (Сутність) – об’єкт з унікальним ідентифікатором, що зберігається в системі (наприклад, Користувач, Замовлення). Value Object (Об’єкт-значення) – об’єкт, який не має унікального ідентифікатора та є незмінним (наприклад, Адреса або Гроші)...

Основи Elixir

Elixir — це функційна мова програмування, яка працює на віртуальній машині Erlang (BEAM). Вона призначена для створення масштабованих і відмовостійких систем. Elixir успадкував багато переваг Erlang, таких як легкість паралельного програмування та висока доступність, але також додав сучасний синтаксис та інструменти для розробки. Основні концепції Elixir Elixir є функційною мовою, тому вона орієнтована на використання функцій та незмінних даних. Ось декілька ключових концепцій: Незмінність даних. Усі дані в Elixir є незмінними, що спрощує роботу з паралельними процесами. Функції. Функції є основним будівельним блоком програми. Вони можуть бути анонімними або іменованими. Паттерн-матчинг. Elixir використовує паттерн-матчинг для роботи з даними, що дозволяє легко розбирати структури даних. Процеси. Elixir використовує легкі процеси для паралельного виконання завдань. Ці процеси ізольовані та спілкуються через передачу повідомлень. Синтаксис Elixir Синтаксис Elixir є прос...

Стратегії ребалансування в Kafka

Стратегії ребалансування в Kafka Ребалансування (Rebalancing) — це процес перерозподілу партицій між споживачами (сonsumer) у групі (Consumer Group). Kafka має кілька стратегій ребалансування: RangeAssignor. Ця стратегія розподіляє партиції на основі діапазонів, які створюються відповідно до сортування топіків і партицій. Наприклад, якщо є два консюмери і 6 партицій (P0–P5), перший консюмер отримає P0–P2, а другий — P3–P5. Особливості: Простий алгоритм. Може призводити до нерівномірного розподілу, якщо кількість партицій не ділиться порівну між консюмерами. RoundRobinAssignor. Ця стратегія рівномірно розподіляє партиції між консюмерами за круговим принципом. Наприклад, якщо є два консюмери і 6 партицій, перший отримає P0, P2, P4, а другий — P1, P3, P5. Особливості: Гарантує більш рівномірний розподіл партицій. Використовується в багатотопікових сценаріях. StickyAssignor. Ця стратегія намагається мінімізувати кількість змін у розподілі партицій між консюмерами при ре...