{"componentChunkName":"component---src-templates-docs-js","path":"/docs/hooks-overview.html","result":{"data":{"markdownRemark":{"html":"

Хуки — нововведение в React 16.8, которое позволяет использовать состояние и другие возможности React без написания классов.

\n

Хуки — обратно совместимы. На этой странице вы получите общее представление о хуках. Имейте в виду, что это беглый обзор, который больше подойдёт опытным пользователям React. В конце каждого раздела есть вот такой жёлтый блок с детальным объяснением на случай, если вы запутались:

\n
\n

Подробное объяснение

\n

Если вы хотите понять, почему мы добавляем хуки в React, прочтите мотивацию.

\n
\n

📌 Хук состояния

\n

Рассмотрим пример, в котором рендерится счётчик. Если вы нажмёте на кнопку, значение счётчика будет инкрементировано.

\n
import React, { useState } from 'react';\nfunction Example() {\n  // Объявляем новую переменную состояния \"count\"  const [count, setCount] = useState(0);\n  return (\n    <div>\n      <p>Вы нажали {count} раз</p>\n      <button onClick={() => setCount(count + 1)}>\n        Нажми на меня\n      </button>\n    </div>\n  );\n}
\n

В этом примере, useState — это хук (определение хука дано ниже). Мы вызываем его, чтобы наделить наш функциональный компонент внутренним состоянием. React будет хранить это состояние между рендерами. Вызов useState возвращает две вещи: текущее значение состояния и функцию для его обновления. Эту функцию можно использовать где угодно, например, в обработчике событий. Она схожа с this.setState в классах, но не сливает новое и старое состояние вместе. Сравнение хука useState и this.state приводится на странице Использование хука состояния.

\n

Единственный аргумент useState — это начальное состояние. В примере выше — это 0, так как наш счётчик начинается с нуля. Заметьте, что в отличие от this.state, в нашем случае состояние может, но не обязано, быть объектом. Исходное значение аргумента используется только при первом рендере.

\n

Объявление нескольких переменных состояния

\n

Хук состояния можно использовать в компоненте более одного раза.

\n
function ExampleWithManyStates() {\n  // Объявляем несколько переменных состояния!\n  const [age, setAge] = useState(42);\n  const [fruit, setFruit] = useState('банан');\n  const [todos, setTodos] = useState([{ text: 'Изучить хуки' }]);\n  // ...\n}
\n

Синтаксис деструктуризации массивов позволяет нам по-разному называть переменные состояния, которые мы объявляем при вызове useState. Так как имён этих переменных нет в API useState, React предполагает, что если вы вызываете useState много раз, вы делаете это в одинаковой последовательности при каждом рендере. Мы расскажем, почему это работает и когда это целесообразно, немного позже.

\n

Что же такое хук?

\n

Хуки — это функции, с помощью которых вы можете «подцепиться» к состоянию и методам жизненного цикла React из функциональных компонентов. Хуки не работают внутри классов — они дают вам возможность использовать React без классов. (Мы не рекомендуем сразу же переписывать существующие компоненты, но при желании, вы можете начать использовать хуки в своих новых компонентах.)

\n

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

\n
\n

Подробное объяснение

\n

Вы можете узнать больше на странице Использование хука состояния.

\n
\n

⚡️ Хук эффекта

\n

Вам скорее всего доводилось ранее запрашивать данные, делать подписки или вручную менять DOM из React-компонента. Мы расцениваем эти операции как «побочные эффекты» (или сокращённо «эффекты»), так как они могут влиять на работу других компонентов и их нельзя выполнить во время рендера.

\n

С помощью хука эффекта useEffect вы можете выполнять побочные эффекты из функционального компонента. Он выполняет ту же роль, что и componentDidMount, componentDidUpdate и componentWillUnmount в React-классах, объединив их в единый API. Вы можете найти сравнение useEffect и этих методов на странице использование хука эффекта.

\n

К примеру, этот компонент устанавливает заголовок документа после того, как React обновляет DOM:

\n
import React, { useState, useEffect } from 'react';\nfunction Example() {\n  const [count, setCount] = useState(0);\n\n  // По принципу componentDidMount и componentDidUpdate:  useEffect(() => {    // Обновляем заголовок документа, используя API браузера    document.title = `Вы нажали ${count} раз`;  });\n  return (\n    <div>\n      <p>Вы нажали {count} раз</p>\n      <button onClick={() => setCount(count + 1)}>\n        Нажми на меня\n      </button>\n    </div>\n  );\n}
\n

Когда вы вызываете useEffect, React получает указание запустить вашу функцию с «эффектом» после того, как он отправил изменения в DOM. Поскольку эффекты объявляются внутри компонента, у них есть доступ к его пропсам и состоянию. По умолчанию, React запускает эффекты после каждого рендера, включая первый рендер. Мы рассмотрим более подробно, как это отличается от классовых методов жизненного цикла на странице использование хука эффекта.

\n

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

\n
import React, { useState, useEffect } from 'react';\n\nfunction FriendStatus(props) {\n  const [isOnline, setIsOnline] = useState(null);\n\n  function handleStatusChange(status) {\n    setIsOnline(status.isOnline);\n  }\n\n  useEffect(() => {    ChatAPI.subscribeToFriendStatus(props.friend.id, handleStatusChange);    return () => {      ChatAPI.unsubscribeFromFriendStatus(props.friend.id, handleStatusChange);    };  });\n  if (isOnline === null) {\n    return 'Загрузка...';\n  }\n  return isOnline ? 'В сети' : 'Не в сети';\n}
\n

В этом примере, React будет отписываться от нашего ChatAPI перед тем, как компонент размонтируется и перед тем, как перезапустить эффект при повторном рендере. Вы можете сделать так, чтобы React пропускал повторные подписки если props.friend.id, который мы передали в ChatAPI, остался без изменений.

\n

Так же как и useState, вы можете использовать более одного эффекта в компоненте:

\n
function FriendStatusWithCounter(props) {\n  const [count, setCount] = useState(0);\n  useEffect(() => {    document.title = `Вы нажали ${count} раз`;\n  });\n\n  const [isOnline, setIsOnline] = useState(null);\n  useEffect(() => {    ChatAPI.subscribeToFriendStatus(props.friend.id, handleStatusChange);\n    return () => {\n      ChatAPI.unsubscribeFromFriendStatus(props.friend.id, handleStatusChange);\n    };\n  });\n\n  function handleStatusChange(status) {\n    setIsOnline(status.isOnline);\n  }\n  // ...
\n

Хуки дают вам возможность организовать побочные эффекты в компоненте по связанным частям (например, добавление или отмена подписки), вместо того, чтобы принуждать вас делить всё согласно методам жизненного цикла.

\n
\n

Подробное объяснение

\n

Вы можете узнать больше о useEffect на странице Использование хука эффекта.

\n
\n

✌️ Правила хуков

\n

Хуки — это функции JavaScript, которые налагают два дополнительных правила:

\n\n

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

\n
\n

Подробное объяснение

\n

Вы можете узнать больше на странице Правила хуков.

\n
\n

💡 Создание собственных хуков

\n

Иногда нужно повторно использовать одинаковую логику состояния в нескольких компонентах. Традиционно использовались два подхода: компоненты высшего порядка и рендер-пропсы. С помощью пользовательских хуков эта задача решается без добавления ненужных компонентов в ваше дерево.

\n

Ранее на этой странице мы рассматривали компонент FriendStatus, который вызывал хуки useState и useEffect, чтобы подписаться на статус друга в сети. Допустим, мы хотим ещё раз использовать эту логику с подпиской, но уже в другом компоненте.

\n

Прежде всего, давайте извлечём эту логику в пользовательский хук useFriendStatus

\n
import React, { useState, useEffect } from 'react';\n\nfunction useFriendStatus(friendID) {  const [isOnline, setIsOnline] = useState(null);\n\n  function handleStatusChange(status) {\n    setIsOnline(status.isOnline);\n  }\n\n  useEffect(() => {\n    ChatAPI.subscribeToFriendStatus(friendID, handleStatusChange);\n    return () => {\n      ChatAPI.unsubscribeFromFriendStatus(friendID, handleStatusChange);\n    };\n  });\n\n  return isOnline;\n}
\n

Хук принимает friendID в качестве аргумента и возвращает переменную, которая показывает, в сети наш друг или нет.

\n

Теперь мы можем использовать этот хук в обоих наших компонентах:

\n
function FriendStatus(props) {\n  const isOnline = useFriendStatus(props.friend.id);\n  if (isOnline === null) {\n    return 'Загрузка...';\n  }\n  return isOnline ? 'В сети' : 'Не в сети';\n}
\n
function FriendListItem(props) {\n  const isOnline = useFriendStatus(props.friend.id);\n  return (\n    <li style={{ color: isOnline ? 'green' : 'black' }}>\n      {props.friend.name}\n    </li>\n  );\n}
\n

Состояния каждого компонента никаким образом не зависят друг от друга. Хуки — это способ использовать повторно логику состояния, а не само состояние. Более того, каждое обращение к хуку обеспечивает совершенно изолированное состояние. Вы даже можете использовать один и тот же хук несколько раз в одном компоненте.

\n

Пользовательские хуки — это в большей степени соглашение, чем дополнение. Если имя функции начинается с ”use” и она вызывает другие хуки, мы расцениваем это как пользовательский хук. Если вы будете придерживаться соглашения useSomething при именовании хуков, это позволит нашему плагину для линтера найти баги в коде, который использует хуки.

\n

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

\n
\n

Подробное объяснение

\n

Вы можете узнать больше на странице Создание пользовательских хуков.

\n
\n

🔌 Другие хуки

\n

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

\n
function Example() {\n  const locale = useContext(LocaleContext);  const theme = useContext(ThemeContext);  // ...\n}
\n

А хук useReducer даёт возможность управлять внутренним состоянием более сложного компонента с помощью редюсера.

\n
function Todos() {\n  const [todos, dispatch] = useReducer(todosReducer);  // ...
\n
\n

Подробное объяснение

\n

Вы можете узнать больше обо всех встроенных хуках на странице API-справочника хуков.

\n
\n

Что дальше?

\n

Фух, давайте перестанем торопиться и немного охладим пыл! Если вам что-то непонятно или вы хотите узнать о чём-либо более подробно, вы можете начать читать следующие страницы, начиная с документации хука состояния.

\n

Вы также можете просмотреть API-справочник хуков и FAQ хуков.

\n

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

","frontmatter":{"title":"Краткий обзор хуков","next":"hooks-state.html","prev":"hooks-intro.html"},"fields":{"path":"content/docs/hooks-overview.md","slug":"docs/hooks-overview.html"}}},"pageContext":{"slug":"docs/hooks-overview.html"}},"staticQueryHashes":[]}