Əsas məzmuna keç
FrontDepth, Ana səhifə

SSR, SSG və meta-framework-lər → Server komponentləri və island-lar

2016 – bu gün · 2020 – bu gün

Köhnə dövr
Yeni dövr
Müqayisə et

Nə dəyişdi

State harada yaşayır

SSR, SSG və meta-framework-lər

Səhifə komponentinin this.state-ində; ilk dəyəri serverin getInitialProps() ilə yüklədiyi props-dan gəlir, bu props-un bir nüsxəsi isə HTML-lə birlikdə JSON kimi gəlir.

Server komponentləri və island-lar

Island-ın useState-ində; ilk dəyəri serverin yanına serialize etdiyi props-dan gəlir. Statik hissələrin heç bir state-i yoxdur.

Səhifə necə render olunur

SSR, SSG və meta-framework-lər

Server bütün səhifəni renderToString() ilə HTML-ə render edir; brauzer onu hydrateRoot() ilə hydrate edir və sonrakı hər dəyişikliyi özü render edir.

Server komponentləri və island-lar

Server bütün səhifəni HTML-ə render edir; hydrateRoot() ilə yalnız island-ın elementi hydrate olunur. React statik HTML-ə heç vaxt toxunmur.

Dəyişiklikdə nə baş verir

SSR, SSG və meta-framework-lər

Hydration-dan sonra hər şey brauzerdə baş verir: handler this.setState()-i çağırır, React səhifə komponentini yenidən render edir. Serverə heç nə getmir.

Server komponentləri və island-lar

Island-ın içində setter TodoApp-i yenidən render edir, React DOM-da yalnız fərqli olanı yeniləyir; səhifənin qalanı heç vaxt dəyişmir.

Kod necə qurulub

SSR, SSG və meta-framework-lər

pages/-də hər iki tərəf üçün bir dəfə yazılan səhifə və framework kodu: render edib datanı serialize edən server və hydrate edən client girişi.

Server komponentləri və island-lar

Brauzerə heç vaxt getməyən, yalnız serverdə işləyən komponentlər və onların arasında client island-ları: hər birinin öz root-u, script-i və props-u var.

Niyə dəyişdi

Yol boyu hər dövrdə nə ağrıtdı və ondan sonra hansı dövr gəldi.

  1. SSR, SSG və meta-framework-lər→Hooks

    Səhifələr artıq render olunmuş gəlirdi, amma komponentlər hələ də class idi: bir funksiyanın məntiqi componentDidMount, componentDidUpdate və componentWillUnmount arasında paylanırdı, state-li məntiqi paylaşmaq üçün higher-order komponentlər və ya render props lazım idi, hər handler isə this-ə bind olunmalı idi (constructor-a bax). Hooks (React 16.8, 2019) funksiya komponentlərinə state və effect verdi, onları custom hook kimi paylaşmaq mümkün oldu.

    Hydration-un da öz qiyməti vardı: brauzer bütün səhifənin, hətta heç vaxt dəyişməyən hissələrin də kodunu yükləyib işlədir, data isə iki dəfə gəlir: HTML kimi və JSON kimi. Sonralar islands və server komponentləri məhz bu problemin üzərinə getdi.

  2. Hooks→Server komponentləri və island-lar

    Hər şey yenə brauzerdə işləyirdi: səhifə boş gəlirdi, faydalı nəsə görünməzdən əvvəl hər komponentin JavaScript-i yüklənməli, işləməli və render olunmalı idi, server rendering isə heç nəyin interaktiv olmadığı yerlərdə də bütün səhifəni hydrate edirdi. Dependency massivli effect-lər və köhnəlmiş closure-lar tez-tez bug mənbəyinə çevrildi. Islands və React Server Components interaktiv olmayan hissələri yenidən serverə qaytardı.

Eyni tətbiq yan-yana

Hər versiyanın əsas faylı. Hər iki tətbiq eyni testdən keçir: eyni markup, eyni davranış, fərqli ideyalar.

Tətbiqlər brauzerində sandbox-larda işləyir.

SSR, SSG və meta-framework-lər
Server komponentləri və island-lar

SSR, SSG və meta-framework-lər

React 19.3.0, React DOM 19.3.0

/pages/index.jsx · 101 sətir

JSX
// 2016–2018-ci illərin Next.js tətbiqlərindəki kimi səhifə: statik data metodu olan class komponent.
// Eyni fayl iki dəfə işləyir: serverdə (HTML-ə) və brauzerdə (hydration).
import { Component } from "react";

const FILTERS = { all: "All", active: "Active", done: "Done" };

