VueJS 2

Introduction

VueJS est une librairie JavaScript, sortie en février 2014 par Evan You, utilisé uniquement pour le côté “vue” dans MVC. Il ressemble donc à ReactJS et se diffère des autres frameworks complets comme Angular ou EmberJS.

Documentation

Compatibilité

Ne supporte pas IE8 et les versions antérieures, car il utilise des fonctionnalités ECMAScript 5.

Installation

Choisir le build

Plusieurs build disponibles :

VueJS build

  • Full : Compiler + Runtime.
  • Compiler : code responsable de la compilation des chaînes de caractère de template.

    // ceci a besoin d'un compilateur
    new Vue({ template: '<div>{{ hi }}</div>' })
    
    // ceci n'en a pas besoin
    new Vue({
      render (h) { return h('div', this.hi) }
    })
    
  • Runtime : code responsable de la création des instances de Vue, de faire le rendu et les modifications du DOM virtuel. C’est à dire tout, sauf ce que fait la partie Compiler.

  • UMD : les builds UMD peuvent être utilisés directement dans un navigateur avec la balise <script>.

  • CommonJS : à utiliser avec les vieux outils de paquetage (« bundle ») comme browserify ou webpack 1. Le fichier par défaut pour ces outils (pkg.main) est le build vue.runtime.common.js.

  • ES Module : à utiliser avec les outils de paquetage modernes comme webpack 2 ou rollup. Le fichier par défaut pour ces outils (pkg.module) est le build vue.runtime.esm.js.

Installation rapide


Directives

Les directives sont préfixées par v- pour indiquer que ce sont des attributs spéciaux fournis par Vue.

Elles permettent d'appliquer un comportement réactif spécifique au DOM après rendu.

Attribut : v-bind

Version courte: :attribute=value

<span v-bind:title="message">
  Passez votre souris sur moi !
</span>

var app2 = new Vue({
  el: '#app-2',
  data: {
    message: 'Vous avez affiché cette page le ' + new Date().toLocaleString()
  }
})

Condition : v-if

<p v-if="seen">Maintenant vous me voyez</p>

var app3 = new Vue({
  el: '#app-3',
  data: {
    seen: true
  }
})

Boucle : v-for

<li v-for="todo in todos">
  {{ todo.text }}
</li>

var app4 = new Vue({
  el: '#app-4',
  data: {
    todos: [
      { text: 'Apprendre JavaScript' },
      { text: 'Apprendre Vue' },
      { text: 'Créer quelque chose de génial' }
    ]
  }
})

Events : v-on

Version courte: @click

<button v-on:click="reverseMessage">Message retourné</button>

var app5 = new Vue({
  el: '#app-5',
  data: {
    message: 'Hello Vue.js !'
  },
  methods: {
    reverseMessage: function () {
      this.message = this.message.split('').reverse().join('')
    }
  }
})

Data binding : v-model

Liaison de données bidirectionnelle entre les champs d’un formulaire et l’état de l’application.

<p>{{ message }}</p>
<input v-model="message">

Sinon on peut utiliser l’interpolation de texte en utilisant la syntaxe “Mustache” : {{ message }}.

var app6 = new Vue({
  el: '#app-6',
  data: {
    message: 'Hello Vue !'
  }
})

v-html

Interprête les chaîne de charactères d'HTML.


Instance Vue

Une application Vue consiste en une instance racine de Vue créée avec new Vue.

Pour créer une instance Vue :

var vm = new Vue({
  // options
})

Hooks

Chaque instance de vue traverse une série d’étapes d’initialisation au moment de sa création.

En cours de route, elle va aussi invoquer des hooks de cycle de vie de l'instance, qui nous donnent l’opportunité d’exécuter une logique personnalisée à chaque niveau.

Liste des hooks :

  • created : appelé une fois l’instance créée
  • mounted : appelé juste après que l’instance ait été montée
  • updated
  • destroyed

Tous ces hooks de cycle de vie sont appelés avec leur this pointant sur l’instance de la vue qui les invoque.

ⓘ **Ne pas utiliser les fonctions fléchées** pour les hooks. Comme les fonctions fléchées sont liées au contexte parent, this ne sera pas l’instance de Vue.

VueJS cycle de vie

Methods et Computed

Permet de définir une fonction en tant que méthode. Les deux approches Methods et Computed sont en effet exactement les mêmes sauf que les propriétés déclarées dans computed sont mises en cache selon leurs dépendances.


Composants

Des portions du site réutilisables et autonomes.

Tous les composants de Vue sont également des instances de Vue donc ils acceptent le même objet d’option.

Pour créer un composant :

    Vue.component('todo-item', {
      template: '<li>Ceci est une liste</li>' // template avec compiler
    })

Template

Il existe plusieurs manières d'écrire le template :

  • HTML pur
  • Fonction de rendus et JSX

Librairies externes complémentaires

Dépendances souvent associées avec Vue.

Vueify

⚠ Obsolète ! Remplacer par webpack et rollup.

Précompilation des templates des balises <template></template> dans les pages *.vue. Pas besoin du Compiler.

Permet d'écrire les composants dans un seul fichier (single-file).

Routage

  • Vue-router : est le router officiel pour Vue.js
  • Page.js
  • Director

Gestionnaire d'état

Le gestionnaire d'état sert de zone de stockage de données centralisée pour tous les composants dans une application, avec des règles pour s'assurer que l'état ne puisse subir de mutations que d'une manière prévisible.

  • Vuex : bibliothèque pour des applications Vue.js.
  • Redux :

Voir la doc pour plus de précisions

Requête API

  • Axios

Best practices

https://fr.vuejs.org/v2/style-guide/index.html


Erreurs courantes

Vue js error: Component template should contain exactly one root element

Dans le template il doit avoir un élément parent qui englobe tous les éléments.

https://alligator.io/vuejs/implementing-infinite-scroll/