Полезные видео о фронтенде. Подпишись на Rutube

Обновление массивов в состоянии React

2 года назад·11 мин. на чтение

Массивы в JavaScript мутабельны, но вы должны обращаться с ними как с иммутабельными, когда сохраняете их в состоянии в компоненте React. Как и в случае с объектами, когда вы хотите обновить массив, хранящийся в состоянии, вам нужно создать новый (или сделать копию существующего), а затем установить состояние для использования нового массива.

Содержание туториала по React Массивы в JavaScript мутабельны, но вы должны обращаться с ними как с иммутабельными, когда сохраняете их в состоянии. Как и в случае с объектами, когда вы хотите обновить массив, хранящийся в состоянии, вам нужно создать новый (или сделать копию существующего), а затем установить состояние для использования нового массива.

Обновление массивов без мутации

В JavaScript массивы — это еще один вид объектов. Как и в случае с объектами, вы должны рассматривать массивы в состоянии React как доступные только для чтения. Это означает, что вы не должны переназначать элементы внутри массива, такие как arr[0] = 'bird', и вы также не должны использовать методы, изменяющие массив, такие как push() и pop(). Вместо этого каждый раз, когда вы хотите обновить массив, нужно передать новый массив вашей функции установки состояния. Для этого вы можете создать новый массив из исходного массива в своем состоянии, вызвав его неизменяющие методы, такие как filter() и map(). Затем вы можете установить свое состояние в полученный новый массив. Вот справочная таблица общих операций с массивами. При работе с массивами внутри состояния React вам нужно избегать методов в левом столбце и вместо этого предпочитать методы в правом столбце:

Syntax	следует избегать (мутирует массив)	предпочтительно (возвращает новый массив)
добавление	`push`, `unshift`	`concat`, `[...arr]` синтаксис распыления (spread)
удаление	`pop`, `shift`, `splice`	`filter`, `slice`
замена	`splice`, `arr[i] = ...` присваивание	`map`
сортировка	`reverse`, `sort`	сначала скопировать массив

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

`slice` и `splice`

К сожалению, slice и splice называются одинаково, но они очень разные:

slice позволяет копировать массив или его часть.
splice изменяет массив (чтобы вставлять или удалять элементы).

В React вы будете использовать slice (без p) гораздо чаще, потому что не стоит мутировать объекты или массивы в состоянии. В стать об Обновлении объектов объясняется, что такое мутация и почему ее не рекомендуется использовать для состояния.

Добавление в массив

push() мутирует массив, что нам не нужно:

import { useState } from 'react';

let nextId = 0;

export default function List() {
  const [name, setName] = useState('');
  const [artists, setArtists] = useState([]);

  return (
    <>
      <h1>Inspiring sculptors:</h1>
      <input value={name} onChange={(e) => setName(e.target.value)} />
      <button
        onClick={() => {
          setName('');
          artists.push({
            id: nextId++,
            name: name,
          });
        }}
      >
        Add
      </button>
      <ul>
        {artists.map((artist) => (
          <li key={artist.id}>{artist.name}</li>
        ))}
      </ul>
    </>
  );
}

Вместо этого создайте новый массив, содержащий существующие элементы и новый элемент в конце. Есть несколько способов сделать это, но самый простой — использовать синтаксис ... распыления массива:

setArtists(
  // заменим массив
  [
    // новым массивом
    ...artists, // который содержит все старые значения
    { id: nextId++, name: name }, // и новое в конце
  ]
);

Теперь код работает корректно:

import { useState } from 'react';

let nextId = 0;

export default function List() {
  const [name, setName] = useState('');
  const [artists, setArtists] = useState([]);

  return (
    <>
      <h1>Inspiring sculptors:</h1>
      <input value={name} onChange={(e) => setName(e.target.value)} />
      <button
        onClick={() => {
          setName('');
          setArtists([...artists, { id: nextId++, name: name }]);
        }}
      >
        Add
      </button>
      <ul>
        {artists.map((artist) => (
          <li key={artist.id}>{artist.name}</li>
        ))}
      </ul>
    </>
  );
}

Синтаксис распыления массива также позволяет вам добавить элемент, поместив его перед исходными элментами:

setArtists([
  { id: nextId++, name: name },
  ...artists, // поместим старые элементы в конец
]);

Таким образом, распыление (spread) может выполнять работу как push(), добавляя в конец массива, так и unshift(), добавляя в начало массива.

Удаление из массива

Самый простой способ удалить элемент из массива — отфильтровать его. Другими словами, вы создадите новый массив, который не будет содержать этот элемент. Для этого используйте метод filter, например:

import { useState } from 'react';

let initialArtists = [
  { id: 0, name: 'Marta Colvin Andrade' },
  { id: 1, name: 'Lamidi Olonade Fakeye' },
  { id: 2, name: 'Louise Nevelson' },
];

