Vue.js

Vue.js : Créer un composant

Vous connaissez peut-être les Web Components. C’est un nouveau standard qui permet d’enrichir le HTML de façon modulaire. En gros on peut créer une entité qui utilise des éléments HTML et des fonctionnalités propres, le tout facile à intégrer avec une simple balise personnalisée. On peut espérer que ce standard réduira la prolifération des widgets Javascript et engendrera une certaine homogénéité. Ce qui est certain c’est que le HTML est plutôt limité et ne propose que des éléments simples, on aimerait disposer d’info-bulles, de menus… Mais on est encore loin du but, vous pouvez lire cet excellent article qui résume la situation.

On va voir dans cet article que vue.js propose une approche simple et efficace très fortement inspirée de polymer avec comme grande différence qu’au niveau de la machinerie il est fait appel exclusivement aux dernières possibilités des web components, ce qui améliore les performances.

Mon premier composant

Alors on se lance et on crée un petit composant. Au niveau du Javascript c’est tout simple :

Vue.component('mon-composant', {
  template: '<p>Mon premier composant !</p>'
});

La méthode component crée le composant dont on précise le nom (mon-composant) et le template. C’est vraiment le minimum pour un composant ! Il faut aussi initialiser la VueModèle comme d’habitude :

new Vue({
  el: '#tuto'
});

Ensuite on utilise la balise personnalisée dans le HTML :

<div id="tuto">
  <mon-composant></mon-composant>
</div>

Avec ce résultat :

Mon premier composant !

Bon pour le moment c’est très simple et on a vu qu’on pouvait réaliser cela dans l’article précédent avec une directive élément. Mais on va voir que les composants vont bien plus loin !

Une petite illustration du fonctionnement :

Passage de données

Passage d’une valeur

Créer un composant c’est bien mais tout ce qui se trouve à l’intérieur est isolé du reste du monde. Autrement dit le composant n’a accès à aucune donnée en dehors des siennes. Il arrive souvent qu’on ait besoin de transmettre des informations pour renseigner le composant. Voyons comment réaliser cela. On va ajouter une propriété au composant :

Vue.component('nom', {
  props: ['nom'],
  template: '<p>Mon nom est {{nom}}</p>'
});

Les props sont des champs pour lesquels le composant attend des valeurs. C’est un tableau, ici on a juste prévu la clé nom. Il ne reste plus qu’à renseigner cette clé dans le HTML :

<div id="tuto">
  <nom nom="Toto"></nom>
</div>

Ce qui donne au final :

Mon nom est Toto

Voici une schématisation du fonctionnement :

img07

camelCase

Les attributs HTML ne sont pas sensibles à la casses, majuscules ou minuscules ils digèrent tout ça indifféremment. Cela peut être un piège si vous utilisez la notation camelCase. Par exemple vous créez ce composant :

Vue.component('nom', {
  props: ['monNom'],
  template: '<p>Mon nom est {{monNom}}</p>'
});

Et vous utilisez ce HTML :

<nom monNom='Toto'></nom>

Mais tout ce que vous obtenez est :

Mon nom est

Pour obtenir le bon résultat il faut utiliser l’équivalent avec trait d’union (hyphenated) :

<nom mon-nom="Toto"></nom>

Vous obtenez bien alors :

Mon nom est Toto

Attribut dynamique

Un attribut statique c’est bien mais un dynamique c’est encore mieux. On voudrait par exemple entrer le nom dans une zone de texte et qu’il s’affiche avec le composant. Essayons avec ce HTML :

<div id="tuto">
  <input v-model="nomSaisi">
  <br>
  <nom v-bind:nom="nomSaisi"></nom>
</div>

On prévoit l’argument nom pour le composant avec la directive v-bind , une propriété liée nomSaisi pour la VueModèle.

Avec ce Javascript :

Vue.component('nom', {
  props: ['nom'],
  template: '<p>Mon nom est <strong>{{nom}}</strong></p>'
});

new Vue({
  el: '#tuto'
});

Avec ce résultat :

img01

On retrouve en fait les possibilités qu’on avait déjà rencontrées mais adaptées à un composant.

Une action très fréquente consiste à générer une liste de données, on a déjà eu l’occasion d’utiliser la directive v-for pour le réaliser. Est-ce que ça peut fonctionner avec un composant ? Voici un exemple :

<div id="tuto">
  <liste v-for="personne in personnes" v-bind:personne="personne"></liste>
</div>

Et le Javascript :

new Vue({
  el: '#tuto',
  data: {
    personnes: [
      {nom: "Durand", prenom: "Jacques"},
      {nom: "Dupont", prenom: "Albert"},
      {nom: "Martin", prenom: "Denis"},
    ]
  },
  components: {
    'liste': {
      props: ['personne'],
      template: '<li>{{personne.nom}} {{personne.prenom}}</li>'
    }
  }
});

Avec ce résultat :

img02

Pour chaque élément de la liste une instance du composant est créée, comme on pouvait logiquement s’y attendre. Notez que les données ne sont pas automatiquement envoyées dans le composant qui est parfaitement isolé. Il faut encore déclarer une propriété.

