Formations — 1 037 leçons en français

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, modifiers et instance — 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 mounted et updated. Forme courante pour une directive purement visuelle.

Convention vNom

En <script setup>, une variable nommée vFocus est automatiquement disponible comme v-focus dans 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.

Lire l'explication détaillée et faire le quiz →

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.