Tutoriel pour développer une application web avec Vue.js et Vue CLI : généralités (partie 1)

Mickael Baron

L'objectif de cet article en plusieurs parties est de vous présenter le framework web JavaScript Vue.js en se focalisant sur les principaux concepts au travers d'un exemple unique.

Les différentes parties de cet article sont détaillées ci-dessous :

- Généralités sur les frameworks web JavaScript et présentation de Vue.js ;

- mise en œuvre des concepts de Vue.js ;

- déploiement d'une application web développée avec Vue.js.

Lors de l'écriture de l'article, nous avons utilisé la version 2 de Vue.js et la version 4 de Vue CLI.

Cette première partie s'intéresse donc à présenter les principaux concepts qu'un framework web JavaScript nouvelle génération doit proposer et comment ils ont été intégrés dans Vue.js.

Le plan est le suivant :

- présentation des frameworks web JavaScript (en général) afin de connaître les principales fonctionnalités qu'ils doivent fournir à un développeur ;

- présentation des grandes lignes du framework web Vue.js ;

- présentation des prérequis logiciels pour développer avec Vue.js.

Pour réagir au contenu de cet article, un espace de dialogue vous est proposé sur le forum Commentez .

- Titre : Tutoriel pour développer une application web avec Vue.js et Vue CLI : généralités (partie 1)

- Auteur : Mickael Baron

- Parution : 5 juillet 2019

- Mise à jour : 30 juin 2020

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2019 Mickael Baron. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Un framework web JavaScript, c'est quoi ?

- I-A. Liaison entre le modèle et la vue : binding

- I-B. Templating

- I-C. Composant

- I-D. Routage

- II. Présentation du framework web Vue.js

- II-A. Facilité d'apprentissage

- II-B. Approche par composant

- II-C. DOM Virtuel

- II-D. Popularité et communauté

- II-E. Intégration progressive

- III. Outillage et installation pour Vue.js

- III-A. Outils pour le développeur web

- III-B. Outils pour le développeur Vue.js

- III-B-1. Vetur

- III-B-2. Vue-DevTools

- III-B-3. Vue CLI

- IV. Conclusion et remerciements

- V. Ressources

I - Un framework web JavaScript, c'est quoi ?

Le développement d'applications web a connu trois évolutions majeures. Ces évolutions ont vu naître différentes technologies comme le montre la figure ci-dessous (source figure : https://twitter.com/lofidewanto/status/1128981965632364544).

La suite de ces propos est issue d'une réflexion et de vécus personnels. Des raccourcis peuvent avoir été réalisés, n'hésitez pas à nous signaler toutes incohérences.

La première période se situe depuis la naissance du web jusqu'au milieu des années 2000. Il s'agissait de développer des applications classiques présentant des documents et des formulaires. Les technologies clientes utilisées se limitaient souvent au langage HTML et pour la fin de la période à l'utilisation de feuilles de style avec CSS.

La deuxième période se situe entre 2005 et 2010. Cette période se distingue par l'arrivée des applications web riches (RIA : Rich Internet Application). La couche logique a été grandement déportée vers le serveur (grâce à la popularisation du langage côté serveur PHP). C'est aussi pendant cette période que le développement d'AJAX est apparu avec le style d'architecture REST (services web). De cette période, la technologie la plus utilisée a été la bibliothèque JQuery. Cette bibliothèque a facilité la manipulation de la partie de la structure HTML afin d'obtenir des applications qui réagissaient sans avoir à rafraichir l'intégralité d'une page complète. Malheureusement, c'est aussi à cette période que le nombre de navigateurs a explosé. Le développement était donc un peu chaotique, car il fallait supporter toutes les subtilités des navigateurs qui ne se conformaient pas forcément aux standards existants. Des initiatives via des bibliothèques comme GWT sont apparues pour tenter de résoudre ce problème, mais cela restait quand même du bricolage.