On pourrait évidemment là aussi déclarer le composant de façon globale avec le même fonctionnement :

Vue.component('liste', {
  props: ['personne'],
  template: '<li>{{personne.nom}} {{personne.prenom}}</li>'
});

new Vue({
  el: '#tuto',
  data: {
    personnes: [
      {nom: "Durand", prenom: "Jacques"},
      {nom: "Dupont", prenom: "Albert"},
      {nom: "Martin", prenom: "Denis"},
    ]
  }
});

Allons un peu plus loin et créons un composant pour générer un tableau. On veut ce HTML :

<div id="tuto">
  <tableau :personnes="personnes"></tableau>
</div>

Donc un composant tableau auquel on transmet les données à afficher. On va conserver les données vues précédemment. Voici le Javascript :

var vm = new Vue({
  el: '#tuto',
  data: {
    personnes: [
      {nom: "Durand", prenom: "Jacques"},
      {nom: "Dupont", prenom: "Albert"},
      {nom: "Martin", prenom: "Denis"},
    ]
  },
  components: {
    tableau: {
      props: ['personnes'],
      template: '<table class="table table-bordered">\n' + 
        '<tr v-for="personne in personnes">\n' +
        '<td v-text="personne.nom"></td>\n' +
        '<td v-text="personne.prenom"></td>\n' +
        '</tr>\n' + 
        '</table>\n'            
    }
  }
});

Avec création du tableau :

img03

On peut répercuter tout changement dans les données au niveau du tableau. Par exemple si vous ajoutez ce code :

setTimeout(function() {
  vm.personnes.$set(1, {nom: "Claret", prenom: "Marcel"});
}, 2000);

Au bout de 2 secondes vous allez voir le tableau changer pour cette ligne.

Un composant générique

Le tableau réalisé ci-dessus est totalement adapté aux données concernées. On pourrait aborder cela d’une façon plus générale et créer un composant réutilisable qui accepterait des noms de colonnes et des données sans nécessairement en connaître le nombre :

<div id="tuto">
  <tableau
    :colonnes="colonnes" 
    :lignes="personnes">
  </tableau>
</div>

Ici on utilise un composant tableau en lui transmettant les colonnes et les lignes de données.

Voici le Javascript :

Vue.component('tableau', {
  props: ['colonnes', 'lignes'],
  template: '<table class="table table-bordered">\n' +
    '<thead>\n' +
    '<tr>\n' +
    '<th v-for="value in colonnes">{{ value }}</th>\n' + 
    '</tr>\n' +
    '</thead>\n' + 
    '<tr v-for="ligne in lignes">\n' +
    '<td v-for="value in ligne">{{ value }}</td>\n' +
    '</tr>\n' + 
    '</table>\n'  
});

new Vue({
  el: '#tuto',
  data: {
    colonnes: ['Nom', 'Prénom'],
    personnes: [
      ["Durand", "Jacques"],
      ["Dupont", "Albert"],
      ["Martin", "Denis"],
    ]
  }
});

Et ce résultat :

img04

On constate que maintenant le composant peut resservir dans un autre contexte parce qu’il est codé de façon générique. Remarquez que j’ai également transformé les données des personnes pour les rendre également génériques et ainsi simplifier le codage.

Un template élégant

Le code ci-dessus est élégant, mis à part la partie template qui fait un peu désordre. Il serait bien de pouvoir définir ce template avec une mise en page du code harmonieuse.

On peut inclure le template dans le HTML avec un attribut un peu particulier de la balise <script> qui permet de définir non pas un script mais un template. Voici le nouveau HTML intégrant le template :

<script type="text/x-template" id="tableau-template">
  <table class="table table-bordered">
    <thead>
      <tr>
        <th v-for="value in colonnes">
          {{ value }}
        </th>
      </tr>
    </thead>
    <tbody>
      <tr v-for="ligne in lignes">
        <td v-for="value in ligne">
          {{ value }}
        </td>
      </tr>
    </tbody>
  </table>
</script>

<div id="tuto">
  <tableau
    :colonnes="colonnes" 
    :lignes="personnes">
  </tableau>
</div>

Remarquez qu’on a un identifiant (tableau-template) qui va permettre de référencer ce template dans le composant :

Vue.component('tableau', {
  props: ['colonnes', 'lignes'],
  template: '#tableau-template'
});

new Vue({
  el: '#tuto',
  data: {
    colonnes: ['Nom', 'Prénom'],
    personnes: [
      ["Durand", "Jacques"],
      ["Dupont", "Albert"],
      ["Martin", "Denis"],
    ]
  }
});

Avec évidemment le même résultat que ci-dessus :

img04Cette fois le code est vraiment propre !

Le panier revisité

Comme exemple du précédent article sur les directives personnalisées on a amélioré le panier. Je vous propose de reprendre cet exemple mais cette fois de créer ce panier sous forme de composant. On va au passage se débarrasser de la directive personnalisée qui n’est plus pertinente, par contre on va voir qu’un composant peut disposer de toutes les propriétés que nous avons rencontrées dans cette série d’articles.

