Séance 1 : Concepts et installation

Préambule

Ce cours se base sur la version 3 de Vue.js. Attention vous trouverez beaucoup d'exemple en Vue.js 2 sur les forums et sites d'aide.

La documentation officielle se trouve ici sur le lien suivant

Vue.js

Site officiel de Vue.js 3

Présentation des concepts de Vue.js

Installation et démarrage d'une nouveau projet.

Assurez vous de disposer de nodeJs et de npm fonctionnels, testez avec la commande ci-dessous

npm --version

Pour créer un nouveau projet, tapez la commande suivante :

npm init vue@latest

Lors de la première execution, la commande va vous proposer d'installer create-vue. Confirmez la proposition

Répondez aux différentes questions. Par défaut mettez toutes les questions sur non, sauf "Add Vue Router for single Page Application development" que vous pouvez mettre sur yes.

Executez les commandes suivantes :

  cd vue-lp
  npm install
  npm run dev

La première commande accède au répertoire, la deuxième installe toute les dépendances (comme composer install avec PHP/Syfmony), la dernière lance le serveur qui va s'occuper de compiler les fichiers et rendre l'application "Vue.js" utilisable dans tous les navigateurs.

Vous devriez voir un message vous proposant l'url de votre projet "compilé". Ouvrez-là et vous devriez avoir une page similaire à celle ci-dessous :

Page d'accueil suite à la première installation d'un projet Vue.js

Premier exemple

Premières manipulations.

Dans le composant App.vue qui est créé par défaut, et qui est le point d'entrée de votre application, nous allons faire les premiers tests.

Nous allons définir une liste de 3 éléments, par exemple :

<ul>
  <li>Note sur Symfony : 19</li>
  <li>Note en intégration : 12</li>
  <li>Note en réseau : 14</li>
</ul>

Si on souhaite rendre cette liste "dynamique", on peut définir des variables pour les notes. La syntaxe est identique à Twig pour les variables...

<ul>
  <li>Note sur Symfony : {{ symfony }}</li>
  <li>Note en intégration : {{ integration }}</li>
  <li>Note en réseau : {{ reseau }}</li>
</ul>

Si vous testez de nouveau ce code, vous aurez une erreur car les variables n'existent pas. Nous devons les définir.

Pour cela, dans la partie javascript de notre fichier App.vue, nous allons définir une "entrée" data, qui va contenir nos valeurs.

