Skip to content

Added page translation: basics -> rendering elements #11

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.

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

Merged
merged 11 commits into from
Feb 10, 2019
Merged
Changes from 1 commit
Commits
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
28 changes: 14 additions & 14 deletions content/docs/rendering-elements.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,26 @@
---
id: rendering-elements
title: Отрисовка Элементов
title: Рендеринг элементов
permalink: docs/rendering-elements.html
redirect_from:
- "docs/displaying-data.html"
prev: introducing-jsx.html
next: components-and-props.html
---

Элементы являются самыми маленькими строительными блоками в React-приложениях.
Элементы — мельчайшие кирпичики React-приложениях.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

приложений


Элемент опысывает то, что вы хотите увидеть на экране:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

опечатка: описывает


```js
const element = <h1>Hello, world</h1>;
```

В отличии от DOM-элементов, элементы React — это простые объексты, на их создание уходит немного ресурсов. React DOM обновляет DOM, чтобы он соотвествовал элементам React.
В отличии от DOM-элементов, элементы React — это простые объекты, не отнимающие много ресурсов. React DOM обновляет DOM, чтобы он соотвествовал элементам React.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Может «соответствовал переданным React-элементам». По-моему так чуть понятнее.


>**Заметка:**
>**Примечание:**
>
>Элементы можно перепутать с более известной концепцией "компонентов". Про компоненты будет рассказано в [следующей главе](/docs/components-and-props.html). Элементы — это то, "из чего сделаны" компоненты, и мы рекомендуем вам дочитать эту главу, прежде чем двигаться дальше.
>Элементы можно перепутать с более известной концепцией "компонентов". С компонентами мы ознакомимся в [следующей главе](/docs/components-and-props.html). Элементы — это то, "из чего сделаны" компоненты, и мы рекомендуем вам дочитать эту главу, прежде чем двигаться дальше.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Пожалуйста кавычки-ёлочки здесь (я не уверен, сделает ли их сайт автоматом)


## Как отрисовать элемент в DOM {#rendering-an-element-into-the-dom}

Expand All @@ -34,7 +34,7 @@ const element = <h1>Hello, world</h1>;

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

Чтобы отрисовать React-элемент в корневой узел DOM, передайте их в качестве параметров в `ReactDOM.render()`:
Чтобы отрисовать React-элемент в корневой узел DOM, вызовите `ReactDOM.render()` с React-элементом и корневым DOM узлом в качестве аргументов:

`embed:rendering-elements/render-an-element.js`

Expand All @@ -44,32 +44,32 @@ const element = <h1>Hello, world</h1>;

## Обновление отрисованных элементов {#updating-the-rendered-element}

Элементы React [неизменяемы](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). После создания элемента, нельзя изменить его потомков или аттрибуты. Элемент похож на единичный кадр в фильме: он отразает состояние интерфейса в конкретный момент времени.
Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). После создания элемента, нельзя изменить его потомков или аттрибуты. Элемент похож на единичный кадр в фильме: он отразает состояние интерфейса в конкретный момент времени.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). После создания элемента, нельзя изменить его потомков или аттрибуты. Элемент похож на единичный кадр в фильме: он отразает состояние интерфейса в конкретный момент времени.
Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). После создания элемента, нельзя изменить его потомков или атрибуты. Элемент похож на единичный кадр в фильме: он отражает состояние интерфейса в конкретный момент времени.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

«Единичный» звучит странно, синоним попроще?


Как нам теперь известно, единственный способ обновить интерфейс — это создать новый элемент и передать его в `ReactDOM.render()`.
Пока что, мы знаем только один способ обновить интерфейс — это создать новый элемент и передать его в `ReactDOM.render()`.

Рассмотрим пример с часами:

`embed:rendering-elements/update-rendered-element.js`

[](codepen://rendering-elements/update-rendered-element)

В примере выше `ReactDOM.render()` вызывается каждую секунду с помощью коллбека [`setInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setInterval)
В примере выше `ReactDOM.render()` вызывается каждую секунду с помощью колбэка [`setInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setInterval)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

«В этом примере»


>**Заметка:**
>**Примечание:**
>
>На практике, большинство React-приложений вызывают `ReactDOM.render()` только один раз. В следующем разделе вы узнаете как создать [компонент с состоянием](/docs/state-and-lifecycle.html).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
>На практике, большинство React-приложений вызывают `ReactDOM.render()` только один раз. В следующем разделе вы узнаете как создать [компонент с состоянием](/docs/state-and-lifecycle.html).
>На практике большинство React-приложений вызывают `ReactDOM.render()` только один раз. В следующем разделе вы узнаете, как создать [компонент с состоянием](/docs/state-and-lifecycle.html).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тут теряется логическая связь предложений. Непонятно, при чем тут компонент с состоянием.

>
>Мы рекомендуем не пропускать разделы, поскольку в них используется информация из предыдущих разделов.

## React обновляет только то, что необходимо {#react-only-updates-whats-necessary}

React DOM сравнивает элемент и его потомков с предыдущим состоянием и делает только те изменения в DOM, которые необходимы для приведения элемента в новое состояние.
React DOM сравнивает элемент и его потомков с отображаемым на странице и вносит в DOM только те изменения, которые необходимы, чтобы на странице оказался новый элемент.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Можно «с предыдущей версией» или что-то ещё, чтобы избежать некорректного вывода что реакт сравнивает с DOM?


Вы можете увидеть это, рассмотрев [последний пример](codepen://rendering-elements/update-rendered-element) с помощью инструментов разработчика в браузере:
Вы можете убедиться в этом на [последнем примере](codepen://rendering-elements/update-rendered-element) с помощью инструментов разработчика в браузере:

![В DOM видно частичное обновление](../images/docs/granular-dom-updates.gif)

Несмотря на то, что мы создаем элемент, описывающий все дерево пользовательского интерфейса, каждую секунду, React DOM изменяет только текстовый узел, содержимое которого изменилось.
Несмотря на то, что мы создаем элемент, описывающий все дерево пользовательского интерфейса, каждую секунду React DOM изменяет только текстовый узел, содержимое которого изменилось.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

«Дерево пользовательского интерфейса» очень длинно. Предлагаю UI-дерево. У нас UI будет часто встречаться.


Согласно нашему опыту, удаётся избежать многих ошибок, если думать о том, как должен выглядеть интерфейс в каждый конкретный момент времени, а не о том, как его изменять.
Наш опыт подсказывает, что при реализации изменений в интерфейсе возникает много ошибок. Их можно избежать, если думать о том, как должно выглядеть приложение, а не как внести изменения.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Это непонятно. «Реализация изменений в интерфейсе» это во-первых три существительных, а во-вторых кажется что речь про изменение кода.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Предлагаю:

Наш опыт подсказывает, что можно избежать целого класса ошибок, описывая, как интерфейс выглядит в конкретный момент — а не как он изменяется с течением времени.