La troisième période se situe après 2010 jusqu'à nos jours. Nous sommes passés du terme applications web riches à applications web monopage (plus connu, en anglais sous le nom de SPA pour Single-Page application). Il s'agit désormais d'une application web où tout est accessible sur une page web unique afin de rendre l'expérience utilisateur la plus fluide possible. Pour obtenir ce résultat soit tout le contenu est chargé en avance soit à la demande, mais en tâche de fond. Il y a eu aussi un déport important de la logique vers le client afin de libérer des ressources côté serveur. Les effets de bord à ce transfert de code côté client a naturellement obligé les développeurs à structurer leur code et de facto à utiliser des outils adaptés (Grunt, Gulp, Yeoman, Webpack) pour réaliser des opérations sur cette masse de code (compilation, qualité de code, minification…). C'est ainsi que des frameworks web JavaScript sont apparus.

Les frameworks JavaScript du marché sont les suivants (sans être exhaustifs) :

- Angular* ;

- Angular.js ;

- Backbone.js ;

- Ember.js ;

- Knockout.

- Meteor.js ;

- React.js* ;

- Vue.js* ;

Aujourd'hui fin 2019, Angular, React.js et Vue.js sont les frameworks web JavaScript qui ont réussi à s'imposer.

Après analyse rapide des différents frameworks ci-dessus, quatre fonctionnalités que doit posséder un framework web JavaScript de nos jours ont été identifiées. Détaillons dans la suite ces quatre fonctionnalités.

I-A - Liaison entre le modèle et la vue : binding

La plupart des frameworks web JavaScript implémentent le modèle d'architecture MVVM (pour Model-View-ViewModel) qui est une déclinaison du très populaire modèle d'architecture MVC (Model-View-Controler). Sur le modèle d'architecture MVVM, la partie contrôleur a été supprimée afin de rapprocher les parties vue et modèle. Ainsi, la nouvelle partie ViewModel permet de consommer les éléments du modèle et de les afficher dans la partie vue et inversement (mettre à jour le modèle à partir de la vue). C'est donc dans la partie ViewModel que cette notion de binding se retrouve.

Pour résumer le binding, il s'agit d'un mécanisme qui permet de lier des objets de manière dynamique. Si deux objets obj1 et obj2 sont liés par un binding, le fait de modifier obj1 va automatiquement modifier obj2 et inversement.

À titre d'exemple, obj1 est un champ de texte et obj2 une propriété du modèle de type chaîne de caractères, si une valeur est saisie dans le champ de texte, obj2 récupérera automatiquement cette valeur. Par ailleurs, si obj2 est modifié par la récupération d'un appel à un service web, le champ de texte identifié par obj1 sera mis à jour.

I-B - Templating

L'utilisation de template permet d'enrichir le code HTML d'informations supplémentaires afin de faciliter par exemple la mise en place du binding.

Deux types d'informations supplémentaires sont disponibles pour le développeur.

La première concerne les interpolations qui se présentent sous la forme d'une notation mustache {{ }}. À l'intérieur de cette notation moustache, une expression qui peut-être du texte, des propriétés du modèle et même des expressions JavaScript. Dans l'exemple ci-dessous, question désigne une propriété du modèle.

1. {{ question }}

La seconde concerne les directives qui sont des attributs supplémentaires aux balises HTML. Dans le code ci-dessous, les directives v-model et @keypress.enter sont présentées.

1. <input

2. type="text"

3. placeholder="Polldle Option"

4. v-model="newPolldleOptionText"

5. class="large-input mx-auto d-block"

6. @keypress.enter="addPolldleOption"

7. >

I-C - Composant

Les frameworks web JavaScript offrent la possibilité de créer des composants réutilisables au sein de son application ou via d'autres applications. Ils permettent de construire une hiérarchisation des composants en désignant un parent et des enfants. Ainsi, la construction de l'interface graphique devient structurée et elle est calquée sur le modèle des interfaces graphiques que nous développions pour les applications bureau (du moins pour mon cas personnel).

Certains frameworks web JavaScript permettent de construire des composants respectant la spécification Web Components en cours de normalisation par le W3C.

I-D - Routage