La déclaration pourrait être (en vue2 ou vue3 "classique":

<script>
export default {
  name: 'App',
  data: () => {
    return {
      symfony: 6,
      integration: 2,
      reseau: 8,
    }
  },
}
</script>

Nous utiliserons la notation qui est préconisée avec la version 3 de Vue.js le "mode Composition API" (https://vuejs.org/guide/extras/composition-api-faq.html)

Notre code dans la partie script se résume donc à :

<script setup>
const symfony = 18
const integration = 16
const reseau = 13
</script>

Reprenons depuis le début

Analysons notre répertoire de projet

• node_module : contient toutes les dépendances de notre projet. Il est créé par la commande npm install. Il ne faut rien modifier dans ce dossier, et ne jamais le gérer avec git. Son équivalent dans Symfony est vendor.

• public : c'est le repertoire "public", qui contient les éléments type images, favicon, les fichiers uploadés par vos utilisateurs, ... Il a le même rôle que "public" dans symfony.

• src : c'est notre répertoire de travail, la très grande majorité de notre code se trouvera dans ce dossier.

• index.html : c'est le fichier html de base qui est affiché dans le navigateur et qui va intégrer nos composants Vue.js. Sa syntaxe est décrite par la suite.

• package.json (et son package-lock.json), sont la liste des dépendants installées, c'est l'équivalent du composer.json pour le back.

• vite.config.js : c'est l'automatisateur de tâches (comme gulp ou webpack, Vue.js 3 recommande l'usage de Vite qui est plus rapide et performant). Nous reviendrons sur ce fichier en BUT3. Il récupère tous les éléments du dossier src/, va les traduires en du JavaScript compréhensible par les navigateurs et en faire un seul et unique point d'entrée.

Détail du fichier index.html

index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <link rel="icon" href="/favicon.ico">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Vite App</title>
  </head>
  <body>
    <div id="app"></div>
    <script type="module" src="/src/main.js"></script>
  </body>
</html>

• ligne 10 : ce élément, avec un id "app" est l'élément qui va pouvoir recevoir notre code, nous le verrons avec le fichier main.js. Vous pourriez avoir plusieurs balises recevant plusieurs parties Vue.js. Vous pourriez aussi avoir un habillage HTML défini dans cette page et un "morceau" géré par Vue.js.

• ligne 11 : C'est l'intégration du fichier main.js qui va contenir tout notre code JavaScript et les composants Vue.js.

Détails du repertoire src/

• assets : votre CSS/SCSS ... global à votre projet. Les logos et images du site.

• components : nos composants Vue.js, des parties d'une page, qui seront assemblés pour faire votre page globale.

• router : contiendra nos routes de notre site, le lien entre l'URL, les pages Vue.js.

• views : les pages "Vue.js", qui assemblent les composants.

• App.vue : notre composant principal, décrit par la suite

• main.js : le fichier utilisé par ViteJs pour faire le lien entre les fichiers Vue.js, et la page index.html.

Cette structure est la base, vous pouvez l'organiser autrement, et ajouter toute la décomposition nécessaire.

Détail du fichier App.vue

Ce fichier est construit selon la structure "classique" de Vue.js, décrite dans la partie suivante.

<script setup>
  const symfony = 18
  const integration = 16
  const reseau = 13
</script>

<template>
  <ul>
    <li>Note sur Symfony : {{ symfony }}</li>
    <li>Note en intégration : {{ integration }}</li>
    <li>Note en réseau : {{ reseau }}</li>
  </ul>
</template>

<style scoped>
li {
  color: red;
}
</style>

Structure d'un fichier Vue.js (.vue)

Si on utilise vue en mode "composant" (https://fr.vuejs.org/guide/scaling-up/sfc.html#introduction) (c'est à dire avec des fichiers .vue ou SFC (single file component)) et en mode Composition API, un fichier .vue à les éléments suivants :

• template : qui contient le code HTML de votre composant (une partie de votre page). Ce code peut exploiter lui même d'autres composants Vue.js. La balise template doit contenir un seul enfant dans le dom.

• script : qui va contenir votre code JavaScript : les variables, les méthodes, les différents imports...

• style : optionnel, pour contenir le CSS propre au composant.

Pourquoi les composants monofichiers (SFC)#

Si les SFC nécessitent une étape de compilation, les avantages sont nombreux en contrepartie :

• Créer des composants modulaires en utilisant une syntaxe HTML, CSS et JavaScript familière.

• Collocation de responsabilités couplées

• Templates précompilés sans coût de compilation au runtime

• CSS à portée limitée au composant

• Syntaxe plus confortable avec l'API de Composition

• Meilleures optimisations à la compilation grâce à l'analyse croisée du template et des scripts.

• Support des environnements de développement avec autocomplétion et vérification des types pour les expressions dans le template.

• Prise en charge nativement du remplacement de modules à chaud (HMR).

SFC est une caractéristique déterminante de Vue en tant que framework, et c'est l'approche recommandée pour utiliser Vue dans les scénarios suivants :

• Applications à page unique (SPA)

• Génération de sites statiques (SSG)

• Tout front-end non trivial pour lequel une étape de construction peut être justifiée pour une meilleure expérience de développement (DX).

Détail du fichier main.js

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'

import './assets/main.css'

const app = createApp(App)

app.use(router)

app.mount('#app')

C'est le fichier clé de votre application, l'équivalent du index.php de Symfony, car c'est lui qui contrôle tout ce qui va se passer, c'est le point d'entrée. c'est dans ce fichier que l'on peut instancier des dépendances globalements (comme router ici)

• Ligne 1 : Import de Vue.js, et du composant createApp pour construire l'application (utilisé ligne 7)

• Ligne 2 : On importe notre composant Vue.js App.Vue pour pouvoir l'exploiter dans notre fichier, et ici l'injecter dans la page ligne 7

• Ligne 3 : le router pour gérer nos routes. On l'associe à notre application (ligne 9)

• Ligne 5 : on importe notre CSS (ou autre), pour l'appliquer globalement au projet. Si c'est du Scss/Sass, ViteJs se chargera de le compiler en CSS.

• Ligne 7 : on instancie notre application Vue.js avec le composant App (importé ligne 2)

• Ligne 9 : on associe à notre application "app", le router, ce qui nous permettra de l'utiliser partout.

• Ligne 11 : Cette ligne vient "injecter" notre application vue, dans la page html (index.html), et très exaxctement dans la balise avec l'id "app"

Templates

Dans du code HTML

Vue utilise une syntaxe de template basée sur HTML pour permettre de lier de manière déclarative le DOM rendu aux données de l'instance du composant sous-jacent. Tous les templates Vue sont du HTML syntaxiquement valide qui peut être analysé par des navigateurs et des analyseurs HTML conformes aux spécifications. A titre de comparaison ReactJs utilise du JSX pour décrire la partie HTML.

La forme la plus élémentaire de liaison de données est l'interpolation de texte à l'aide de la syntaxe "Moustache" (doubles accolades) :

Message : {{ msg }}

Dans cet exemple msg est une variable dont le contenu doit être défini dans votre code Vue.js.

Dans des attributs ou des balises

Si vous souhaitez passer une variable dans une balise HTML (ou un composant Vue.js), ou dans un attribut, vous ne pouvez pas utiliser la syntaxe "moustache" avec les accolades. Vous devez passer par l'instruction v-bind, exemple :

<div v-bind:id="idDynamique"></div>

Dans cet exemple idDynamique est donc la variable qui alimentera l'attribut id de la balise div.

Il existe une syntaxe "courte" qui peut s'écrire sans le v-bind comme ci-dessous :

<div :id="idDynamique"></div>

Passer plusieurs attributs

Si vous avez un objet JavaScript représentant plusieurs attributs qui ressemble à ceci :

const objectOfAttrs = {
  id: 'conteneur',
  class: 'wrapper'
}

Vous pouvez les lier à un seul élément en utilisant v-bind sans argument :

<div v-bind="objectOfAttrs"></div>

Cette syntaxe va faire apparaître les deux attributs id et class dans votre objet. Le v-bind est ici obligatoire, il n'y a pas de syntaxe courte.

Manipulation des variables

Les variables entre accolades peuvent être manipulées comme toutes les variables, comme dans les exemples ci-dessous.

{{ nombre + 1 }}

{{ ok ? 'OUI' : 'NON' }}

{{ message.split('').reverse().join('') }}

Concaténer des variables et du texte

Si vous souhaitez construire un mot contenant du texte et une variable, vous pouvez utiliser la syntaxe ci-dessous :

<div :id="`liste-${id}`"></div>

${id} est la variable id dans la notation particulière dans le contexte d'une concaténation avec du texte et avec l'usage des ``

Manipuler les variables du côté javascript

Coté JavaScript, la déclaration des variables se fait de manière conventionnelle avec des constants, ou des variables (let), des variables simples (textes, nombres, float, ...) ou des tableaux, des objets json.

<script setup>
  const symfony = 18
  const matieres = {
    var1: 2,
    var2: 3
    }
  const notes = [12, 13, 17]
</script>

Exercices

• Installation de Vue.js

• Modifiez le composant App.vue pour ajouter des variables : un titre et un paragraphe de texte

• Créer un deuxième composant. Comment l'ajouteriez vous dans le composant App.vue ?

• Ajoutez 3 variables (note1, note2 et note3) et affichez ces 3 notes et la moyenne.

• Ajoutez une variable de type tableau contenant une liste de mot. Affichez cette liste.

Propriétés calculées (computed)

Le calcul de la moyenne de l'exercice précédent est pratique, mais si on souhaite l'utiliser à plusieurs endroits il faudra refaire le calcul. Par ailleurs, on pourrait exploiter une boucle en JavaScript, ou manipuler des variables qui se composent elles mêmes de plusieurs autres variables. Tout cela est possible avec Vue.js, en utilisant des propriétés calculées, dites computed.

La syntaxe d'une propriété calculée est la suivante (dans la partie script) :

const somme = computed(() => {
  return note1 + note2 + note3
})

Une propriété calculée est une constante, avec un nom, l'instruction computed, puis une fonction anonyme en JavaScript.

Pour fonctionner ce code nécessite d'importer l'instruction computed qui est native dans Vue.js avec la ligne ci-dessous :

import { computed } from 'vue'

Le code complet serait donc :

<script setup>
import { computed } from 'vue'

const note1 = 18
const note2 = 16
const note3 = 13

const moyenne = computed(() => {
  return (note1 + note2 + note3) / 3 
})

</script>

L'utilisation dans la partie template se fait en considérant moyenne comme une variable classique. On peut donc l'utiliser pour un affichage avec {{ moyenne }} ou dans des tests ou boucles, ou d'autres opérations.

Réactivité

Cela ne concerne que l'approche par "composition" de Vue.js 3. La source de cette partie est la traduction de la documentation ici : https://vuejs.org/guide/essentials/reactivity-fundamentals.html