Syntaxe de template Vue.js

Vue.js utilise une syntaxe de template basée sur HTML qui permet aux développeurs de lier de manière déclarative le DOM aux données de l'instance Vue sous-jacente.

Le cœur de Vue.js est un système qui vous permet de rendre des données dans le DOM de manière déclarative en utilisant une syntaxe de template simple.

Combiné au système de réactivité, lorsque l'état de l'application change, Vue peut calculer intelligemment le coût minimal de re-rendu des composants et l'appliquer aux opérations DOM.


Interpolation

Texte

La forme la plus courante de liaison de données est l'interpolation de texte à l'aide de {{...}} (doubles accolades) :

Interpolation de texte

<div id="app"> <p>{{ message }}</p> </div>

Essayez-le vous-même »

Html

Utilisez la directive v-html pour afficher du code HTML :

Directive v-html

<div id="app"> <div v-html="message"></div> </div> <script> new Vue({ el: '#app', data: { message: '<h1>Exemple</h1>' } }) </script>

Essayez-le vous-même »

Attributes

Les valeurs dans les attributs HTML doivent utiliser la directive v-bind.

L'exemple suivant vérifie la valeur de use ; si elle est vraie, il applique le style class1, sinon il n'utilise pas cette classe :

Directive v-bind

<div id="app"> <label for="r1">Changer la couleur</label><input type="checkbox" v-model="use" id="r1"> <br><br> <div v-bind:class="{'class1': use}">Directive v-bind:class</div> </div> <script> new Vue({ el: '#app', data:{ use: false } }); </script>

Essayez-le vous-même »

Expressions

Vue.js offre un support complet pour les expressions JavaScript.

Expressions JavaScript

<div id="app"> {{5+5}}<br> {{ ok ? 'YES' : 'NO' }}<br> {{ message.split('').reverse().join('') }} <div v-bind:id="'list-' + id">Exemple</div> </div> <script> new Vue({ el: '#app', data: { ok: true, message: 'EXAMPLE', id : 1 } }) </script>

Essayez-le vous-même »

Directives

Les directives sont des attributs spéciaux avec le préfixe v-.

Les directives sont utilisées pour appliquer certains comportements au DOM lorsque la valeur de l'expression change. Exemple :

Exemple

<div id="app"> <p v-if="seen">Maintenant vous me voyez</p> </div> <script> new Vue({ el: '#app', data: { seen: true } }) </script>

Essayez-le vous-même »

Ici, la directive v-if décidera s'il faut insérer l'élément p en fonction de la valeur de l'expression seen (true ou false).

Arguments

Les arguments sont indiqués par un deux-points après la directive. Par exemple, la directive v-bind est utilisée pour mettre à jour de manière réactive un attribut HTML :

Exemple

<div id="app"> <pre><a v-bind:href="url">Exemple</a></pre> </div> <script> new Vue({ el: '#app', data: { url: 'http://www.example.com' } }) </script>

Essayez-le vous-même »

Ici, href est l'argument, indiquant à la directive v-bind de lier l'attribut href de l'élément à la valeur de l'expression url.

Un autre exemple est la directive v-on, qui est utilisée pour écouter les événements DOM :

<a v-on:click="doSomething">

Ici, l'argument est le nom de l'événement écouté.

Modificateurs

Les modificateurs sont indiqués par un point demi-largeur.suffixes spéciaux, utilisés pour indiquer qu'une directive doit être liée d'une manière spéciale. Par exemple,.preventLe modificateur indique àv-onà la directive d'appeler sur l'événement déclenchéevent.preventDefault():

<form v-on:submit.prevent="onSubmit"></form>

Entrée utilisateur

Dans le champ de saisie, nous pouvons utiliser la directive v-model pour réaliser une liaison de données bidirectionnelle :

Liaison de données bidirectionnelle

<div id="app"> <p>{{ message }}</p> <input v-model="message"> </div> <script> new Vue({ el: '#app', data: { message: 'Example!' } }) </script>

Essayez-le vous-même »

v-modelLa directive est utilisée pour créer une liaison de données bidirectionnelle sur les éléments de contrôle de formulaire tels que input, select, textarea, checkbox, radio, etc., et met automatiquement à jour la valeur de l'élément lié en fonction de la valeur dans le formulaire.

Pour les événements de bouton, nous pouvons utiliser v-on pour écouter les événements et répondre aux entrées de l'utilisateur.

L'exemple suivant inverse la chaîne après que l'utilisateur a cliqué sur le bouton :

Inversion de chaîne

<div id="app"> <p>{{ message }}</p> <button v-on:click="reverseMessage">Inverser la chaîne</button> </div> <script> new Vue({ el: '#app', data: { message: 'Example!' }, methods: { reverseMessage: function () { this.message = this.message.split('').reverse().join('') } } }) </script>

Essayez-le vous-même »

Filtres

Vue.js vous permet de définir des filtres personnalisés, qui sont utilisés pour un formatage de texte courant. Indiqué par le "symbole pipe", le format est le suivant :

<!-- 在两个大括号中 -->
{{ message | capitalize }}

<!-- 在 v-bind 指令中 -->
<div v-bind:id="rawId | formatId"></div>

La fonction de filtre accepte la valeur de l'expression comme premier argument.

L'exemple suivant met en majuscule la première lettre de la chaîne d'entrée :

Exemple

<div id="app"> {{ message | capitalize }} </div> <script> new Vue({ el: '#app', data: { message: 'example' }, filters: { capitalize: function (value) { if (!value) return '' value = value.toString() return value.charAt(0).toUpperCase() + value.slice(1) } } }) </script>

Essayez-le vous-même »

Les filtres peuvent être chaînés :

{{ message | filterA | filterB }}

Les filtres sont des fonctions JavaScript, ils peuvent donc accepter des arguments :

{{ message | filterA('arg1', arg2) }}

Ici, message est le premier argument, la chaîne 'arg1' sera passée au filtre comme deuxième argument, et la valeur de l'expression arg2 sera évaluée puis passée au filtre comme troisième argument.


Raccourcis

Raccourci v-bind

Vue.js fournit des raccourcis spéciaux pour les deux directives les plus couramment utilisées :

<!-- 完整语法 -->
<a v-bind:href="url.html"></a>
<!-- 缩写 -->
<a :href="url.html"></a>

Raccourci v-on

<!-- 完整语法 -->
<a v-on:click="doSomething"></a>
<!-- 缩写 -->
<a @click="doSomething"></a>
Autres extensions