export default function List() {
  const [artists, setArtists] = useState(initialArtists);

  return (
    <>
      <h1>Inspiring sculptors:</h1>
      <ul>
        {artists.map((artist) => (
          <li key={artist.id}>
            {artist.name}{' '}
            <button
              onClick={() => {
                setArtists(artists.filter((a) => a.id !== artist.id));
              }}
            >
              Delete
            </button>
          </li>
        ))}
      </ul>
    </>
  );
}

setArtists(artists.filter((a) => a.id !== artist.id));

Здесь artist.filter(a => a.id !== artist.id) означает «создать массив, состоящий из тех исполнителей, идентификаторы которых отличаются от artist.id». Другими словами, кнопка «Удалить» каждого исполнителя отфильтрует этого исполнителя из массива, а затем запросит повторный рендеринг с результирующим массивом. Обратите внимание, что фильтр не мутирует исходный массив.

Преобразование массива

Если вы хотите изменить некоторые или все элементы массива, вы можете использовать map() для создания нового массива. Функция, которую вы передадите в map, может решить, что делать с каждым элементом, на основе его данных или его индекса (или того и другого). В этом примере массив содержит координаты двух кругов и квадрата. Когда вы нажимаете кнопку, она перемещает только круги вниз на 50 пикселей. Он делает это, создавая новый массив данных с помощью map():

import { useState } from 'react';

let initialShapes = [
  { id: 0, type: 'circle', x: 50, y: 100 },
  { id: 1, type: 'square', x: 150, y: 100 },
  { id: 2, type: 'circle', x: 250, y: 100 },
];

export default function ShapeEditor() {
  const [shapes, setShapes] = useState(initialShapes);

  function handleClick() {
    const nextShapes = shapes.map((shape) => {
      if (shape.type === 'square') {
        // не меняем
        return shape;
      } else {
        // возвращаем новый круг ниже на 50px
        return {
          ...shape,
          y: shape.y + 50,
        };
      }
    });
    // Ререндерим с новыми фигурами
    setShapes(nextShapes);
  }

  return (
    <>
      <button onClick={handleClick}>Move circles down!</button>
      {shapes.map((shape) => (
        <div
          key={shape.id}
          style={{
            background: 'purple',
            position: 'absolute',
            left: shape.x,
            top: shape.y,
            borderRadius: shape.type === 'circle' ? '50%' : '',
            width: 20,
            height: 20,
          }}
        />
      ))}
    </>
  );
}

Замена элементов в массиве

Особенно часто требуется заменить один или несколько элементов в массиве. Такие присваивания, как arr[0] = 'bird', мутируют исходный массив, поэтому вместо этого вы также захотите использовать для этого map. Чтобы заменить элемент, создайте новый массив с map. Внутри вашего вызова map вы получите индекс элемента в качестве второго аргумента. Используйте его, чтобы решить, следует ли вернуть исходный элемент (первый аргумент) или что-то еще:

import { useState } from 'react';

let initialCounters = [0, 0, 0];

export default function CounterList() {
  const [counters, setCounters] = useState(initialCounters);

  function handleIncrementClick(index) {
    const nextCounters = counters.map((c, i) => {
      if (i === index) {
        // Инкрементируем счетчик, который кликнули
        return c + 1;
      } else {
        // Остальные не меняем
        return c;
      }
    });
    setCounters(nextCounters);
  }

  return (
    <ul>
      {counters.map((counter, i) => (
        <li key={i}>
          {counter}
          <button
            onClick={() => {
              handleIncrementClick(i);
            }}
          >
            +1
          </button>
        </li>
      ))}
    </ul>
  );
}

Вставка в массив

Иногда вам может понадобиться вставить элемент в определенную позицию, которая не находится ни в начале, ни в конце. Для этого вы можете использовать синтаксис распыления массива ... вместе с методом slice(). Метод slice() позволяет вырезать «срез» массива. Чтобы вставить элемент, вы создадите массив, который распыляет фрагмент массива перед точкой вставки, затем новый элемент, а затем остальную часть исходного массива. В этом примере кнопка «Вставить» всегда вставляет по индексу 1:

import { useState } from 'react';

let nextId = 3;
const initialArtists = [
  { id: 0, name: 'Marta Colvin Andrade' },
  { id: 1, name: 'Lamidi Olonade Fakeye' },
  { id: 2, name: 'Louise Nevelson' },
];

export default function List() {
  const [name, setName] = useState('');
  const [artists, setArtists] = useState(initialArtists);

  function handleClick() {
    const insertAt = 1; // Может быть любой индекс
    const nextArtists = [
      // Элементы перед вставляемым элементом:
      ...artists.slice(0, insertAt),
      // Новый элемент:
      { id: nextId++, name: name },
      // Элементы после вставленного элемента:
      ...artists.slice(insertAt),
    ];
    setArtists(nextArtists);
    setName('');
  }

  return (
    <>
      <h1>Inspiring sculptors:</h1>
      <input value={name} onChange={(e) => setName(e.target.value)} />
      <button onClick={handleClick}>Insert</button>
      <ul>
        {artists.map((artist) => (
          <li key={artist.id}>{artist.name}</li>
        ))}
      </ul>
    </>
  );
}

