installation.md

title	type	order	vue_version	dev_size	min_size	gz_size	ro_gz_size
Installation	guide	1	2.1.6	212.24	69.33	25.39	17.67

Compatibilité

Vue ne supporte pas IE8 et les versions antérieures, car il utilise des fonctionnalités ECMAScript 5 qui ne peuvent pas être émulées sur IE8. Cela dit, Vue supporte tous les navigateurs compatibles ECMAScript 5.

Notes de version

Les notes de version détaillées pour chaque version sont disponibles sur GitHub.

Standalone

Il suffit de télécharger et de l'inclure avec une balise script. Vue sera déclaré comme une variable globale.

N'utilisez pas la version minifiée pendant le développement car vous ne bénéficieriez alors pas des avertissements pour les erreurs courantes !

Version de développementAvec tous les avertissements et le mode de débogage

Version de productionAvertissements retirés, {{gz_size}}ko min+gzip

CDN

Recommandé: unpkg, qui reflète la dernière version aussitôt qu'elle est publiée sur NPM. Vous pouvez également parcourir la source du package NPM sur unpkg.com/vue/.

Également disponible sur jsdelivr ou cdnjs, mais ces deux services mettent du temps à se synchroniser ce qui signifie que la dernière version peut ne pas être encore disponible.

NPM

NPM est la méthode d'installation recommandée lors du développement d'applications à grande échelle avec Vue. Il s'associe bien avec des empaqueteurs de modules comme Webpack ou Browserify. Vue fournit également des outils d'accompagnement pour la rédaction de Composants Mono-fichier.

# latest stable
$ npm install vue

Standalone vs. Runtime

Il y a deux builds disponibles le build standalone et le build runtime. La différence vient du fait que le premier inclut le compilateur de template alors que le second ne l'inclut pas.

Le compilateur de template se charge de compiler les chaînes littérales de template Vue en pure fonction de rendu JavaScript. Si vous souhaitez utiliser l'option template, alors vous aurez besoin du compilateur.

• Le build standalone inclut le compilateur et supporte l'option template. Il s'appuie également sur les APIs navigateurs, ce qui signifie que vous ne pouvez pas l'utiliser pour du rendu côté serveur.

• Le build runtime n'inclut pas le compitateur de template, et ne supporte pas l'option template. Vous pouvez seulement utiliser l'option render quand vous utilisez le build runtime, mais il fonctionne avec des composants monofichiers, car les templates de composants monofichiers sont pré-compilés dans render pendant l'étape de build. Le build runtime est à peu près 30% plus léger que le build standalone, l'amenant seulement à {{ro_gz_size}}ko min+gzip.

Par défaut, c'est le build runtime qui est exporté par le package NPM. Pour utiliser le build standalone, il faut ajouter l'alias suivant dans la configuration Webpack :

resolve: {
  alias: {
    'vue$': 'vue/dist/vue.common.js'
  }
}

Pour Browserify, vous pouvez ajouter un alias dans votre package.json :

"browser": {
  "vue": "vue/dist/vue.common"
},

Ne faites PAS `import Vue from 'vue/dist/vue.js'` — en effet, certains outils ou bibliothèques tierces peuvent également importer Vue, ce qui peut forcer l'app à charger conjointement les builds runtime et standalone et mener à des erreurs.

Environnements CSP

Certains environnements, tels que les Applications de Google Chrome, font respecter la politique de sécurité de contenu (Content Security Policy - CSP), qui ne permet pas l'utilisation de new Function() pour évaluer les expressions. Le build standalone a besoin de cette fonctionnalité pour compiler les templates, elle n'est donc pas utilisable dans ces environnements.

D'un autre côté, le build runtime respecte pleinement CSP. Quand vous utilisez le build runtime avec Webpack + vue-loader ou Browserify + vueify, vos templates vont être pré-compilé dans les fonctions render qui fonctionnent parfaitement dans des environnements CSP.

CLI

Vue.js offre une interface en ligne de commande officielle pour mettre rapidement en place les bases d'applications monopages ambitieuses. Il offre une série de builds pré-configurés pour un workflow Front-end moderne. Cela ne prends que quelques minutes pour commencer et lancer des rechargements à chaud, de l'analyse syntaxique à la sauvegarde, et des builds prêt pour la production :

# installer vue-cli
$ npm install --global vue-cli
# créer un nouveau projet en utilisant le template "webpack"
$ vue init webpack my-project
# installer les dépendances et go !
$ cd my-project
$ npm install
$ npm run dev

Utiliser la CLI nécessite des connaissances préalables en Node.js et les outils de build associés. Si vous êtes nouveau sur Vue ou les outils de build front-end, nous vous recommandons fortement de parcourir le guide sans aucun outil de build avant d'utiliser l'interface CLI.

Build de développement

Important: les fichiers générés dans le dossier /dist sur GitHub sont seulement vérifiés lors des releases. Pour utiliser la dernière version du code source de Vue sur GitHub, vous aurez à lancer le build vous-même !

git clone https://github.com/vuejs/vue.git node_modules/vue
cd node_modules/vue
npm install
npm run build

Bower

# latest stable
$ bower install vue

Chargeurs de module AMD

Les versions standalone ou installées via Bower sont encapsulés selon UMD ce qui permet de directement les utiliser sous forme de module AMD.