Skip to content

Translated this article #1030

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Translated this article #1030

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletions src/content/reference/react/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,42 +1,42 @@
---
title: React Reference Overview
title: Обзор справочника React
---

<Intro>

This section provides detailed reference documentation for working with React. For an introduction to React, please visit the [Learn](/learn) section.
В этом разделе представлена подробная справочная документация по React. Если вы только начинаете знакомство с React, рекомендуем начать с раздела [Изучение](/learn).

</Intro>

The React reference documentation is broken down into functional subsections:
Справочник разбит на несколько функциональных разделов:

## 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.
- [Хуки](/reference/react/hooks) — использование встроенных функций React в компонентах.
- [Компоненты](/reference/react/components) — встроенные компоненты, доступные для использования в JSX.
- [API](/reference/react/apis) — функции, полезные для определения компонентов.
- [Директивы](/reference/rsc/directives) — инструкции для совместимых с серверными компонентами пакетов.

## 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` предоставляет функциональность, специфичную для веб-среды (браузера). Раздел включает:

* [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.
- [Хуки](/reference/react-dom/hooks) — хуки, работающие в DOM-среде.
- [Компоненты](/reference/react-dom/components) — поддержка всех стандартных HTML- и SVG-элементов как компонентов React.
- [API](/reference/react-dom) — методы из пакета `react-dom`, доступные только в веб-приложениях.
- [Клиентские API](/reference/react-dom/client) — API для рендеринга React-компонентов в браузере.
- [Серверные API](/reference/react-dom/server) — API для рендеринга React-компонентов на сервере.

## Rules of React {/*rules-of-react*/}
## Правила 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.
- [Компоненты и хуки должны быть чистыми](/reference/rules/components-and-hooks-must-be-pure) — чистота кода делает его более понятным и предсказуемым и облегчает оптимизацию со стороны React.
- [React управляет вызовами компонентов и хуков](/reference/rules/react-calls-components-and-hooks) — React сам инициирует вызовы компонентов и хуков, чтобы обеспечить оптимальный пользовательский опыт.
- [Правила хуков](/reference/rules/rules-of-hooks) — хуки — это особый тип логики интерфейса с ограничениями на место вызова.

## Legacy APIs {/*legacy-apis*/}
## Устаревшие API {/*legacy-apis*/}

* [Legacy APIs](/reference/react/legacy) - Exported from the `react` package, but not recommended for use in newly written code.
- [Устаревшие API](/reference/react/legacy) — экспортируются из пакета `react`, но не рекомендуются к использованию.