Voici le code complet de la page :

<!DOCTYPE html>
<html lang="fr">

  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Test vue.js</title>
    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
  </head>

  <body>

    <div class="container">
      <br>

      <script type="text/x-template" id="panier-template">
        <div class="panel panel-primary">
          <div class="panel-heading">Panier</div>        
          <table class="table table-bordered table-striped">
            <thead>
              <tr>
               <th class="col-sm-4">Article</th>
               <th class="col-sm-2">Quantité</th>
               <th class="col-sm-2">Prix</th>
               <th class="col-sm-2">Total</th>
               <th class="col-sm-1"></th>
               <th class="col-sm-1"></th>
              </tr>
            </thead>
            <tbody>
              <tr v-for="item in panier">
                <td>{{ item.article | capitalize }}</td>
                <td>{{ item.quantite }}</td> 
                <td>{{ item.prix | devise '€' }}</td>
                <td>{{ item.quantite * item.prix | devise '€' }}</td>
                <td><button class="btn btn-info btn-block" v-on:click="modifier($index)"><i class="fa fa-edit fa-lg"></button></td>
                <td><button class="btn btn-danger btn-block" v-on:click="supprimer($index)"><i class="fa fa-trash-o fa-lg"></i></button></td>
              </tr> 
              <tr>
                <td colspan="3"></td>
                <td><strong>{{ total | devise '€' }}</strong></td>
                <td colspan="2"></td>
              </tr> 
              <tr>
                <td><input type="text" class="form-control" v-model="input.article | capitalize" v-el:modif placeholder="Article"></td>
                <td><input type="text" class="form-control" v-model="input.quantite | entier 10" placeholder="Quantité"></td>
                <td><input type="text" class="form-control" v-model="input.prix | flottant" placeholder="Prix"></td>
                <td colspan="3"><button class="btn btn-primary btn-block" v-on:click="ajouter()">Ajouter</button></td>
              </tr>
            </tbody>       
          </table>
        </div> 
      </script>

      <div id="tuto">
        <panier :panier="panier"></panier>
      </div>

    </div>

    <script src="http://cdn.jsdelivr.net/vue/1.0.10/vue.min.js"></script>

    <script>

      Vue.component('panier', {
        props: ['panier'],
        template: '#panier-template',
        data: function () {
          return {
            input: { article: '', quantite: 0, prix: 0 }
          }
        },
        computed: {
          total: function () {
            var total = 0;
            this.panier.forEach(function(el) {
              total += el.prix * el.quantite;
            });
            return total; 
          }
        },
        methods: {
          ajouter: function() {
            this.panier.push(this.input);
            this.input = { article: '', quantite: 0, prix: 0 };
          },
          modifier: function(index) {
            this.input = this.panier[index];
            this.panier.splice(index, 1);
            this.$$.modif.focus();
          },
          supprimer: function(index) {
            this.panier.splice(index, 1);
          },
        },
        filters: {
          devise: function(valeur, symbole) {
            return valeur + ' ' + symbole;
          },
          entier: {
            read: function(valeur) {
              return valeur;
            },
            write: function(nouvelleValeur, ancienneValeur, max) {
              var valeur = parseInt(nouvelleValeur);
              if(valeur % 1 === 0) {
                return valeur > max ? ancienneValeur : valeur;
              }
              return 0;
            }
          },
          flottant: {
            read: function(valeur) {
              return valeur;
            },
            write: function(nouvelleValeur, ancienneValeur) {
              return isNaN(nouvelleValeur) ? ancienneValeur : nouvelleValeur;
            }
          }       
        }
      });

      new Vue({
        el: '#tuto',
        data: {
          panier: [
            { article: "cahier", quantite: 2, prix: 5.30 },
            { article: "crayon", quantite: 4, prix: 1.10 },
            { article: "gomme", quantite: 1, prix: 3.25 }
          ],
        }
      });

    </script>

  </body>

</html>

Avec évidemment les mêmes rendu et fonctionnement que lors du chapitre précédent :

img09

Vous voyez ainsi qu’il est relativement facile de créer des composant réutilisables !

Si vous voulez suivre l’évolution des données lors des manipulations du panier il suffit d’ajouter cette ligne au HTML :

<div id="tuto">
  <panier :panier="panier"></panier>
  <pre>{{$data | json}}</pre>
</div>

Le filtre json permet d’afficher correctement les données :

img05

Cet article est loin d’épuiser les possibilités des composants mais vous avez à présents de très bonnes bases. Je vous invite à consulter la documentation et cet excellent exemple pour compléter vos connaissances.

En résumé

  • Vue.js permet la création de composants pour enrichir le HTML.

  • Un composant peut utiliser toutes les options existantes (mis à part el).

  • Il est possible de passer des données à un composant.

  • Un composant peut hériter des données de son parent.

  • On peut manipuler des listes avec un composant.

Print Friendly, PDF & Email

Laisser un commentaire