Composants Vue.js

Les composants sont l'une des fonctionnalités les plus puissantes de Vue.js.

Les composants peuvent étendre les éléments HTML et encapsuler du code réutilisable.

Le système de composants nous permet de construire de grandes applications en utilisant de petits composants indépendants et réutilisables. Presque tout type d'interface d'application peut être abstrait en un arbre de composants :

La syntaxe d'enregistrement d'un composant global est la suivante :

Vue.component(tagName, options)

tagName est le nom du composant, et options sont les options de configuration. Après l'enregistrement, nous pouvons utiliser la manière suivante pour appeler le composant :

<tagName></tagName>

Composant global

Toutes les instances peuvent utiliser des composants globaux.

Exemple de composant global

Enregistrer un composant global simple 'example' et l'utiliser :

<div id="app"> <example></example> </div> <script>// Enregistrer Vue.component('example', { template: '<h1>Composant personnalisé !</h1>' }) // Créer l'instance racine new Vue({ el: '#app' })</script>

Essayez-le »

Composant local

Nous pouvons également enregistrer des composants locaux dans les options de l'instance, afin que le composant ne puisse être utilisé que dans cette instance :

Exemple de composant local

Enregistrez un composant local simple 'example' et utilisez-le :

<div id="app"> <example></example> </div> <script> var Child = { template: '<h1>Composant personnalisé !</h1>' } // Créer l'instance racine new Vue({ el: '#app', components: { //<example>ne sera disponible que dans le template parent 'example': Child } })</script>

Essayez-le »

Prop

prop est un attribut personnalisé utilisé par les composants enfants pour accepter les données transmises par les composants parents.

Le composant parent doit transmettre des données au composant enfant via des props, et le composant enfant doit déclarer explicitement "prop" à l'aide de l'option props :

Exemple de prop

<div id="app"> <child message="Bonjour !"></child> </div> <script>// Enregistrer Vue.component('child', { // Déclarer les props props: ['message'], // Il peut aussi être utilisé dans l'instance vm comme "this.message" template: '<span>{{ message }}</span>' }) // Créer l'instance racine new Vue({ el: '#app' })</script>

Essayez-le »

Prop dynamique

Comme lorsque vous utilisez v-bind pour lier des attributs HTML à une expression, vous pouvez également utiliser v-bind pour lier dynamiquement des valeurs de prop aux données du composant parent. Chaque fois que les données du composant parent changent, la modification est également transmise au composant enfant :

Exemple de prop

<div id="app"> <div> <input v-model="parentMsg"> <br> <child v-bind:message="parentMsg"></child> </div> </div> <script>// Enregistrer Vue.component('child', { // Déclarer les props props: ['message'], // Il peut aussi être utilisé dans l'instance vm comme "this.message" template: '<span>{{ message }}</span>' }) // Créer l'instance racine new Vue({ el: '#app', data: { parentMsg: 'Contenu du composant parent' } })</script>

Essayez-le »

Dans l'exemple suivant, la directive v-bind est utilisée pour transmettre le todo à chaque composant répété :

Exemple de 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>

Essayez-le »

Remarque : prop est une liaison unidirectionnelle : lorsque les propriétés du composant parent changent, elles sont transmises au composant enfant, mais pas l'inverse.

Validation des props

Les composants peuvent spécifier des exigences de validation pour les props.

Pour personnaliser la méthode de validation des props, vous pouvez fournir un objet avec des exigences de validation pour les valeurs des props, au lieu d'un tableau de chaînes. Par exemple :

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
      }
    }
  }
})

Lorsque la validation de prop échoue, Vue (dans la version de développement) produira un avertissement dans la console.

type peut être l'un des constructeurs natifs suivants :

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

type peut également être un constructeur personnalisé, détecté à l'aide de instanceof.

Autres extensions