You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/composition-vs-inheritance.md
+30-30Lines changed: 30 additions & 30 deletions
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,22 @@
1
1
---
2
2
id: composition-vs-inheritance
3
-
title: Composition vs Inheritance
3
+
title: Композиция против наследования
4
4
permalink: docs/composition-vs-inheritance.html
5
5
redirect_from:
6
6
- "docs/multiple-components.html"
7
7
prev: lifting-state-up.html
8
8
next: thinking-in-react.html
9
9
---
10
10
11
-
React has a powerful composition model, and we recommend using composition instead of inheritance to reuse code between components.
11
+
React имеет мощную модель композиции, поэтому для переиспользования кода между компонентами мы рекомендуем использовать композицию вместо наследования.
12
12
13
-
In this section, we will consider a few problems where developers new to React often reach for inheritance, and show how we can solve them with composition.
13
+
В этой главе мы рассмотрим несколько проблем, которые новички в React решают наследованием и попробуем решить их с помощью композиции.
14
14
15
-
## Containment {#containment}
15
+
## Вставка {#containment}
16
16
17
-
Some components don't know their children ahead of time. This is especially common for components like`Sidebar`or`Dialog` that represent generic "boxes".
17
+
Некоторые компоненты не знают своих потомков заранее. Это особенно характерно для таких компонентов, как`Sidebar`или`Dialog`, которые представляют из себя как бы «коробку», в которую можно что-то положить.
18
18
19
-
We recommend that such components use the special`children` prop to pass children elements directly into their output:
19
+
Для таких компонентов мы рекомендуем использовать специальный проп`children`, который передаст дочерние элементы сразу на вывод:
20
20
21
21
```js{4}
22
22
function FancyBorder(props) {
@@ -28,28 +28,28 @@ function FancyBorder(props) {
28
28
}
29
29
```
30
30
31
-
This lets other components pass arbitrary children to them by nesting the JSX:
31
+
Это позволит передать компоненту произвольные дочерние элементы, вложив их в JSX:
32
32
33
33
```js{4-9}
34
34
function WelcomeDialog() {
35
35
return (
36
36
<FancyBorder color="blue">
37
37
<h1 className="Dialog-title">
38
-
Welcome
38
+
Добро пожаловать
39
39
</h1>
40
40
<p className="Dialog-message">
41
-
Thank you for visiting our spacecraft!
41
+
Спасибо, что посетили наш космический корабль!
42
42
</p>
43
43
</FancyBorder>
44
44
);
45
45
}
46
46
```
47
47
48
-
**[Try it on CodePen](https://codepen.io/gaearon/pen/ozqNOV?editors=0010)**
48
+
**[Посмотреть на CodePen](https://codepen.io/gaearon/pen/ozqNOV?editors=0010)**
49
49
50
-
Anything inside the `<FancyBorder>` JSX tag gets passed into the `FancyBorder`component as a `children` prop. Since`FancyBorder`renders`{props.children}`inside a `<div>`, the passed elements appear in the final output.
50
+
Всё, что находится внутри JSX-тега `<FancyBorder>`, передаётся в компонент `FancyBorder`через проп `children`. Поскольку`FancyBorder`рендерит`{props.children}`внутри `<div>`, все переданные элементы отображаются в конечном выводе.
51
51
52
-
While this is less common, sometimes you might need multiple "holes" in a component. In such cases you may come up with your own convention instead of using`children`:
52
+
Иногда в компоненте необходимо иметь несколько мест для вставки. В таком случае можно придумать свой формат, а не использовать`children`:
53
53
54
54
```js{5,8,18,21}
55
55
function SplitPane(props) {
@@ -78,15 +78,15 @@ function App() {
78
78
}
79
79
```
80
80
81
-
[**Try it on CodePen**](https://codepen.io/gaearon/pen/gwZOJp?editors=0010)
81
+
[**Посмотреть на CodePen**](https://codepen.io/gaearon/pen/gwZOJp?editors=0010)
82
82
83
-
React elements like `<Contacts />`and`<Chat />`are just objects, so you can pass them as props like any other data. This approach may remind you of "slots" in other libraries but there are no limitations on what you can pass as props in React.
83
+
Такие React-элементы, как `<Contacts />`и`<Chat />`являются просто объектами, поэтому их можно передать в виде пропсов, как и любые другие данные. Этот подход может напоминать понятие «слотов» в других библиотеках, однако, в React нет никаких ограничений на то, что можно передать в качестве пропсов.
84
84
85
-
## Specialization {#specialization}
85
+
## Специализация {#specialization}
86
86
87
-
Sometimes we think about components as being "special cases" of other components. For example, we might say that a `WelcomeDialog`is a special case of`Dialog`.
87
+
Некоторые компоненты можно рассматривать как «частные случаи» других компонентов. Например, `WelcomeDialog`может быть частным случаем`Dialog`.
88
88
89
-
In React, this is also achieved by composition, where a more "specific" component renders a more "generic" one and configures it with props:
89
+
В React это можно сделать через композицию, где «частный» вариант компонента рендерит более «общий» и настраивает его с помощью пропсов:
90
90
91
91
```js{5,8,16-18}
92
92
function Dialog(props) {
@@ -105,15 +105,15 @@ function Dialog(props) {
105
105
function WelcomeDialog() {
106
106
return (
107
107
<Dialog
108
-
title="Welcome"
109
-
message="Thank you for visiting our spacecraft!" />
108
+
title="Добро пожаловать"
109
+
message="Спасибо, что посетили наш космический корабль!" />
110
110
);
111
111
}
112
112
```
113
113
114
-
[**Try it on CodePen**](https://codepen.io/gaearon/pen/kkEaOZ?editors=0010)
114
+
[**Посмотреть на CodePen**](https://codepen.io/gaearon/pen/kkEaOZ?editors=0010)
115
115
116
-
Composition works equally well for components defined as classes:
116
+
Композиция хорошо работает и для компонентов, определённых через классы:
117
117
118
118
```js{10,27-31}
119
119
function Dialog(props) {
@@ -140,12 +140,12 @@ class SignUpDialog extends React.Component {
140
140
141
141
render() {
142
142
return (
143
-
<Dialog title="Mars Exploration Program"
144
-
message="How should we refer to you?">
143
+
<Dialog title="Программа исследования Марса"
144
+
message="Как к вам обращаться?">
145
145
<input value={this.state.login}
146
146
onChange={this.handleChange} />
147
147
<button onClick={this.handleSignUp}>
148
-
Sign Me Up!
148
+
Запишите меня!
149
149
</button>
150
150
</Dialog>
151
151
);
@@ -156,17 +156,17 @@ class SignUpDialog extends React.Component {
156
156
}
157
157
158
158
handleSignUp() {
159
-
alert(`Welcome aboard, ${this.state.login}!`);
159
+
alert(`Добро пожаловать на борт, ${this.state.login}!`);
160
160
}
161
161
}
162
162
```
163
163
164
-
[**Try it on CodePen**](https://codepen.io/gaearon/pen/gwZbYa?editors=0010)
164
+
[**Посмотреть на CodePen**](https://codepen.io/gaearon/pen/gwZbYa?editors=0010)
165
165
166
-
## So What About Inheritance? {#so-what-about-inheritance}
166
+
## Так что насчёт наследования? {#so-what-about-inheritance}
167
167
168
-
At Facebook, we use React in thousands of components, and we haven't found any use cases where we would recommend creating component inheritance hierarchies.
168
+
В Facebook мы используем React в тысячах компонентов, и не находили случаев, когда бы рекомендовали создавать иерархии наследования компонентов.
169
169
170
-
Props and composition give you all the flexibility you need to customize a component's look and behavior in an explicit and safe way. Remember that components may accept arbitrary props, including primitive values, React elements, or functions.
170
+
Пропсы и композиция дают вам всю гибкость, необходимую для настройки внешнего вида и поведения компонента явным и безопасным способом. Помните, что компоненты могут принимать произвольные пропсы, включая примитивные значения, React-элементы или функции.
171
171
172
-
If you want to reuse non-UI functionality between components, we suggest extracting it into a separate JavaScript module. The components may import it and use that function, object, or a class, without extending it.
172
+
Если вы хотите переиспользовать не связанную с внешним видом функциональность между компонентами, извлеките её в отдельный JavaScript-модуль. Импортируйте его в компонент и используйте эту функцию, объект или класс, не расширяя их.
React and [Web Components](https://developer.mozilla.org/en-US/docs/Web/Web_Components)are built to solve different problems. Web Components provide strong encapsulation for reusable components, while React provides a declarative library that keeps the DOM in sync with your data. The two goals are complementary. As a developer, you are free to use React in your Web Components, or to use Web Components in React, or both.
9
+
React и [веб-компоненты](https://developer.mozilla.org/ru/docs/Web/Web_Components)созданы для решения самых разных задач. Веб-компоненты обеспечивают надёжную инкапсуляцию для повторно используемых компонентов, в то время как React предоставляет декларативную библиотеку для синхронизации данных c DOM. Две цели дополняют друг друга. Как разработчик, вы можете использовать React в своих веб-компонентах, или использовать веб-компоненты в React, или и то, и другое.
10
10
11
-
Most people who use React don't use Web Components, but you may want to, especially if you are using third-party UI components that are written using Web Components.
11
+
Большинство разработчиков React обходятся без веб-компонентов, но у вас может появиться желание попробовать их. Например, если ваш проект использует сторонние компоненты пользовательского интерфейса, написанные с помощью веб-компонентов.
12
12
13
-
## Using Web Components in React {#using-web-components-in-react}
13
+
## Использование веб-компонентов в React {#using-web-components-in-react}
> Web Components often expose an imperative API. For instance, a`video`Web Component might expose `play()`and`pause()` functions. To access the imperative APIs of a Web Component, you will need to use a ref to interact with the DOM node directly. If you are using third-party Web Components, the best solution is to write a React component that behaves as a wrapper for your Web Component.
25
+
> Веб-компоненты часто предоставляют императивный API. Например, веб-компонент`video`может предоставлять функции `play()`и`pause()`. Чтобы получить доступ к необходимому API веб-компонентов, необходимо использовать реф для взаимодействия с DOM-узлом напрямую. Если вы используете сторонние веб-компоненты, лучшим решением будет создать React-компонент и использовать его как обёртку для веб-компонента.
26
26
>
27
-
> Events emitted by a Web Component may not properly propagate through a React render tree.
28
-
> You will need to manually attach event handlers to handle these events within your React components.
27
+
> События, созданные веб-компонентами, могут неправильно распостраняться через дерево React-компонентов.
28
+
> Вам нужно вручную добавить обработчики для таких событий в собственные React-компоненты.
29
29
30
-
One common confusion is that Web Components use "class" instead of "className".
30
+
Одно из распространённых заблуждений — это то, что в веб-компонентах используется «class» вместо «className».
31
31
32
32
```javascript
33
33
functionBrickFlipbox() {
34
34
return (
35
35
<brick-flipbox class="demo">
36
-
<div>front</div>
37
-
<div>back</div>
36
+
<div>Передняя сторона</div>
37
+
<div>Обратная сторона</div>
38
38
</brick-flipbox>
39
39
);
40
40
}
41
41
```
42
42
43
-
## Using React in your Web Components {#using-react-in-your-web-components}
43
+
## Использование React в веб-компонентах {#using-react-in-your-web-components}
44
44
45
45
```javascript
46
46
classXSearchextendsHTMLElement {
@@ -56,7 +56,7 @@ class XSearch extends HTMLElement {
56
56
customElements.define('x-search', XSearch);
57
57
```
58
58
59
-
>Note:
59
+
>Примечание:
60
60
>
61
-
>This code**will not**work if you transform classes with Babel. See [this issue](https://github.com/w3c/webcomponents/issues/587)for the discussion.
62
-
>Include the[custom-elements-es5-adapter](https://github.com/webcomponents/webcomponentsjs#custom-elements-es5-adapterjs)before you load your web components to fix this issue.
61
+
>Данный код**не будет**работать, если вы преобразуете классы с помощью Babel. Взгляните на [ишью](https://github.com/w3c/webcomponents/issues/587)с обсуждением.
62
+
>Добавьте шим[custom-elements-es5-adapter](https://github.com/webcomponents/webcomponentsjs#custom-elements-es5-adapterjs)перед загрузкой веб-компонентов, чтобы решить эту проблему.
0 commit comments