Skip to content

Commit

Permalink
Merge pull request #503 from GeorgeShvab/uk-translation-hydrate
Browse files Browse the repository at this point in the history 
Finished translation of hydrate page
  • Loading branch information
@alinkedd
alinkedd authored Dec 24, 2023
2 parents 1722242 + bc17644 commit 3233c06
Showing 1 changed file with 44 additions and 44 deletions.
88 changes: 44 additions & 44 deletions src/content/reference/react-dom/hydrate.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ title: hydrate

<Deprecated>

This API will be removed in a future major version of React.
Цей API буде виключено з майбутньої основної версії React.

In React 18, `hydrate` was replaced by [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot) Using `hydrate` in React 18 will warn that your app will behave as if it’s running React 17. Learn more [here.](/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis)
У React 18 `hydrate` був замінений на [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot) Використання `hydrate` у React 18 викличе попередження, що ваш застосунок буде поводитися так, наче використовує React 17. Дізнайтеся більше [тут.](/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis)

</Deprecated>

<Intro>

`hydrate` lets you display React components inside a browser DOM node whose HTML content was previously generated by [`react-dom/server`](/reference/react-dom/server) in React 17 and below.
`hydrate` дозволяє відображати React-компоненти всередині браузерного DOM-вузла, HTML-вміст якого був попередньо згенерований, використовуючи [`react-dom/server`](/reference/react-dom/server) з React 17 чи ранішої версії.

```js
hydrate(reactNode, domNode, callback?)
Expand All @@ -24,66 +24,66 @@ hydrate(reactNode, domNode, callback?)
---
## Reference {/*reference*/}
## Опис {/*reference*/}
### `hydrate(reactNode, domNode, callback?)` {/*hydrate*/}
Call `hydrate` in React 17 and below to “attach” React to existing HTML that was already rendered by React in a server environment.
Викличте `hydrate` у React 17 і раніших версіях, щоб "прикріпити" React до наявного HTML, який попередньо був відрендерений у серверному середовищі.
```js
import { hydrate } from 'react-dom';

hydrate(reactNode, domNode);
```
React will attach to the HTML that exists inside the `domNode`, and take over managing the DOM inside it. An app fully built with React will usually only have one `hydrate` call with its root component.
React прикріпиться до HTML, що знаходиться всередині `domNode`, і візьме на себе управління DOM у ньому. Застосунок, повністю створений за допомогою React, зазвичай матиме тільки один виклик `hydrate` у кореневому компоненті.
[See more examples below.](#usage)
[Перегляньте більше прикладів нижче.](#usage)
#### Parameters {/*parameters*/}
#### Параметри {/*parameters*/}
* `reactNode`: The "React node" used to render the existing HTML. This will usually be a piece of JSX like `<App />` which was rendered with a `ReactDOM Server` method such as `renderToString(<App />)` in React 17.
* `reactNode`: "React-вузол", який використовується для рендеру наявного HTML. Зазвичай це буде якийсь JSX, наприклад `<App />`, що був відрендерений методом `ReactDOM Server`, як-от `renderToString(<App />)` з React 17.
* `domNode`: A [DOM element](https://developer.mozilla.org/en-US/docs/Web/API/Element) that was rendered as the root element on the server.
* `domNode`: [DOM-елемент](https://developer.mozilla.org/en-US/docs/Web/API/Element), що був відрендерений як кореневий елемент на стороні сервера.
* **optional**: `callback`: A function. If passed, React will call it after your component is hydrated.
* **опційний**: `callback`: Функція. Якщо передана, React викличе її після гідрації вашого компонента.
#### Returns {/*returns*/}
#### Результат {/*returns*/}
`hydrate` returns null.
`hydrate` повертає null.
#### Caveats {/*caveats*/}
* `hydrate` expects the rendered content to be identical with the server-rendered content. React can patch up differences in text content, but you should treat mismatches as bugs and fix them.
* In development mode, React warns about mismatches during hydration. There are no guarantees that attribute differences will be patched up in case of mismatches. This is important for performance reasons because in most apps, mismatches are rare, and so validating all markup would be prohibitively expensive.
* You'll likely have only one `hydrate` call in your app. If you use a framework, it might do this call for you.
* If your app is client-rendered with no HTML rendered already, using `hydrate()` is not supported. Use [render()](/reference/react-dom/render) (for React 17 and below) or [createRoot()](/reference/react-dom/client/createRoot) (for React 18+) instead.
#### Застереження {/*caveats*/}
* `hydrate` очікує, що відрендерений вміст має бути ідентичним до того, який би відрендерив сервер. React може виправляти розбіжності у тексті, але вам слід сприймати невідповідності як помилки та виправляти їх cамі.
* У режимі розробки React попереджає про розбіжності під час гідрації. Немає жодних гарантій, що різниця в атрибутах буде виправлена у випадку розбіжностей. Це важливо для швидкодії, оскільки у більшості застосунків розбіжності трапляються рідко, валідація всієї розмітки була б занадто витратною.
* Ви переважно будете викликати `hydrate` лише один раз. Якщо ви використовуєте фреймворк, він може робити це за вас.
* Якщо ваш застосунок рендериться на стороні клієнта без попередньо відрендереного HTML, використання `hydrate()` не підтримується. Використовуйте [render()](/reference/react-dom/render) (для React 17 і раніших версій) або [createRoot()](/reference/react-dom/client/createRoot) (для React 18+) натомість.
---
## Usage {/*usage*/}
## Використання {/*usage*/}
Call `hydrate` to attach a <CodeStep step={1}>React component</CodeStep> into a server-rendered <CodeStep step={2}>browser DOM node</CodeStep>.
Викличте `hydrate`, щоб прикріпити <CodeStep step={1}>React-компонент</CodeStep> до відрендереного на стороні сервера <CodeStep step={2}>браузерного DOM-вузла</CodeStep>.
```js [[1, 3, "<App />"], [2, 3, "document.getElementById('root')"]]
import { hydrate } from 'react-dom';

