diff --git a/src/content/reference/react/index.md b/src/content/reference/react/index.md index a68ddc014d..0e0f1778ae 100644 --- a/src/content/reference/react/index.md +++ b/src/content/reference/react/index.md @@ -1,42 +1,41 @@ --- -title: React Reference Overview +title: Обзор справочника React --- - -This section provides detailed reference documentation for working with React. For an introduction to React, please visit the [Learn](/learn) section. +Этот раздел содержит подробную справочную документацию по работе с React. Для ознакомления с React посетите раздел [Learn](/learn). -The React reference documentation is broken down into functional subsections: +Справочная документация React разделена на функциональные подразделы: ## React {/*react*/} -Programmatic React features: +Программные возможности React: -* [Hooks](/reference/react/hooks) - Use different React features from your components. -* [Components](/reference/react/components) - Built-in components that you can use in your JSX. -* [APIs](/reference/react/apis) - APIs that are useful for defining components. -* [Directives](/reference/rsc/directives) - Provide instructions to bundlers compatible with React Server Components. +* [Hooks](/reference/react/hooks) - Используйте различные возможности React из ваших компонентов. +* [Components](/reference/react/components) - Встроенные компоненты, которые вы можете использовать в своем JSX. +* [APIs](/reference/react/apis) - API, полезные для определения компонентов. +* [Directives](/reference/rsc/directives) - Предоставляют инструкции для сборщиков, совместимых с React Server Components. ## React DOM {/*react-dom*/} -React-dom contains features that are only supported for web applications (which run in the browser DOM environment). This section is broken into the following: +React-dom содержит функции, которые поддерживаются только для веб-приложений (работающих в среде браузерного DOM). Этот раздел разбит на следующие части: -* [Hooks](/reference/react-dom/hooks) - Hooks for web applications which run in the browser DOM environment. -* [Components](/reference/react-dom/components) - React supports all of the browser built-in HTML and SVG components. -* [APIs](/reference/react-dom) - The `react-dom` package contains methods supported only in web applications. -* [Client APIs](/reference/react-dom/client) - The `react-dom/client` APIs let you render React components on the client (in the browser). -* [Server APIs](/reference/react-dom/server) - The `react-dom/server` APIs let you render React components to HTML on the server. +* [Hooks](/reference/react-dom/hooks) - Хуки для веб-приложений, работающих в среде браузерного DOM. +* [Components](/reference/react-dom/components) - React поддерживает все встроенные в браузер HTML и SVG компоненты. +* [APIs](/reference/react-dom) - Пакет `react-dom` содержит методы, поддерживаемые только в веб-приложениях. +* [Client APIs](/reference/react-dom/client) - API `react-dom/client` позволяют рендерить React-компоненты на клиенте (в браузере). +* [Server APIs](/reference/react-dom/server) - API `react-dom/server` позволяют рендерить React-компоненты в HTML на сервере. ## Rules of React {/*rules-of-react*/} -React has idioms — or rules — for how to express patterns in a way that is easy to understand and yields high-quality applications: +React имеет идиомы — или правила — для выражения паттернов таким образом, чтобы их было легко понять и они приводили к созданию высококачественных приложений: -* [Components and Hooks must be pure](/reference/rules/components-and-hooks-must-be-pure) – Purity makes your code easier to understand, debug, and allows React to automatically optimize your components and hooks correctly. -* [React calls Components and Hooks](/reference/rules/react-calls-components-and-hooks) – React is responsible for rendering components and hooks when necessary to optimize the user experience. -* [Rules of Hooks](/reference/rules/rules-of-hooks) – Hooks are defined using JavaScript functions, but they represent a special type of reusable UI logic with restrictions on where they can be called. +* [Components and Hooks must be pure](/reference/rules/components-and-hooks-must-be-pure) – Чистота делает ваш код более понятным, облегчает отладку и позволяет React автоматически правильно оптимизировать ваши компоненты и хуки. +* [React calls Components and Hooks](/reference/rules/react-calls-components-and-hooks) – React отвечает за рендеринг компонентов и хуков при необходимости для оптимизации пользовательского опыта. +* [Rules of Hooks](/reference/rules/rules-of-hooks) – Хуки определяются с использованием функций JavaScript, но они представляют собой особый тип повторно используемой логики пользовательского интерфейса с ограничениями на то, где они могут быть вызваны. ## Legacy APIs {/*legacy-apis*/} -* [Legacy APIs](/reference/react/legacy) - Exported from the `react` package, but not recommended for use in newly written code. +* [Legacy APIs](/reference/react/legacy) - Экспортируются из пакета `react`, но не рекомендуются для использования в новом коде. \ No newline at end of file