Внесение других изменений в массив

Есть некоторые вещи, которые вы не можете сделать с помощью синтаксиса распыления и неизменяющих методов, таких как map() и filter(). Например, вы можете захотеть перевернуть или отсортировать массив. JavaScript методы reverse() и sort() мутируют исходный массив, поэтому вы не можете использовать их напрямую. Однако вы можете сначала скопировать массив, а затем внести в него изменения. Например:

import { useState } from 'react';

let nextId = 3;
const initialList = [
  { id: 0, title: 'Big Bellies' },
  { id: 1, title: 'Lunar Landscape' },
  { id: 2, title: 'Terracotta Army' },
];

export default function List() {
  const [list, setList] = useState(initialList);

  function handleClick() {
    const nextList = [...list];
    nextList.reverse();
    setList(nextList);
  }

  return (
    <>
      <button onClick={handleClick}>Reverse</button>
      <ul>
        {list.map((artwork) => (
          <li key={artwork.id}>{artwork.title}</li>
        ))}
      </ul>
    </>
  );
}

Здесь вы используете синтаксис распыления [...list], чтобы сначала создать копию исходного массива. Теперь, когда у вас есть копия, вы можете использовать мутирующие методы, такие как nextList.reverse() или nextList.sort(), или даже назначать отдельные элементы с помощью nextList[0] = "something". Однако, даже если вы скопируете массив, вы не сможете мутировать существующие элементы внутри него. Это связано с тем, что копирование неглубокое — новый массив будет содержать те же элементы, что и исходный. Поэтому, если вы мутируете объект внутри скопированного массива, вы изменяете существующее состояние. Например, такой код является проблемой.

const nextList = [...list];
nextList[0].seen = true; // Проблема: мутирует list[0]
setList(nextList);

Хотя nextList и list — это два разных массива, nextList[0] и list[0] указывают на один и тот же объект. Таким образом, изменяя nextList[0].seen, вы также меняете list[0].seen. Это мутация состояния, которой следует избегать. Вы можете решить эту проблему аналогично обновлению вложенных JavaScript объектов — копируя отдельные элементы, которые вы хотите изменить, вместо их изменения. Рассмотрим этот случай далее.

Обновление объектов внутри массивов

Объекты на самом деле не расположены «внутри» массивов. В коде они могут казаться «внутри», но каждый объект в массиве — это отдельное значение, на которое «указывает» массив. Вот почему вам нужно быть осторожным при изменении вложенных полей, таких как list[0]. При обновлении вложенного состояния вам необходимо создавать копии от точки, где вы хотите обновить, и вплоть до верхнего уровня. Давайте посмотрим, как это работает. В этом примере два отдельных списка иллюстраций имеют одинаковое начальное состояние. Предполагается, что они изолированы, но из-за мутации их состояние случайно становится общим, и установка флажка в одном списке влияет на другой список:

import { useState } from 'react';

let nextId = 3;
const initialList = [
  { id: 0, title: 'Big Bellies', seen: false },
  { id: 1, title: 'Lunar Landscape', seen: false },
  { id: 2, title: 'Terracotta Army', seen: true },
];

export default function BucketList() {
  const [myList, setMyList] = useState(initialList);
  const [yourList, setYourList] = useState(initialList);

  function handleToggleMyList(artworkId, nextSeen) {
    const myNextList = [...myList];
    const artwork = myNextList.find((a) => a.id === artworkId);
    artwork.seen = nextSeen;
    setMyList(myNextList);
  }

  function handleToggleYourList(artworkId, nextSeen) {
    const yourNextList = [...yourList];
    const artwork = yourNextList.find((a) => a.id === artworkId);
    artwork.seen = nextSeen;
    setYourList(yourNextList);
  }

  return (
    <>
      <h1>Art Bucket List</h1>
      <h2>My list of art to see:</h2>
      <ItemList artworks={myList} onToggle={handleToggleMyList} />
      <h2>Your list of art to see:</h2>
      <ItemList artworks={yourList} onToggle={handleToggleYourList} />
    </>
  );
}

function ItemList({ artworks, onToggle }) {
  return (
    <ul>
      {artworks.map((artwork) => (
        <li key={artwork.id}>
          <label>
            <input
              type="checkbox"
              checked={artwork.seen}
              onChange={(e) => {
                onToggle(artwork.id, e.target.checked);
              }}
            />
            {artwork.title}
          </label>
        </li>
      ))}
    </ul>
  );
}