export default class TodoPage extends Component {
  // İlk render-dən əvvəl serverdə çağırılır; qaytardığı dəyər səhifənin props-u olur.
  // Real səhifə burada verilənlər bazasını və ya API-ni oxuyardı.
  static async getInitialProps() {
    return {
      todos: [
        { id: 1, title: "Read the docs", done: true },
        { id: 2, title: "Write the app", done: false },
      ],
    };
  }

  constructor(props) {
    super(props);
    // İlk state yalnız props-dan gəlir, ona görə server və brauzer eyni HTML-i render edir.
    this.state = { todos: props.todos, filter: "all", title: "" };
    this.nextId = Math.max(0, ...props.todos.map((t) => t.id)) + 1;
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event) {
    this.setState({ title: event.target.value });
  }

  handleSubmit(event) {
    event.preventDefault();
    const title = this.state.title.trim();
    if (!title) return;
    const todo = { id: this.nextId++, title, done: false };
    this.setState((state) => ({ todos: [...state.todos, todo], title: "" }));
  }

  toggle(id) {
    this.setState((state) => ({
      todos: state.todos.map((t) => (t.id === id ? { ...t, done: !t.done } : t)),
    }));
  }

  render() {
    const { todos, filter, title } = this.state;
    const shown = todos.filter((t) => filter === "all" || (filter === "done") === t.done);
    const left = todos.filter((t) => !t.done).length;

    return (
      <main className="todo-app">
        <h1>Todos</h1>
        <form id="todo-form" onSubmit={this.handleSubmit}>
          <input
            id="new-todo"
            value={title}
            onChange={this.handleChange}
            placeholder="What needs doing?"
            autoComplete="off"
            aria-label="New todo"
          />
          <button id="add" type="submit">
            Add
          </button>
        </form>
        <ul id="todo-list">
          {shown.map((todo) => (
            <li key={todo.id} className={todo.done ? "done" : undefined}>
              <label>
                <input
                  type="checkbox"
                  data-toggle
                  checked={todo.done}
                  onChange={() => this.toggle(todo.id)}
                />{" "}
                <span className="title">{todo.title}</span>
              </label>
            </li>
          ))}
        </ul>
        <div className="footer">
          <span id="todo-count">{left} left</span>
          <div className="filters">
            {Object.entries(FILTERS).map(([name, label]) => (
              <button
                key={name}
                type="button"
                data-filter={name}
                className={filter === name ? "selected" : undefined}
                onClick={() => this.setState({ filter: name })}
              >
                {label}
              </button>
            ))}
          </div>
        </div>
      </main>
    );
  }
}

Server komponentləri və island-lar

React 19.3.0, React DOM 19.3.0

/server.jsx · 48 sətir

JSX
// Islands dövrü: server bütün səhifəni HTML-ə render edir, JavaScript isə yalnız island-lara gedir.
// Astro kimi islands framework-ü bunu sənin üçün edir: sən yalnız interaktiv olanı işarələyirsən.
import { renderToStaticMarkup, renderToString } from "react-dom/server";
import TodoApp from "./islands/TodoApp.jsx";

// "Verilənlər bazası" serverdə yaşayır.
const todos = [
  { id: 1, title: "Read the docs", done: true },
  { id: 2, title: "Write the app", done: false },
];

// Yalnız server komponenti: burada işləyir, ondan geriyə adi HTML qalır. JavaScript GÖNDƏRMİR:
// bu fayl brauzerə heç vaxt getmir, onun HTML-ini heç nə hydrate etmir.
function Intro() {
  return (
    <>
      <h1>Todos</h1>
      <p>This heading and note are plain HTML with no JavaScript. Everything below them is an island.</p>
    </>
  );
}

// "<" escape olunur ki, adı "</script>" olan todo script elementini vaxtından əvvəl bağlamasın.
function serialize(props) {
  return JSON.stringify(props).replace(/</g, "\\u003c");
}

export async function handle({ method, path }) {
  if (method !== "GET" || path !== "/") return { status: 404, body: "<h1>Not found</h1>" };
  const props = { initialTodos: todos };

  // Statik hissə: yalnız HTML, hydration-un ehtiyac duyduğu işarələr olmadan. JavaScript yoxdur.
  const intro = renderToStaticMarkup(<Intro />);

  // Island: hydrateRoot-un qoşula biləcəyi HTML, props-u isə JSON kimi düz yanında.
  const island = renderToString(<TodoApp {...props} />);

  return {
    status: 200,
    body: `
    <main class="todo-app">
      ${intro}
      <div id="todo-island">${island}</div>
      <script id="todo-island-props" type="application/json">${serialize(props)}</script>
    </main>
    <script src="/client.jsx"></script>`,
  };
}