Commandes et instructions courantes que vous utiliserez dans vos sessions de codage Vue.js quotidiennes
- Directives
- Travailler avec des éléments de formulaire
- Modifier les événements
- Modificateurs d'événements de souris
- Soumettre un événement uniquement si une touche particulière est enfoncée
- Modificateurs d'événements de clavier
- Crochets de cycle de vie
- Composants intégrés
- Configuration globale de l'objet Vue
- Méthodes de l'objet Vue
- Options passées à un objet Vue
- Propriétés de l'instance
Directives
Les directives sont des attributs identifiés par lev-
préfixe.
Directif | Description |
---|---|
v-text |
utilise la propriété comme valeur de texte de l'élément |
v-html |
utilise la propriété comme valeur de texte de l'élément, interprétant le HTML |
v-if |
afficher un élément uniquement si le conditionnel est vrai |
v-else |
montre un élément alternatif si le précédentv-if c'est faux |
v-else-if |
ajoute un bloc else if pour unv-if construction |
v-show |
semblable àv-if , mais ajoute l'élément au DOM même s'il est faux. Réglez-le simplement surdisplay: none . |
v-for |
itère sur un tableau ou un objet itérable |
v-on |
écouter les événements DOM |
v-bind |
mettre à jour de manière réactive un attribut HTML |
v-model |
met en place une liaison bidirectionnelle pour les entrées de formulaire. utilisé dans les éléments de formulaire, met à jour le modèle lorsque l'utilisateur modifie la valeur du champ de formulaire |
v-once |
applique la propriété une seule fois et ne la rafraîchit jamais même si les données transmises changent |
v-bind
etv-on
ont un format abrégé:
<a v-bind:href="url">...</a>
<a :href="url">...</a>
<a v-on:click="doSomething">...</a>
<a @click="doSomething">...</a>
Exemple dev-if
/v-else
/v-else-if
:
<div v-if="type === 'A'">
it's A
</div>
<div v-else-if="type === 'B'">
it's B
</div>
<div v-else-if="type === 'C'">
it's C
</div>
<div v-else>
it's neither one
</div>
Conditionnels
Vous pouvez incorporer un conditionnel dans une expression à l'aide de l'opérateur ternaire:
{{ isTrue ? 'yes' : 'no' }}
Travailler avec des éléments de formulaire
Pour effectuer la mise à jour du modèle lorsque l'événement de modification se produit, et non à chaque fois que l'utilisateur appuie sur une touche, vous pouvez utiliserv-model.lazy
au lieu de justev.model
.
Travailler avec les champs de saisie,v-model.trim
est utile car il supprime automatiquement les espaces.
Et si vous acceptez un nombre au lieu d'une chaîne, assurez-vous d'utiliserv-model.number
.
Modifier les événements
j'utiliseclick
à titre d'exemple, mais s'applique à tous les événements possibles
v-on:click.native
déclencher un événement DOM natif au lieu d'un événement Vuev-on:click.stop
arrêter la propagation de l'événement de clicv-on:click.passive
utilise leoption passive de addEventListenerv-on:click.capture
utiliser la capture d'événements au lieu de la création de bullesv-on:click.self
assurez-vous que l'événement de clic ne provient pas d'un événement enfant, mais s'est produit directement sur cet élémentv-on:click.once
l'événement ne sera déclenché qu'une seule foisv-on:submit.prevent
: appelerevent.preventDefault()
sur l'événement d'envoi déclenché, utilisé pour éviter l'envoi d'un formulaire pour recharger la page
Pour en savoir plus sur la propagation, le bouillonnement / la capture, consultez monGuide des événements JavaScript.
Modificateurs d'événements de souris
v-on:click .left
se déclenche uniquement par un clic gauchev-on:click .right
se déclenche uniquement en cliquant avec le bouton droit de la sourisv-on:click .middle
se déclenche uniquement en cliquant sur le bouton central de la souris
Soumettre un événement uniquement si une touche particulière est enfoncée
v-on:keyup.enter
v-on:keyup.tab
v-on:keyup.delete
v-on:keyup.esc
v-on:keyup.up
v-on:keyup.down
v-on:keyup.left
v-on:keyup.right
Modificateurs d'événements de clavier
Ne déclenchez l'événement que si une touche du clavier particulière est également enfoncée:
.ctrl
.alt
.shift
.meta
(cmd sur Mac, touche Windows sur Win)
v-bind
v-bind .prop
lier un accessoire au lieu d'un attributv-bind .camel
utilisez camelCase pour le nom d'attributv-bind .sync
un sucre syntaxique qui se développe en unv-on
gestionnaire pour mettre à jour la valeur liée. Voirce.
Crochets de cycle de vie
beforeCreate
appelé avant la création de l'applicationcreated
appelé après la création de l'applicationbeforeMount
appelé avant que l'application ne soit montée sur le DOMmounted
appelé après le montage de l'application sur le DOMbeforeDestroy
appelé avant que l'application ne soit détruitedestroyed
appelé après la destruction de l'applicationbeforeUpdate
appelé avant la mise à jour d'une propriétéupdated
appelé après la mise à jour d'une propriétéactivated
appelé lorsqu'un composant maintenu en vie est activédeactivated
appelé lorsqu'un composant maintenu en vie est désactivé
Composants intégrés
Vue fournit 5 composants intégrés:
<component>
<transition>
<transition-group>
<keep-alive>
<slot>
Configuration globale de l'objet Vue
LeVue.config
object possède ces propriétés, que vous pouvez modifier lorsque vous créez l'instance:
Biens | Description |
---|---|
silent |
la valeur par défaut est false, si true supprime les journaux et les avertissements |
optionMergeStrategies |
permet de définir unstratégie de fusion personnaliséepour les options |
devtools |
La valeur par défaut est true en développement et false en production. Vous pouvez remplacer ces valeurs. |
errorHandler |
permet de définir une fonction de gestionnaire d'erreurs. Utile pour accrocher Sentry et d'autres services similaires |
warnHandler |
permet de définir une fonction de gestionnaire d'avertissement, similaire àerrorHandler , mais pour des avertissements plutôt que des erreurs |
ignoredElements |
utilisé pour laisser Vue ignorer les éléments personnalisés définis en dehors de celui-ci, commeComposants Web. |
keyCodes |
vous permettent de définir des alias de clé personnalisés pourv-on |
performance |
la valeur par défaut est false. S'il est défini sur true, retrace les performances des composants Vue dans le navigateur DevTools. |
productionTip |
la valeur par défaut est true. Définissez sur false pour désactiver l'avertissement «vous êtes en mode développement» pendant le développement dans la console. |
Méthodes de l'objet Vue
Méthode | Description |
---|---|
Vue.extend |
permet de sous-classer l'objet Vue, de créer un profil personnalisé |
Vue.nextTick |
reporte le rappel à exécuter après le prochain cycle de mise à jour du DOM |
Vue.set |
ajouter une propriété à l'objet |
Vue.delete |
supprimer une propriété de l'objet |
Vue.directive |
définir (ou obtenir) une directive globale |
Vue.filter |
définir (ou obtenir) un filtre global |
Vue.component |
définir (ou obtenir) un composant global |
Vue.use |
installer un plugin Vue.js |
Vue.mixin |
définir un mixin global |
Vue.compile |
compiler une chaîne de modèle dans une fonction de rendu |
Vue.version |
renvoie la version actuellement installée de Vue |
Options passées à un objet Vue
Lors de l'initialisation d'un objet Vue, vous passez un objet:
const vm = new Vue({
})
Cet objet accepte un certain nombre de propriétés.
Biens | Description |
---|---|
data |
permet de transmettre un ensemble de données réactives qui seront utilisées par l'application Vue. Toutes les propriétés réactives doivent être ajoutées au moment de l'initialisation, vous ne pouvez pas en ajouter de nouvelles ultérieurement. |
props |
c'est un ensemble d'attributs qui sont exposés aux composants parents en tant que données d'entrée. |
propsData |
données par défaut pour les accessoires. Seulement utile pendant les tests |
methods |
un ensemble de méthodes définies sur l'instance Vue |
computed |
comme les méthodes, mais mis en cache en interne |
watch |
permet de regarder les propriétés et d'appeler une fonction lorsqu'elles changent |
Exemple de définition de données, méthodes et propriétés calculées:
var vm = new Vue({
el: '#example',
data: {
message: 'Hello'
},
methods: {
reverseMessageAsMethod: function () {
return this.message.split('').reverse().join('')
}
},
computed: {
// a computed getter
reversedMessage: function () {
// `this` points to the vm instance
return this.message.split('').reverse().join('')
}
}
})
console.log(vm.reverseMessageAsMethod) // => ‘olleH’
vm.message = ‘Goodbye’
console.log(vm.reversedMessage) // => ‘eybdooG’
DOM
el
définit l'élément DOM sur lequel l'instance se monte. Cela peut être un sélecteur CSS ou un HTMLElementtemplate
est un modèle, représenté sous forme de chaîne, qui remplacera l'élément montérender
ou pour définir le modèle, vous pouvez définir un modèle à l'aide d'une fonction de rendurenderError
définir une sortie alternative lorsque la fonction associée àrender
échoue
Actifs de l'instance Vue
directives
l'ensemble des directives à associer à l'instance Vuefilters
l'ensemble de filtres à associer à l'instance Vuecomponents
l'ensemble des composants à associer à l'instance Vue
Options de composition de la vue
parent
spécifie l'instance parentemixins
définit un tableau d'objets mixinextends
étendre un autre composant
Autres options d'objet Vue
name
attribuer un nom au composant vous permet de l'invoquer, utile dans le débogage ou lorsque vous avez besoin d'ajouter de manière récursive un composant dans son modèlefunctional
si true, définit le composant comme étant sans état (nondata
) et sans instanc (nonthis
), ce qui le rend plus légermodel
permet de personnaliser la propriété utilisée dans les événements, utile par exemple lors de l'interaction avec les formulairescomments
la valeur par défaut est false. S'il est défini sur true, conserve les commentaires HTML placés dans les modèles
Propriétés de l'instance
Étant donné une instance de Vue, stockée dans une variableconst vm = new Vue(/*...*/)
, vous pouvez l'inspecter et interagir avec elle.
Propriétés d'une instance de Vue
vm.$data
l'objet de données associé à l'instancevm.$props
les accessoires que l'instance a reçusvm.$el
l'élément DOM auquel l'instance est liéevm.$options
l'objet utilisé pour instancier l'instance Vuevm.$parent
l'instance parentevm.$root
l'instance racine (s'il s'agit de l'instance racine, celle-ci pointe vers elle-même)vm.$children
un tableau d'instances enfantsvm.$slots
un tableau des emplacements associés contenus dans le modèlevm.$scopedSlots
un tableau des emplacements de portée associésvm.$refs
un objet qui contient une propriété pour chaque élément pointé par unref
attribut défini dans le modèlevm.$isServer
true si l'instance Vue est en cours d'exécution sur le serveur (utile dans le rendu côté serveur)vm.$attrs
un objet d'attributs fournis au composant mais non définis comme accessoiresvm.$listeners
un objet dev-on
écouteurs d'événements affectés au composant
Données sur les méthodes
vm.$watch
configurer un observateur pour les changements de propriété dans les données Vue. Il peut également surveiller les changements de valeur à l'intérieur des objetsvm.$set
définir une propriétévm.$delete
supprimer une propriété
Événements
vm.$emit
déclenche un événement personnalisé sur levm
Instance Vuevm.$on
écouter un événement personnalisé sur levm
Instance Vuevm.$once
aimer$on
, mais n'écoute qu'une seule foisvm.$off
supprime un écouteur d'événement de l'instance Vue
Méthodes du cycle de vie
vm.$mount
monter une instance Vue sur un élément DOM, au cas où elle n'aurait pas encore été montéevm.$forceUpdate
forcer levm
Instance Vue à restituer. Ne force pas le rendu des composants enfants.vm.$nextTick
accepte un rappel et planifie cela pour le prochain cycle de mise à jour du DOMvm.$destroy
détruit l'application et supprime tous les composants enfants, observateurs et écouteurs
Téléchargez mon gratuitManuel de Vue
Plus de tutoriels vue:
- Un aperçu de Vue.js
- La CLI Vue.js: apprenez à l'utiliser
- Les DevTools Vue.js
- Configurer VS Code pour le développement Vue
- Créez votre première application avec Vue.js
- Composants de fichier unique Vue.js
- Modèles et interpolations Vue.js
- Directives Vue.js
- Méthodes Vue.js
- Propriétés calculées Vue.js
- Styliser les composants Vue.js à l'aide de CSS
- Observateurs Vue.js
- Méthodes Vue vs observateurs vs propriétés calculées
- Filtres Vue.js
- Composants Vue.js
- Machines à sous Vue.js
- Accessoires de composants Vue.js
- Événements Vue.js
- Communication des composants Vue.js
- Vuex, le gestionnaire d'état de Vue.js
- Vue, utilisez un composant à l'intérieur d'un autre composant
- Vue, comment utiliser un accessoire comme nom de classe
- Comment utiliser SCSS avec les composants de fichier unique Vue.js
- Utilisation de Tailwind avec Vue.js
- Le routeur Vue
- Afficher dynamiquement un composant Vue
- La feuille de triche Vue.js
- Stocker les données Vue sur localStorage à l'aide de Vuex
- Comment appliquer dynamiquement une classe à l'aide de Vue
- Vue, comment utiliser v-model
- Vue, pourquoi les données doivent être une fonction
- Roadmap to become a Vue.js developer in 2020