Проблема в этом коде:

const myNextList = [...myList];
const artwork = myNextList.find((a) => a.id === artworkId);
artwork.seen = nextSeen; // Проблема: мутируется существующий элемент
setMyList(myNextList);

Хотя сам массив myNextList новый, сами элементы те же, что и в исходном массиве myList. Таким образом, изменение artwork.seen изменяет исходный элемент изображения. Этот предмет искусства также находится в ваших произведениях искусства, что вызывает ошибку. О таких ошибках может быть трудно догадаться, но, к счастью, они исчезают, если вы избегаете мутирующего состояния. Вы можете использовать map, чтобы заменить старый элемент его обновленной версией без изменения.

setMyList(myList.map(artwork => {
  if (artwork.id === artworkId) {
    // Создает *новый* объект с изменениями
    return { ...artwork, seen: nextSeen };
  } else {
    // без изменений
    return artwork;
  }
});

Здесь ... — это синтаксис распыления объекта, используемый для создания копии объекта.

При таком подходе ни один из существующих элементов состояния не мутируется, а ошибка исправлена:

import { useState } from 'react';

let nextId = 3;
const initialList = [
  { id: 0, title: 'Big Bellies', seen: false },
  { id: 1, title: 'Lunar Landscape', seen: false },
  { id: 2, title: 'Terracotta Army', seen: true },
];

export default function BucketList() {
  const [myList, setMyList] = useState(initialList);
  const [yourList, setYourList] = useState(initialList);

  function handleToggleMyList(artworkId, nextSeen) {
    setMyList(
      myList.map((artwork) => {
        if (artwork.id === artworkId) {
          // Создает *новый* объект с изменениями
          return { ...artwork, seen: nextSeen };
        } else {
          // без изменений
          return artwork;
        }
      })
    );
  }

  function handleToggleYourList(artworkId, nextSeen) {
    setYourList(
      yourList.map((artwork) => {
        if (artwork.id === artworkId) {
          // Создает *новый* объект с изменениями
          return { ...artwork, seen: nextSeen };
        } else {
          // без изменений
          return artwork;
        }
      })
    );
  }

  return (
    <>
      <h1>Art Bucket List</h1>
      <h2>My list of art to see:</h2>
      <ItemList artworks={myList} onToggle={handleToggleMyList} />
      <h2>Your list of art to see:</h2>
      <ItemList artworks={yourList} onToggle={handleToggleYourList} />
    </>
  );
}

function ItemList({ artworks, onToggle }) {
  return (
    <ul>
      {artworks.map((artwork) => (
        <li key={artwork.id}>
          <label>
            <input
              type="checkbox"
              checked={artwork.seen}
              onChange={(e) => {
                onToggle(artwork.id, e.target.checked);
              }}
            />
            {artwork.title}
          </label>
        </li>
      ))}
    </ul>
  );
}

Как правило, вам следует мутировать только те объекты, которые вы только что создали. Если бы вы вставляли новое изображение, вы могли бы изменить его, но если вы имеете дело с чем-то, что уже находится в состоянии, вам нужно сделать копию.

Напишем лаконичный код обновления с помощью Immer

Обновление вложенных массивов без изменения может стать немного повторяющимся. Так же, как и с объектами:

Как правило, вам не нужно обновлять состояние глубже, чем на пару уровней. Если ваши объекты состояния очень глубокие, вы можете захотеть реструктурировать их по-другому, чтобы они были плоскими.
Если вы не хотите менять свою структуру состояния, вы можете предпочесть использовать Immer, который позволяет вам писать с использованием удобного, но мутирующего синтаксиса и заботится о создании копий для вас.

Вот пример Art Bucket List, переписанный с помощью Immer:

import { useState } from 'react';
import { useImmer } from 'use-immer';

let nextId = 3;
const initialList = [
  { id: 0, title: 'Big Bellies', seen: false },
  { id: 1, title: 'Lunar Landscape', seen: false },
  { id: 2, title: 'Terracotta Army', seen: true },
];

export default function BucketList() {
  const [myList, updateMyList] = useImmer(initialList);
  const [yourArtworks, updateYourList] = useImmer(initialList);

  function handleToggleMyList(id, nextSeen) {
    updateMyList((draft) => {
      const artwork = draft.find((a) => a.id === id);
      artwork.seen = nextSeen;
    });
  }

  function handleToggleYourList(artworkId, nextSeen) {
    updateYourList((draft) => {
      const artwork = draft.find((a) => a.id === artworkId);
      artwork.seen = nextSeen;
    });
  }

  return (
    <>
      <h1>Art Bucket List</h1>
      <h2>My list of art to see:</h2>
      <ItemList artworks={myList} onToggle={handleToggleMyList} />
      <h2>Your list of art to see:</h2>
      <ItemList artworks={yourArtworks} onToggle={handleToggleYourList} />
    </>
  );
}

function ItemList({ artworks, onToggle }) {
  return (
    <ul>
      {artworks.map((artwork) => (
        <li key={artwork.id}>
          <label>
            <input
              type="checkbox"
              checked={artwork.seen}
              onChange={(e) => {
                onToggle(artwork.id, e.target.checked);
              }}
            />
            {artwork.title}
          </label>
        </li>
      ))}
    </ul>
  );
}

package.json

{
  "dependencies": {
    "immer": "1.7.3",
    "react": "latest",
    "react-dom": "latest",
    "react-scripts": "latest",
    "use-immer": "0.5.1"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test --env=jsdom",
    "eject": "react-scripts eject"
  },
  "devDependencies": {}
}

Обратите внимание, как с Immer мутация, такая как artwork.seen = nextSeen, теперь исправлена:

updateMyTodos((draft) => {
  const artwork = draft.find((a) => a.id === artworkId);
  artwork.seen = nextSeen;
});

Это связано с тем, что вы мутируете не исходное состояние, а изменяете специальный объект-черновик (draft), предоставленный Immer. Точно так же вы можете применять методы мутирования, такие как push() и pop(), к содержимому черновика. За кулисами Immer всегда строит следующее состояние с нуля в соответствии с изменениями, которые вы внесли в черновик. Это позволяет вашим обработчикам событий быть очень лаконичными без мутирования состояния.

Резюме

Вы можете поместить массивы в состояние, но вы не можете их мутировать.
Вместо того, чтобы мутировать массив, создайте его новую версию и обновите для нее состояние.
Вы можете использовать синтаксис распыления массива [...arr, newItem] для создания массивов с новыми элементами.
Вы можете использовать filter() и map() для создания новых массивов с отфильтрованными или преобразованными элементами.
Вы можете использовать Immer, чтобы ваш код был короче.

Frontend React Туториал по React

Все виды управления состоянием в React

3 месяца назад·9 мин. на чтение

Управлять состоянием в React можно множеством способов. Вам может не понадобиться useState, Redux, TanStack Query или любая другая библиотека. Это зависит от типа состояния, которым вам нужно управлять.

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

Состояние в адресной строке

Самый простой вид состояния — это состояние в URL. Хранилище ключей и значений как часть URL: /search?query=abc. Состояние в URL идеально подходит для простых значений и хранения обновлений как части истории браузера. Примером может служить переключение между списком и элементом с помощью radio button.

export default function Page() {
  return (
    <div>
      <input
        name="view"
        type="radio"
        value="list"
      />
      <input
        name="view"
        type="radio"
        value="tiles"
      />
    </div>
  );
}

Сохранение фильтров и выбора в истории браузера позволяет пользователю отменить выбор, нажав кнопку «Назад» . onChange помещает ту же страницу с добавленными параметрами поиска в URL:

"use client";

import { usePathname, useRouter } from "next/navigation";

export default function Page() {
  const pathname = usePathname();
  const router = useRouter();

  // Нет нужды хранить значение в `useState`, а хранится в URL
  const onChange = (event: React.ChangeEvent<HTMLInputElement>) => {
    const urlSearchParams = new URLSearchParams();
    urlSearchParams.set("view", event.target.value);
    router.push(`${pathname}?${urlSearchParams.toString()}`, { scroll: false });
  };

  return (
    <div>
      <input
        name="view"
        type="radio"
        value="list"
        onChange={onChange}
      />
      <input
        name="view"
        type="radio"
        value="tiles"
        onChange={onChange}
      />
    </div>
  );
}

При выборе опции URL-адрес обновляется с использованием ключа view (поле name инпута) и значения list или tiles. NextJS предоставляет хук useSearchParams для чтения параметров поиска из URL. Мы извлекаем ключ view и устанавливаем defaultChecked параметр каждого инпута:

"use client";

import { usePathname, useRouter, useSearchParams } from "next/navigation";

export default function Page() {
  const pathname = usePathname();
  const searchParams = useSearchParams(); // здесь
  const view = searchParams.get("view") ?? undefined; // здесь

  const router = useRouter();

  const onChange = (event: React.ChangeEvent<HTMLInputElement>) => {
    const urlSearchParams = new URLSearchParams(searchParams);
    urlSearchParams.set("view", event.target.value);
    router.push(`${pathname}?${urlSearchParams.toString()}`, { scroll: false });
  };

  return (
    <div>
      <input
        name="view"
        type="radio"
        value="list"
        // Применим значение по умолчанию из `URLSearchParams`
        defaultChecked={view === "list"}
        onChange={onChange}
      />
      <input
        name="view"
        type="radio"
        value="tiles"
        // Применим значение по умолчанию из `URLSearchParams`
        defaultChecked={view === "tiles"}
        onChange={onChange}
      />
    </div>
  );
}

Значение будет выбрано по умолчанию даже при перезагрузке страницы. Другой вариант с NextJS читать параметры поиска - читать их внутри серверных компонентов. Каждая страница имеет доступ к props, содержащим searchParams как Promise:

interface Props {
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>;
}

export default async function Page(props: Props) {
  const searchParams = await props.searchParams; // здесь
  const view = searchParams.view ?? undefined; // здесь
  /// ...
}

Такие хуки, такие как useRouter или usePathname не доступны в серверных компонентов. Способом сохранения пропсов searchParams, и хуков в одном компоненте является новая функция use:

"use client"; // Можно не создавать отдельный компонент для клиентского кода

import { usePathname, useRouter } from "next/navigation";
import { use } from "react";

interface Props {
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>;
}

// Не нужно создавать async серверный компонент
export default function Page(props: Props) {
  // Доступ к асинхронным `searchParams` с помощью новой функции `use` (React 19)
  const searchParams = use(props.searchParams);
  const view = searchParams.view ?? undefined;

  const pathname = usePathname();
  const router = useRouter();

  const onChange = (event: React.ChangeEvent<HTMLInputElement>) => {
    const urlSearchParams = new URLSearchParams();
    urlSearchParams.set("view", event.target.value);
    router.push(`${pathname}?${urlSearchParams.toString()}`, { scroll: false });
  };

  return (
    <div>
      <input
        name="view"
        type="radio"
        value="list"
        defaultChecked={view === "list"}
        onChange={onChange}
      />
      <input
        name="view"
        type="radio"
        value="tiles"
        defaultChecked={view === "tiles"}
        onChange={onChange}
      />
    </div>
  );
}

Во всех примерах обратите внимание, что инпут - неуправляемый компонент. Поскольку состояние хранится в URL, то нет необходимости в useState. Вот как реализовать то же самое с useState (управляемый компонент):

"use client";

import { useState } from "react";

export default function Page() {
  const [view, setView] = useState<string | undefined>(undefined);

  const onChange = (event: React.ChangeEvent<HTMLInputElement>) => {
    setView(event.target.value);
  };

  return (
    <div>
      <input
        name="view"
        type="radio"
        value="list"
        // `checked` вместо `defaultChecked` для управляемого компонента
        checked={view === "list"}
        onChange={onChange}
      />
      <input
        name="view"
        type="radio"
        value="tiles"
        // `checked` вместо `defaultChecked` для управляемого компонента
        checked={view === "tiles"}
        onChange={onChange}
      />
    </div>
  );
}

Состояние URL настолько распространено, что большинство React фреймворков включают специальную поддержку параметров поиска.

Состояние на стороне сервера

Состояние сервера относится к данным, которые управляются сервером, а не являются локальными для клиента. Обычно вы читаете данные при загрузке страницы. Данные не обновляются на клиенте, а перезагружаются после обновления (POST, PUT или DELETE). Поскольку эти данные считываются только один раз при загрузке страницы, вам не нужно делать запрос на чтение на клиенте. Вместо этого вы обычно предварительно загружаете данные и HTML на сервере. Вот для чего нужны серверные компоненты:

interface Post {
  title: string;
  body: string;
}

export default async function Page() {
  // Сервер загружает данные прямо в серверный компонент (React 19)
  const post = await fetch("https://jsonplaceholder.typicode.com/posts/1").then(
    (response) => response.json() as Promise<Post>
  );

  return (
    <div>
      <h2>{post.title}</h2>
      <p>{post.body}</p>
    </div>
  );
}

Серверный компонент помечен как async и fetch выполняется непосредственно внутри функции компонента. Клиент получает окончательный макет без необходимости делать еще один запрос к серверу. После обновления сервера (POST/ PUT/DELETE) вам необходимо вручную перезагрузить страницу, чтобы отобразить новые данные. Если вместо этого вы предпочитаете повторно проверять данные на клиенте, используйте такие решения, как TanStack Query. useQuery делает асинхронный запрос, когда страница загружается (на клиенте) и сохраняет ответ в кэше. Периодически делается новый запрос для повторной проверки данных:

"use client"; // Клиентский компонент

import { useQuery } from "@tanstack/react-query";

interface Post {
  title: string;
  body: string;
}

export default function Page() {
  const result = useQuery({
    queryKey: ["post"],
    queryFn: () =>
      fetch("https://jsonplaceholder.typicode.com/posts/1").then(
        (response) => response.json() as Promise<Post>
      ),
  });

  if (result.isPending) {
    return <div>Loading...</div>;
  } else if (result.isError) {
    return <div>Error: {result.error.message}</div>;
  }

  return (
    <div>
      <h2>{result.data.title}</h2>
      <p>{result.data.body}</p>
    </div>
  );
}

Вам необходимо проверить оба isPending и isError, чтобы убедиться, что data определена. Поскольку запрос выполняется на клиенте, при первой загрузке пользователь увидит состояние загрузки (isPending). Этого не происходит с серверными компонентами, поскольку страница загружена и готова к отправке клиенту.

Состояние внутри формы

Форма хранит данные ввода с целью отправки form запроса. React 19 представляет useActionState хук специально для запросов форм. useActionState сохраняет состояние запроса (обычно данные ответа) и заботится о состоянии ожидания.

export default function Page() {
  const [state, action, isPending] = useActionState(api, null);
  return (
    <form action={action}>
      <input type="text" name="email" autoComplete="email" />
      <input type="password" name="password" autoComplete="current-password" />
      <button type="submit" disabled={isPending}>
        Submit
      </button>
    </form>
  );
}

api реализует async запрос (или синхронный) путем извлечения значений из FormData (на основе name инпутов).

"use client";

import { useActionState } from "react";

type State = null; // основано на типе ответа

const api = async (
  previousState: State,
  formData: FormData
): Promise<State> => {
  const email = formData.get("email");
  const password = formData.get("password");
  console.log(email, password);
  await new Promise((resolve) => setTimeout(resolve, 2000));
  return null;
};

export default function Page() {
  const [state, action, isPending] = useActionState(api, null);
  return (
    <form action={action}>
      <input type="text" name="email" autoComplete="email" />
      <input type="password" name="password" autoComplete="current-password" />
      <button type="submit" disabled={isPending}>
        Submit
      </button>
    </form>
  );
}

Все инпуты неконтролируемые, их значения извлекаются из FormData. Нет необходимости в нескольких useState. При такой реализации запрос отправляется внутри клиента. Поэтому console.log будет выведен в консоль браузера.

Серверные действия

Если вы хотите выполнить действие внутри сервера, вы можете использовать серверные действия. Реализация та же самая, но api функция находится в отдельном файле, помеченном как "use server":

"use server";

type State = null;

export const api = async (
  previousState: State,
  formData: FormData
): Promise<State> => {
  const email = formData.get("email");
  const password = formData.get("password");
  console.log(email, password);
  await new Promise((resolve) => setTimeout(resolve, 2000));
  return null;
};

Компонент ссылается на api так же, как и раньше внутри useActionState:

"use client";

import { useActionState } from "react";
import { api } from "./api";

export default function Page() {
  const [state, action, isPending] = useActionState(api, null);
  return (
    <form action={action}>
      <input type="text" name="email" autoComplete="email" />
      <input type="password" name="password" autoComplete="current-password" />
      <button type="submit" disabled={isPending}>
        Submit
      </button>
    </form>
  );
}

При такой реализации api будет выполнено на сервере. Поэтому console.log печатает в логах сервера (в браузере ничего не печатается). При отправке формы на сервер отправляется POST-запрос. Параметры функции и метаданные отправляются как часть RPC-запроса для выполнения API на сервере. При отправке формы на сервер отправляется POST-запрос. Параметры функции и метаданные отправляются как часть RPC-запроса для выполнения API на сервере.

Мутации с TanStack Query

Другой вариант — использование мутаций из TanStack Query с useMutation хуком. useMutation принимает функцию для выполнения, как и useActionState. Невозможно напрямую использовать action формы. Вместо этого можно выполнить мутацию onSubmit: Вам необходимо вручную вызвать preventDefault, чтобы избежать перезагрузки страницы.

export default function Page() {
  const mutation = useMutation({
    mutationFn: api,
  });

  return (
    <form
      onSubmit={(event) => {
        event.preventDefault(); // здесь
        mutation.mutate(new FormData(event.currentTarget));
      }}
    >
      <input type="text" name="email" autoComplete="email" />
      <input type="password" name="password" autoComplete="current-password" />
      <button type="submit" disabled={mutation.isPending}>
        Submit
      </button>
    </form>
  );
}

api то же самое, что и раньше. Он получает FormData и выполняет функцию на клиенте. Даже в этом случае состояние неконтролируемо и извлекается как FormData:

"use client";

import { useMutation } from "@tanstack/react-query";

const api = async (formData: FormData) => {
  const email = formData.get("email");
  const password = formData.get("password");
  console.log(email, password);
  await new Promise((resolve) => setTimeout(resolve, 2000));
};

export default function Page() {
  const mutation = useMutation({
    mutationFn: api,
  });

  return (
    <form
      onSubmit={(event) => {
        event.preventDefault();
        mutation.mutate(new FormData(event.currentTarget));
      }}
    >
      <input type="text" name="email" autoComplete="email" />
      <input type="password" name="password" autoComplete="current-password" />
      <button type="submit" disabled={mutation.isPending}>
        Submit
      </button>
    </form>
  );
}

Состояние на стороне клиента

До сих пор мы не использовали ни useState, ни useReducer, ни какой-либо другой хук или библиотеку, которая хранит и вручную обновляет данные на клиенте. Во всех вышеперечисленных случаях это не нужно:

Состояние URL для пар «ключ-значение» синхронизировано с URL (история браузера)
Состояние сервера для чтения данных при загрузке страницы
Состояние формы для отправки form запросов

Состояние клиента необходимо только для управления сложными взаимодействиями: множественными переменными, включая производные значения с множественными состояниями и шагами. Для этих сложных вариантов использования вам нужен способ контролировать мутации и избегать ненужных повторных рендеров. Тогда следует обратиться к библиотекам вроде XState, Zustand, Redux. В большинстве случаев вам может даже не понадобиться внешняя библиотека. Хуки вроде useReducer, useContext, и useState могут быть достаточны для большинства локальных и простых случаев использования.

Функция перехода состояния

Библиотека управления состоянием в основном отвечает за:

Хранение и предоставление доступа к состоянию
Обновление состояния (избегая чрезмерного повторного рендеринга)

Распространенный шаблон, ставший популярным благодаря Redux, состоит в функции перехода состояния. Это функция, которая принимает событие и текущее состояние и возвращает следующее состояние. Самая простая реализация этого шаблона - это useReducer:

"use client";

import { useReducer } from "react";

interface State {
  firstName: string;
  lastName: string;
}

type Event =
  | { type: "firstName.update"; value: string }
  | { type: "lastName.update"; value: string };

const reducer = (state: State, event: Event): State => {
  switch (event.type) {
    case "firstName.update":
      return { ...state, firstName: event.value };
    case "lastName.update":
      return { ...state, lastName: event.value };
  }
};

export default function Page() {
  const [state, dispatch] = useReducer(reducer, {
    firstName: "",
    lastName: "",
  });
  const fullName = `${state.firstName} ${state.lastName}`; // Производное состояние
  return (
    <form>
      <input
        type="text"
        name="firstName"
        value={state.firstName}
        onChange={(event) =>
          dispatch({ type: "firstName.update", value: event.target.value })
        }
      />
      <input
        type="text"
        name="lastName"
        value={state.lastName}
        onChange={(event) =>
          dispatch({ type: "lastName.update", value: event.target.value })
        }
      />

      <p>{fullName}</p>
      <button type="submit">Submit</button>
    </form>
  );
}

Такие библиотеки, как @xstate/store и Redux, основаны на этом же шаблоне.

Стэйт машины (конечные автоматы)

Для еще более сложных случаев состояния (объекта) и событий недостаточно. Конечные автоматы моделируют различные состояния явно (например, «открыто»/«закрыто»). Обновление состояния использует ту же событийно-управляемую логику функции редьюсера. Главное отличие в том, что определенные действия разрешены только внутри определенных состояний. Конечные машины можно визуализировать в виде диаграммы. Этот дополнительный уровень абстракции предотвращает непреднамеренные действия, когда они не разрешены в состоянии. Он дает больше контроля над состояниями приложения за счет более высокой сложности . Конечный автомат моделирует всю сложность вашего приложения, поэтому его часто считают более сложным для реализации и требующим больше кода. Стандартным решением для конечных автоматов в React является XState:

"use client";

import { useMachine } from "@xstate/react";
import { createMachine } from "xstate";

const machine = createMachine({
  types: {} as {
    events: { type: "OPEN" } | { type: "CLOSE" };
  },
  initial: "closed",
  states: {
    closed: {
      on: { OPEN: "open" },
    },
    open: {
      on: { CLOSE: "closed" },
    },
  },
});

export default function Page() {
  const [snapshot, send] = useMachine(machine);

  if (snapshot.matches("open")) {
    return (
      <div>
        <p>Open</p>
        <button onClick={() => send({ type: "CLOSE" })}>Close</button>
      </div>
    );
  }

  return (
    <div>
      <p>Closed</p>
      <button onClick={() => send({ type: "OPEN" })}>Open</button>
    </div>
  );
}

Диаграммы состояний

Диаграммы состояний расширяют базовую модель конечных автоматов для создания комплексного решения по управлению состоянием. Диаграммы состояний добавляют дополнительные функции, включая иерархию, параллелизм и коммуникацию. XState реализует модель диаграмм состояний (statecharts ). Он также позволяет нескольким statecharts взаимодействовать друг с другом в модели актора. Актор инкапсулирует логику определенной функциональности в вашем приложении. Модель актора позволяет отправлять сообщения между акторами как модель параллельных вычислений.

Библиотеки управления состоянием в React

Ниже представлен обширный список библиотек управления состоянием для более сложных требований состояние на стороне клиента:

@xstate/store
zustand
jotai
redux
Redux Toolkit
MobX
xstate
Valtio
MobX-State-Tree

Frontend React hooks React Redux