hydrate(<App />, document.getElementById('root'));
```
Using `hydrate()` to render a client-only app (an app without server-rendered HTML) is not supported. Use [`render()`](/reference/react-dom/render) (in React 17 and below) or [`createRoot()`](/reference/react-dom/client/createRoot) (in React 18+) instead.
Використання `hydrate()` для рендеру повністю клієнтського застосунку (застосунок без HTML, що рендериться на стороні сервера) не підтримується. Використовуйте [`render()`](/reference/react-dom/render) (для React 17 і раніших версій) або [`createRoot()`](/reference/react-dom/client/createRoot) (для React 18+) натомість.
### Hydrating server-rendered HTML {/*hydrating-server-rendered-html*/}
### Гідрація відрендереного сервером HTML {/*hydrating-server-rendered-html*/}
In React, "hydration" is how React "attaches" to existing HTML that was already rendered by React in a server environment. During hydration, React will attempt to attach event listeners to the existing markup and take over rendering the app on the client.
У React "гідрація" — це те, як React "прикріплюється" до наявного HTML, попередньо відрендереного у серверному середовищі за допомогою React. Під час гідрації React спробує додати слухачі подій до наявної розмітки та взяти на себе рендеринг застосунку на стороні клієнта.
In apps fully built with React, **you will usually only hydrate one "root", once at startup for your entire app**.
У застосунках, повністю створених за допомогою React, **ви зазвичай гідруватиме лише один "корінь" один раз під час запуску всього вашого застосунку**.
<Sandpack>
```html public/index.html
<!--
HTML content inside <div id="root">...</div>
was generated from App by react-dom/server.
Вміст HTML усередині <div id="root">...</div>
був згенерований, починаючи з компонента App, за допомогою react-dom/server.
-->
<div id="root"><h1>Hello, world!</h1></div>
```
Expand All @@ -104,26 +104,26 @@ export default function App() {
</Sandpack>
Usually you shouldn't need to call `hydrate` again or to call it in more places. From this point on, React will be managing the DOM of your application. To update the UI, your components will [use state.](/reference/react/useState)
Зазвичай ви не повинні викликати `hydrate` знову або в інших місцях також. З цього моменту React буде керувати DOM вашого застосунку. Щоб оновлювати UI, ваші компоненти [використовуватимуть стан.](/reference/react/useState)
For more information on hydration, see the docs for [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot)
Щоб отримати більше інформації про гідрацію, перегляньте документацію [`hydrateRoot`.](/reference/react-dom/client/hydrateRoot)
---
### Suppressing unavoidable hydration mismatch errors {/*suppressing-unavoidable-hydration-mismatch-errors*/}
### Приховування неминучих помилок розбіжності під час гідрації {/*suppressing-unavoidable-hydration-mismatch-errors*/}
If a single element’s attribute or text content is unavoidably different between the server and the client (for example, a timestamp), you may silence the hydration mismatch warning.
Якщо атрибут або текстовий вміст хоча б одного елемента неминуче відрізняється на стороні сервера та клієнта (наприклад, часова мітка), ви можете приховати попередження про розбіжності під час гідрації.
To silence hydration warnings on an element, add `suppressHydrationWarning={true}`:
Щоб приховати гідраційні попередження в елементі, додайте `suppressHydrationWarning={true}`:
<Sandpack>
```html public/index.html
<!--
HTML content inside <div id="root">...</div>
was generated from App by react-dom/server.
Вміст HTML усередині <div id="root">...</div>
був згенерований, починаючи з компонента App, за допомогою react-dom/server.
-->
<div id="root"><h1>Current Date: 01/01/2020</h1></div>
<div id="root"><h1>Поточна дата: 01/01/2020</h1></div>
```
```js src/index.js
Expand All @@ -138,30 +138,30 @@ hydrate(<App />, document.getElementById('root'));
export default function App() {
return (
<h1 suppressHydrationWarning={true}>
Current Date: {new Date().toLocaleDateString()}
Поточна дата: {new Date().toLocaleDateString()}
</h1>
);
}
```
</Sandpack>
This only works one level deep, and is intended to be an escape hatch. Don’t overuse it. Unless it’s text content, React still won’t attempt to patch it up, so it may remain inconsistent until future updates.
Це працює лише на один рівень вглиб і створено як запасний варіант. Не використовуйте його занадто часто. Якщо це не текстовий вміст, React не намагатиметься виправити розбіжність, тож вона може залишитися до майбутніх оновлень стану.
---
### Handling different client and server content {/*handling-different-client-and-server-content*/}
### Робота з вмістом, що різниться на стороні клієнта та сервера {/*handling-different-client-and-server-content*/}
If you intentionally need to render something different on the server and the client, you can do a two-pass rendering. Components that render something different on the client can read a [state variable](/reference/react/useState) like `isClient`, which you can set to `true` in an [effect](/reference/react/useEffect):
Якщо вам потрібно відрендерити різний вміст на стороні сервера та клієнта, ви можете зробити двоетапний рендеринг. Компоненти, які рендерять щось інше на стороні клієнта, можуть використовувати [змінну стану](/reference/react/useState), наприклад `isClient`, яку ви можете змінити на `true` в [ефекті](/reference/react/useEffect):
<Sandpack>
```html public/index.html
<!--
HTML content inside <div id="root">...</div>
was generated from App by react-dom/server.
Вміст HTML усередині <div id="root">...</div>
був згенерований, починаючи з компонента App, за допомогою react-dom/server.
-->
<div id="root"><h1>Is Server</h1></div>
<div id="root"><h1>Це сервер</h1></div>
```
```js src/index.js
Expand All @@ -184,18 +184,18 @@ export default function App() {

return (
<h1>
{isClient ? 'Is Client' : 'Is Server'}
{isClient ? 'Це клієнт' : 'Це сервер'}
</h1>
);
}
```
</Sandpack>
This way the initial render pass will render the same content as the server, avoiding mismatches, but an additional pass will happen synchronously right after hydration.
Отже, початковий рендер відрендерить вміст такий же, як і на стороні сервера, уникаючи розбіжностей, однак, синхронно й одразу після гідрації відбудеться додатковий рендер.
<Pitfall>
This approach makes hydration slower because your components have to render twice. Be mindful of the user experience on slow connections. The JavaScript code may load significantly later than the initial HTML render, so rendering a different UI immediately after hydration may feel jarring to the user.
Цей підхід сповільнює процес гідрації, тому що ваші компоненти рендеряться двічі. Пам'ятайте про досвід користувача у разі повільного з'єднання. JavaScript-код може завантажитися значно пізніше, ніж відрендериться початковий HTML, тому рендер іншого UI одразу після гідрації може відчуватися для користувача різким.
</Pitfall>

0 comments on commit 3233c06

Please sign in to comment.