Les applications de type Single-Page application partent du principe qu'il n'y a qu'une seule page à télécharger et que le changement s'opère à l'intérieur de cette page. Toutefois, l'URL (qui est contenue dans la barre d'adresse) doit pouvoir évoluer afin de préciser l'état de l'application. Avec cet état, il est possible de gérer le changement des composants à afficher et l'historique de l'application.

Les frameworks web JavaScript offrent ce mécanisme en interceptant le changement de valeur dans l'URL, en récupérant d'éventuels paramètres (paramètres de chemin et de requêtes) et de réaliser une opération spécifique.

II - Présentation du framework web Vue.js

De nos jours pour développer des applications web, le choix du framework se limite souvent à Angular ou React.js. C'est un raccourci rapide, mais c'est une réalité du marché, il n'y a qu'à voir les offres d'emploi ou les conférences autour de Angular et React.js. Et pourtant, il existe de nombreux frameworks de très bonne qualité, et Vue.js en fait partie.

Vue.js est un framework JavaScript pour le développement d'interfaces web. La première version a été publiée en 2014 par Evan You, un ancien de chez Google. Dans la suite de cette section, nous allons montrer ce que peut apporter ou pas Vue.js face à ces deux ténors du marché.

II-A - Facilité d'apprentissage

La plupart des développeurs de sites web connaissent au moins les trois technologies suivantes : HTML, CSS et JavaScript. L'avantage de Vue.js est de se limiter à ces technologies et il n'est pas nécessaire de monter en compétence sur un nouveau langage comme pourrait l'être React.js avec le langage JSX. Même si JSX est similaire à HTML, il incombe aux développeurs de se familiariser avec ce nouveau langage.

1. <div id="editor">

2. <textarea :value="input" @input="update"></textarea>

3. <div v-html="compiledMarkdown"></div>

4. </div>

Comme montré sur le code ci-dessus, Vue.js réutilise les balises HTML classiques en ajoutant de nouvelles façons d'enrichir le code (:value, @input et v-html).

II-B - Approche par composant

Vue.js est un framework qui permet de construire son application par un assemblage de plusieurs composants. Ce composant permet de créer de nouvelles balises HTML avec un comportement spécifique. La finalité est de pouvoir facilement réutiliser un composant.

Pour définir un composant, un fichier portant l'extension .vue doit être défini. Ce fichier se décompose en trois parties distinctes.

Ci-dessous le code source du fichier helloworld.vue ( source).

1. <template>

2. <p>{{ greeting }} World!</p>

3. </template>

4. <script>

5. module.exports = {

6. data() : {

7. return {

8. greeting: 'Hello'

9. }

10. }

11. }

12. </script>

13. <style scoped>

14. p {

15. front-size: 2em;

16. text-align: center;

17. }

18. </style>

Les trois parties définissent le composant, à savoir :

- un template constitué de balises HTML qui définit la structure du composant ;

- un code JavaScript qui détermine le comportement du composant ;

- des styles CSS qui définissent l’apparence du composant.

Pour utiliser ce composant hellowolrd depuis un autre composant, nous l'utilisons comme une simple balise HTML ayant pour identifiant le nom du fichier .vue.

1. <template>

2. <helloworld/>

3. </template>

4. ...

II-C - DOM Virtuel

Pour rappel le DOM (Document Object Model) est un objet représentant un document HTML et une API pour manipuler cet objet. Dans le cas d'une modification sur le DOM (par exemple ajouter une entrée <li>...</li> à une liste <ul>), il sera nécessaire d'utiliser l'API pour trouver l'élément <ul>, créer un nouvel élément <li>...</li>, ajouter cet élément à l'élément liste <ul> et effectuer la mise à jour du DOM. Comme on peut le comprendre, cela est très couteux et historiquement cette API n'était pas taillée pour gérer de nombreuses modifications qui peuvent intervenir fréquemment (toutes les secondes). Pour cette raison entre autres, le DOM virtuel a été mis en place.

La notion de DOM virtuel a été popularisée par React.js. Il s'agit d'une copie du DOM original. Les modifications apportées sur cette copie peuvent être réalisées sans passer par le DOM et surtout sans utiliser l'API initiale. Ainsi, l'intérêt d'un DOM virtuel est de pouvoir faciliter la mise à jour du rendu de la vue sur des fréquences plus élevées.

II-D - Popularité et communauté

Vous trouverez ci-dessous quelques statistiques concernant les trois frameworks et bibliothèques les plus répandus. Le site stackshare.io a permis d'obtenir les informations pour la colonne Emplois.

Framework

GitHub Stars

GitHub Forks

Emplois

Angular

46,316

12,168

4870

React.js

124,921

22,701

9080

Vue.js

131,609

18,786

548

Comme vous pouvez le constater, Vue.js se positionne bien au niveau popularité Github par rapport à Angular ou React.js. Pour Angular, cela s'explique puisqu'une première version sous le nom de Angular.js est aussi disponible, toujours en développement et en production. Par contre côté offres d'emploi, Vue.js est largement en dessous.

Au niveau des entreprises qui utilisent Vue.js, voici une liste non exhaustive de grandes entreprises : Netflix, Adobe, Xiaomi, Alibaba, WizzAir, EuroNews, Grammarly, Laracasts, GitLab. Vous pourrez trouver sur ce site un complément des entreprises qui utilisent cette bibliothèque.

Au niveau des ressources pour l'apprentissage de Vue.js, nous avons constaté qu'elles étaient moins nombreuses que pour Angular ou React.js. D'un autre côté, comme Vue.js est simple à comprendre et à prendre en main, a-t-on besoin d'autant de ressources ?

Enfin, le dernier concerne la disponibilité de bibliothèques externes (en gros des composants) qui permettent de faciliter le développement avec Vue.js. C'est assez difficile à estimer. Vous trouverez sur ce lien ( awesome-vue des composants externes pour enrichir vos développements.

II-E - Intégration progressive

Un des avantages de Vue.js est de pouvoir l'utiliser soit comme une bibliothèque pour s'intégrer dans un code existant soit comme un framework web JavaScript pour bâtir une application entièrement.

Dans le cas d'une utilisation de Vue.js comme une bibliothèque, cela vous permettra de profiter du binding modèle/vue dans une simple page HTML ou de pouvoir expérimenter rapidement dans un outil en ligne comme JSFiddle ou CodePen. Ci-dessous est présenté un code minimaliste pour utiliser Vue.js comme une bibliothèque.

1. <html>

2. <head>

3. <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>

4. </head>

5. <body>

6. <div id="app">

7. <span v-if="seen">Now you see me</span>

8. </div>

9. <script>

10. Vue.config.devtools = true;

11. var app = new Vue({

12. el: '#app',

13. data: {

14. seen: true

15. }

16. })

17. </script>

18. </body>

19. </html>

Comme vous pouvez le remarquer, il suffira de déclarer dans la balise head l'URL de la version de distribution de Vue.js et d'initialiser un objet Vue dans la partie JavaScript. L'instruction Vue.config.devtools = true; permet de profiter de l'outil de débogage Vue-DevTools.

Dans le cas d'une utilisation comme un framework web JavaScript (ce qui nous intéresse dans cet article), le développeur se fera aider par l'outil en ligne de commande Vue CLI que nous présenterons dans la section suivante.

III - Outillage et installation pour Vue.js

Avant de démarrer ce tutoriel, nous allons préparer notre environnement de développement en installant un ensemble d'outils.

Nous distinguons deux types d'outils : les outils « classiques » pour le développement web et les outils spécifiques pour le développement avec le framework Vue.js.

Pour les expérimentations, nous avons utilisé un environnement de développement sous macOS et Windows. Tous les outils présentés ci-dessous sont disponibles sous Windows, macOS et Linux.

III-A - Outils pour le développeur web

- Chrome ou Firefox : comme nous développons une application web, un navigateur sera nécessaire ;

- Visual Studio Code : un très bon éditeur de texte facilement modulable ;

- npm ou yarn : l'outil ultime pour le développement avec JavaScript ;

- node.js : le complément à npm pour fournir un serveur web ;

- Java : le langage qui sera utilisé pour le développement de l'exemple concernant la couche service côté backend ;

- Maven : pour faciliter la construction du projet Java ;

- Docker et Docker Compose : pour tester le déploiement de l'exemple.

Dans la liste ci-dessus, les trois derniers éléments (Java, Maven et Docker) ne sont pas obligatoires pour le développeur web. Java et Maven nous serviront pour la couche service web de l'exemple et Docker et Docker Compose seront utilisés pour le déploiement de ce même exemple.

III-B - Outils pour le développeur Vue.js

- Vetur : une extension pour développer avec Vue.js sous Visual Studio Code.

- Vue-DevTools : extension pour le navigateur web pour faciliter le débogage des applications Vue.js.

- Vue CLI : outillage standard pour développer avec Vue.js.

III-B-1 - Vetur

Vetur est une extension pour Visual Studio Code. Elle permet d'ajouter de nombreuses fonctionnalités pour faciliter le développement. Voici quelques fonctionnalités que nous avons retenues :

- affichage d'aide contextuelle s'il y a un problème de syntaxe ;

- autocomplétion sur les directives, modèle d'un composant ;

- création de snippets avec une intégration de Emmet ;

- intégration avec ESLint pour afficher les erreurs JavaScript à ne pas commettre.

III-B-2 - Vue-DevTools

Vue-DevTools est une extension pour les navigateurs web Chrome et Firefox pour faciliter le débogage des applications Vue.js. Cette extension va permettre d'introspecter les composants et afficher la liste des événements qui ont été émis par un composant.

L'installation est simple, il suffit de se rendre sur à l'adresse correspondante à votre navigateur web préféré :

- Extension DevTools pour Chrome ;

- Extension DevTools pour Firefox ;

Il existe également une version dite « standalone » basée sur Electron. Pour en savoir plus, se référer à cette documentation.

Cette extension permet de visualiser et de naviguer à travers les différents composants développés avec Vue.js. Nous illustrons cela sur la figure ci-dessous. Quand un composant est sélectionné depuis la partie gauche, les propriétés et les données de ce composant sont affichées sur la partie droite.

III-B-3 - Vue CLI

Vue CLI est un outil en ligne de commande pour faciliter la construction, le test et le déploiement de son application web. C'est un utilitaire de développement qui se place au-dessus de nombreux outils (webpack par exemple) pour rendre plus accessible le développement web avec Vue.js.

Depuis la version 3, Vue CLI a été revu en profondeur avec :

- absence de fichier de configuration webpack, suppression du répertoire config contenant des fichiers **.js* ;

- intégration de plugins ;

- ajout d'une interface web de configuration.

Pour installer cet outil, suivre les instructions ci-dessous.

1. npm install -g @vue/cli

2. npm install -g @vue/cli-service-global

Pour s'assurer que tout a été correctement installé.

1. $ npm list -g --depth 0

2. /usr/local/lib

3. ├── @vue/cli@4.4.5

4. ├── @vue/cli-service-global@4.4.5

5. └── ...

IV - Conclusion et remerciements

Cette partie a présenté les principaux concepts qu'un framework web JavaScript nouvelle génération doit proposer et comment ils ont été intégrés dans Vue.js.

Dans la partie suivante, nous nous intéresserons à utiliser ces concepts dans Vue.js au travers d'un exemple.

Cette partie est également disponible sur mon site web personnel : https://mickael-baron.fr/web/vuejs-generalites-part1.

Je tiens à remercier Claude Leloup pour sa relecture orthographique.

V - Ressources

- Vue.js : documentation officielle, traduite en plusieurs langues.

- Alligator : Alligator est un très bon site pour trouver des astuces pour Vue.js.

- Vue.js: Good, Bad, and Choice : une bonne analyse sur Vue.js.

- I created the exact same app in React and Vue. Here are the differences : une même application développée avec Vue.js et React.js.

- State of Vue.js 2019 : une analyse sur Vue.js.

- Programmaon Web Avancée et Mobile - Bibliothèques et frameworks côté client : un support de cours sur les frameworks web JavaScript.

- Awesome Vue.js : la page Awesome Github pour Vue.js.