Компоненты Vue.js

Компоненты — одна из самых мощных возможностей Vue.js.

Компоненты могут расширять HTML-элементы и инкапсулировать повторно используемый код.

Система компонентов позволяет нам строить большие приложения из независимых, повторно используемых небольших компонентов. Почти любой тип интерфейса приложения можно абстрагировать в дерево компонентов:

Синтаксис регистрации глобального компонента выглядит следующим образом:

Vue.component(tagName, options)

tagName — это имя компонента, а options — параметры конфигурации. После регистрации мы можем вызвать компонент следующим образом:

<tagName></tagName>

Глобальный компонент

Все экземпляры могут использовать глобальные компоненты.

Пример глобального компонента

Зарегистрируйте простой глобальный компонент 'example' и используйте его:

<div id="app"> <example></example> </div> <script>// Регистрация Vue.component('example', { template: '<h1>Пользовательский компонент!</h1>' }) // Создать корневой экземпляр new Vue({ el: '#app' })</script>

Попробуйте »

Локальный компонент

Мы также можем зарегистрировать локальные компоненты в опциях экземпляра, чтобы компонент можно было использовать только в этом экземпляре:

Пример локального компонента

Зарегистрируйте простой локальный компонент 'example' и используйте его:

<div id="app"> <example></example> </div> <script> var Child = { template: '<h1>Пользовательский компонент!</h1>' } // Создать корневой экземпляр new Vue({ el: '#app', components: { //<example>будет доступен только в родительском шаблоне 'example': Child } })</script>

Попробуйте »

Проп

Проп — это пользовательский атрибут, используемый дочерними компонентами для приёма данных, переданных от родительских компонентов.

Родительский компонент должен передавать данные дочернему компоненту через props, а дочерний компонент должен явно объявить "prop" с помощью опции props:

Пример prop

<div id="app"> <child message="привет!"></child> </div> <script>// Регистрация Vue.component('child', { // Объявление props props: ['message'], // Также может использоваться в экземпляре vm как "this.message" template: '<span>{{ message }}</span>' }) // Создание корневого экземпляра new Vue({ el: '#app' })</script>

Попробуйте »

Динамический prop

Подобно использованию v-bind для привязки HTML-атрибутов к выражению, вы также можете использовать v-bind для динамической привязки значений prop к данным родительского компонента. Всякий раз, когда данные родительского компонента изменяются, изменение также передаётся дочернему компоненту:

Пример prop

<div id="app"> <div> <input v-model="parentMsg"> <br> <child v-bind:message="parentMsg"></child> </div> </div> <script>// Регистрация Vue.component('child', { // Объявление props props: ['message'], // Также может использоваться в экземпляре vm как "this.message" template: '<span>{{ message }}</span>' }) // Создание корневого экземпляра new Vue({ el: '#app', data: { parentMsg: 'Содержимое родительского компонента' } })</script>

Попробуйте »

В следующем примере директива v-bind используется для передачи todo каждому повторяющемуся компоненту:

Пример prop

<div id="app"> <ol> <todo-item v-for="item in sites" v-bind:todo="item"></todo-item> </ol> </div> <script> Vue.component('todo-item', { props: ['todo'], template: '<li>{{ todo.text }}</li>' }) new Vue({ el: '#app', data: { sites: [ { text: 'Example' }, { text: 'Google' }, { text: 'Taobao' } ] } }) </script>

Попробуйте »

Примечание: prop — это односторонняя привязка: когда свойства родительского компонента изменяются, они передаются дочернему компоненту, но не наоборот.

Проверка prop

Компоненты могут задавать требования проверки для props.

Чтобы настроить метод проверки для props, можно вместо массива строк указать объект с требованиями проверки для значений в props. Например:

Vue.component('my-component', {
  props: {
    // 基础的类型检查 (`null` 和 `undefined` 会通过任何类型验证)
    propA: Number,
    // 多个可能的类型
    propB: [String, Number],
    // 必填的字符串
    propC: {
      type: String,
      required: true
    },
    // 带有默认值的数字
    propD: {
      type: Number,
      default: 100
    },
    // 带有默认值的对象
    propE: {
      type: Object,
      // 对象或数组默认值必须从一个工厂函数获取
      default: function () {
        return { message: 'hello' }
      }
    },
    // 自定义验证函数
    propF: {
      validator: function (value) {
        // 这个值必须匹配下列字符串中的一个
        return ['success', 'warning', 'danger'].indexOf(value) !== -1
      }
    }
  }
})

Если проверка prop не проходит, Vue (в сборке для разработки) выведет предупреждение в консоль.

type может быть одним из следующих нативных конструкторов:

  • String
  • Number
  • Boolean
  • Array
  • Object
  • Date
  • Function
  • Symbol

type также может быть пользовательским конструктором, определяемым с помощью instanceof.

Другие расширения