Accueil › Vue.js › Directives personnalisées et leur juste place
Directives personnalisées et leur juste place
Patterns de compositionavance
Une directive personnalisée est un objet de crochets qui reçoit un élément du DOM. C'est son unique raison d'être : donner accès au nœud natif, au bon moment, sans que l'appelant déclare une référence de modèle.
<script setup>
const vFocus = {
mounted(el) { el.focus() }
}
</script>
<template>
<input v-focus />
</template>
En <script setup>, une variable nommée vQuelqueChose devient v-quelque-chose
dans le modèle, sans enregistrement. Pour un usage global :
app.directive('focus', { mounted: (el) => el.focus() }).
Les crochets sont ceux du cycle de vie, appliqués à l'élément :
const vMesure = {
created(el, binding) {}, // attributs pas encore posés
beforeMount(el, binding) {}, // avant insertion dans le document
mounted(el, binding) {}, // élément inséré, parent monté après
beforeUpdate(el, binding) {}, // avant le rendu de la mise à jour
updated(el, binding) {}, // après
beforeUnmount(el, binding) {},
unmounted(el, binding) {} // nettoyage obligatoire
}
Le second argument porte ce que l'appelant a écrit : binding.value,
binding.oldValue, binding.arg pour v-nom:arg, binding.modifiers pour
v-nom.mod.
La règle de choix tient en une phrase : si la logique n'a pas besoin du nœud, ce n'est pas une directive, c'est un composable.
Les termes à connaître
- Directive personnalisée
Un objet de crochets appliqué à un élément avec
v-nom. Elle sert à réutiliser un accès bas niveau au DOM, pas à composer de la logique métier.- Crochets de directive
created,beforeMount,mounted,beforeUpdate,updated,beforeUnmount,unmounted. Chacun reçoit l'élément et un objet de liaison.- Objet de liaison
Deuxième argument des crochets. Il porte
value,oldValue,arg,modifiersetinstance— tout ce que l'appelant a écrit sur la balise.- Raccourci fonction
Passer une fonction au lieu d'un objet installe le même comportement sur
mountedetupdated. Forme courante pour une directive purement visuelle.- Convention vNom
En
<script setup>, une variable nomméevFocusest automatiquement disponible commev-focusdans le modèle, sans enregistrement.- Directive sur composant
Une directive posée sur un composant s'applique à son élément racine. Elle est ignorée, avec un avertissement, si le composant rend un fragment.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.