From 066f94bd6fbecb0c695313dadc3b3a635cbcbb1a Mon Sep 17 00:00:00 2001 From: loris Date: Sun, 16 Jan 2022 10:33:26 +0100 Subject: [PATCH 1/2] docs: update french router-link api --- docs/fr/api/README.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/docs/fr/api/README.md b/docs/fr/api/README.md index 316a62af9..eea8fb70d 100644 --- a/docs/fr/api/README.md +++ b/docs/fr/api/README.md @@ -14,7 +14,31 @@ sidebar: auto - Dans le mode historique HTML5, `router-link` interceptera l'évènement du clic, comme ça le navigateur n'essaiera pas de rafraichir la page. -- En utilisant l'option `base` dans le mode historique HTML5, vous n'avez pas besoin +- En utilisant l'option `base` dans le mode historique HTML5, vous n'avez pas besoin de l'inclure dans la prop `to` + +### `v-slot` API (3.1.0+) + +`router-link` est fortement personnalisable via une [slot avec portée](https://fr.vuejs.org/v2/guide/components-slots.html#Slots-avec-portee). C'est une API qui cible principalement les créateurs de bibliothèque, mais elle peut aussi servir pour les développeurs, le plus souvent dans des composants personnalisés tel qu'un _NavLink_ et autre. + +**Lors de l'utilisation `v-slot` API, il faut obligatoirement passer un composant enfant unique au `router-link`**. Si vous ne le faites pas, `router-link` va entourer ses enfants avec une balise `span`. + +```html + + {{ route.fullPath }} + +``` + +- `href`: URL résolue. Ce serait l'attribut `href` d'une balise `a` +- `route`: localisation normalisée et résolue +- `navigate`: function pour lancer la navigation. **En cas de nécessité il va automatiquement empêcher les événements**, de la même façon que `router-link` +- `isActive`: `true` si [active class](#active-class) devrait être appliqué. Permet d'appliquer une classe arbitraire +- `isExactActive`: `true` si [exact active class](#exact-active-class) devrait être appliqué. Permet d'appliquer une classe arbitraire ### Appliquer la classe active à l'élément extérieur From 21feed7d66039abb25a38beb83534f138a875f2f Mon Sep 17 00:00:00 2001 From: Eduardo San Martin Morote Date: Thu, 27 Jan 2022 12:04:55 +0100 Subject: [PATCH 2/2] Apply suggestions from code review --- docs/fr/api/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/fr/api/README.md b/docs/fr/api/README.md index eea8fb70d..0006b0dbc 100644 --- a/docs/fr/api/README.md +++ b/docs/fr/api/README.md @@ -34,9 +34,9 @@ sidebar: auto ``` -- `href`: URL résolue. Ce serait l'attribut `href` d'une balise `a` +- `href`: URL résolue. Ce serait l'attribut `href` d'une balise `a` - `route`: localisation normalisée et résolue -- `navigate`: function pour lancer la navigation. **En cas de nécessité il va automatiquement empêcher les événements**, de la même façon que `router-link` +- `navigate`: fonction pour lancer la navigation. **En cas de nécessité il va automatiquement empêcher les événements**, de la même façon que `router-link` - `isActive`: `true` si [active class](#active-class) devrait être appliqué. Permet d'appliquer une classe arbitraire - `isExactActive`: `true` si [exact active class](#exact-active-class) devrait être appliqué. Permet d'appliquer une classe arbitraire