Skip to content

Commit 7a614c1

Browse files
committed
Options / Misc copyediting
1 parent ac0311d commit 7a614c1

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

src/api/index.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -742,23 +742,23 @@ type: api
742742

743743
### parent
744744

745-
- **Тип:** `Vue instance`
745+
- **Тип:** `инстанс Vue`
746746

747747
- **Подробности:**
748748

749-
Указывает родительский инстанс для создаваемого. Устанавливает отношение "родитель-ребёнок" между ними. Родительский элемент будет доступен для дочернего через `this.$parent`, а дочерний элемент будет дабавлен в массив `$children` родителя.
749+
Указывает новому инстансу на родительский и устанавливает отношение "родитель-ребёнок" между ними. Родительский элемент будет доступен дочернему в `this.$parent`, а дочерний элемент будет добавлен в массив `$children` родителя.
750750

751-
<p class="tip">Use `$parent` and `$children` sparringly - they mostly serve as an escape-hatch. Prefer using props and events for parent-child communication.</p>
751+
<p class="tip">Старайтесь реже использовать `$parent` и `$children` - этот механизм мы предусмотрели на крайний случай. Для общения между родителем и ребёнком лучше использовать свойства и события.</p>
752752

753753
### mixins
754754

755755
- **Тип:** `Array<Object>`
756756

757757
- **Подробности:**
758758

759-
Опция `mixins` принимает массив объектов-примесей. Примеси могут содержать точно такие же опции, как и обычные объекты инстансов Vue, и они будут слиты с основными опциями по той же логике, что и при использовании `Vue.extend()`. Например, если и примесь и объект оба содержат хук `created`, вызваны будут обе функции.
759+
Массив объектов-миксинов. Миксины могут содержать те же опции, что и обычные объекты инстансов Vue они будут добавлены к основным опциям согласно логике `Vue.extend()`. Например, если и миксин и объект оба содержат хук `created`, вызваны будут они оба.
760760

761-
Хуки примесей вызываются в порядке их определения, перед вызовом собственных хуков компонента.
761+
Хуки миксинов вызываются в порядке их определения, до вызова собственных хуков компонента.
762762

763763
- **Пример:**
764764

@@ -774,7 +774,7 @@ type: api
774774
// -> 2
775775
```
776776

777-
- **См. также:** [Mixins](/guide/mixins.html)
777+
- **См. также:** [Миксины](/guide/mixins.html)
778778

779779
### name
780780

@@ -784,26 +784,26 @@ type: api
784784

785785
- **Подробности:**
786786

787-
Позволяет компоненту рекурсивно вызывать самого себя в шаблоне. Обратите внимание что когда компонент регистрируется глобально посредством `Vue.component()`, глобальный ID автоматически устанавливается равным его имени.
787+
Название компонента. Позволяет компоненту рекурсивно вызывать самого себя в шаблоне. Обратите внимание что когда компонент регистрируется глобально посредством `Vue.component()`, глобальный ID автоматически становится таким же, как и имя.
788788

789-
Другое преимущество указания опции `name` проявляется в отладке. Именованние компонент приводит к более понятным предупреждающим сообщениям. Также, при использовании [vue-devtools](https://github.com/vuejs/vue-devtools) безымянные компоненты отображаются как `<AnonymousComponent>`, что не очень информативно. Указывая опцию `name`, вы получите значительно более информативное дерево компонент.
789+
Кроме того, компоненты с указанным `name` проще отлаживать из-за более понятных сообщений в консоли. В [vue-devtools](https://github.com/vuejs/vue-devtools) все безымянные компоненты довольно неинформативно называются `<AnonymousComponent>`. Когда у компонентов указано `name`, дерево компонентов становится куда понятнее.
790790

791791
### extends
792792

793793
- **Тип:** `Object | Function`
794794

795795
- **Подробности:**
796796

797-
Позволяет декларативно наследоваться от другого компонента (может быть либо простым объектом, либо конструктором), не используя `Vue.extend`. Главным образом предназначено для облегчения наследования между компонентами, хранимыми в единых файлах.
797+
Позволяет декларативно наследоваться от другого компонента (который может быть либо простым объектом, либо конструктором), не используя `Vue.extend`. Главным образом предназначено для облегчения наследования между компонентами, определёнными в одном файле.
798798

799-
Эта функциональность близка к `mixins`, с разницей в том, что собственные опции компонента имеют высший приоритет над опциями компонента, от которого происходит наследование.
799+
Эта функциональность близка к `mixins`, с той разницей, что собственные опции компонента приоритетнее опций компонента, от которого происходит наследование.
800800

801801
- **Пример:**
802802

803803
``` js
804804
var CompA = { ... }
805805

806-
// наследование от CompA без необходимость вызывать Vue.extend ни в том ни в другом
806+
// наследуем от CompA, не вызывая Vue.extend:
807807
var CompB = {
808808
extends: CompA,
809809
...
@@ -818,16 +818,16 @@ type: api
818818

819819
- **Подробности:**
820820

821-
Изменяет маркеры, выделяющие текст для интерполяции. **Доступно только в автономной сборке.**
821+
Маркеры, выделяющие текст для интерполяции. **Доступно только в автономной сборке.**
822822

823823
- **Пример:**
824824

825825
``` js
826+
// меняем маркеры в шаблонах на свойственные ES6:
827+
826828
new Vue({
827829
delimiters: ['${', '}']
828830
})
829-
830-
// Маркеры в шаблонах изменены на стиль ES6
831831
```
832832

833833
### functional
@@ -836,9 +836,9 @@ type: api
836836

837837
- **Подробности:**
838838

839-
Превращает компонент в stateless (не имеющий `data`) и instanceless (без контекста `this`). Такие компоненты представляют собой попросту функцию `render`, которая возвращает узлы Virtual DOM, делая рендеринг значительно дешевле.
839+
Превращает компонент в функциональный, то есть не имеющий собственного состояния (`data`) и своего инстанса (`this`). Такие компоненты по сути — просто функция `render`, возвращающая узлы виртуального DOM. Это сильно ускоряет их рендер.
840840

841-
- **См. также:** [Функциональные Компоненты](/guide/render-function.html#Functional-Components)
841+
- **См. также:** [Функциональные компоненты](/guide/render-function.html#Functional-Components)
842842

843843
## Instance Properties
844844

0 commit comments

Comments
 (0)