diff --git a/src/v2/api/index.md b/src/v2/api/index.md index 663d5f37a6..81e6babb62 100644 --- a/src/v2/api/index.md +++ b/src/v2/api/index.md @@ -84,7 +84,7 @@ type: api > En 2.4.0+ ce hook capture également les erreurs lancées depuis un gestionnaire d'évènement Vue personnalisé. - > $todo In 2.6.0+, this hook also captures errors thrown inside `v-on` DOM listeners. In addition, if any of the covered hooks or handlers returns a Promise chain (e.g. async functions), the error from that Promise chain will also be handled. + > En 2.6.0+, ce hook capture également les erreurs lancées depuis les écouteurs de DOM `v-on`. De plus, si les hooks couverts ou gestionnaires retournent une chaine de Promesse (par exemple les fonctions async), l'erreur sera également remontée depuis cette Promesse. > [Sentry](https://sentry.io) et [Bugsnag](https://docs.bugsnag.com/platforms/browsers/vue/) fournissent une intégration officielle utilisant cette option. @@ -261,7 +261,7 @@ type: api

L'objet ne peut pas être une instance de Vue, ou l'objet de données à la racine d'une instance de Vue.

-- **Voir aussi :** [Réactivité dans le détail](../guide/reactivity.html) +- **Voir aussi :** [Réactivité en détail](../guide/reactivity.html) ### Vue.delete( cible, clé ) @@ -277,7 +277,7 @@ type: api

L'objet cible ne peut pas être une instance de Vue, ou l'objet de données à la racine d'une instance de Vue.

-- **Voir aussi :** [Réactivité dans le détail](../guide/reactivity.html) +- **Voir aussi :** [Réactivité en détail](../guide/reactivity.html) ### Vue.directive( id, [définition] ) @@ -404,18 +404,18 @@ type: api - **Voir aussi :** [Fonctions de rendu](../guide/render-function.html) -### $todo Vue.observable( object ) +### Vue.observable( object ) -> New in 2.6.0+ +> Nouveau en 2.6.0+ -- **Arguments:** +- **Arguments :** - `{Object} object` -- **Usage:** +- **Utilisation :** - Make an object reactive. Internally, Vue uses this on the object returned by the `data` function. + Rend un objet réactif. En interne, Vue l'utilise sur l'objet retourné par la fonction `data`. - The returned object can be used directly inside [render functions](../guide/render-function.html) and [computed properties](../guide/computed.html), and will trigger appropriate updates when mutated. It can also be used as a minimal, cross-component state store for simple scenarios: + L'objet retourné peut être directement utilisé à l'intérieur des [fonctions de rendu](../guide/render-function.html) ainsi que des [propriétés calculées](../guide/computed.html). Il déclenchera les mises à jour appropriées lors de mutations. Il peut également être utilisé comme un store minimal intercomposant dans des scénarios basiques : ``` js const state = Vue.observable({ count: 0 }) @@ -424,14 +424,14 @@ type: api render(h) { return h('button', { on: { click: () => { state.count++ }} - }, `count is: ${state.count}`) + }, `le compteur est : ${state.count}`) } } ``` -

In Vue 2.x, `Vue.observable` directly mutates the object passed to it, so that it is equivalent to the object returned, as [demonstrated here](../guide/instance.html#Data-and-Methods). In Vue 3.x, a reactive proxy will be returned instead, leaving the original object non-reactive if mutated directly. Therefore, for future compatibility, we recommend always working with the object returned by `Vue.observable`, rather than the object originally passed to it.

+

Dans Vue 2.x, `Vue.observable` mute directement l'objet qui lui est transmis, de sorte qu'il soit équivalent à l'objet renvoyé, comme [démontré ici](../guide/instance.html#Donnees-et-methodes). Dans Vue 3.x, un proxy réactif sera retourné à la place, laissant l'objet original non réactif s'il est muté directement. Cependant, pour de futures compatibilités, nous recommandons toujours de travailler avec l'objet retourné par `Vue.observable`, au lieu de l'objet originel.

-- **See also:** [Reactivity in Depth](../guide/reactivity.html) +- **Voir aussi :** [Réactivité en détail](../guide/reactivity.html) ### Vue.version @@ -499,7 +499,7 @@ type: api data: vm => ({ a: vm.myProp }) ``` -- **Voir aussi :** [Réactivité dans le détail](../guide/reactivity.html) +- **Voir aussi :** [Réactivité en détail](../guide/reactivity.html) ### props @@ -509,14 +509,14 @@ type: api Une liste ou un objet décrivant les attributs exposés par le composant afin de passer des données depuis le composant parent. Ce paramètre a une syntaxe simple basée sur un tableau (`Array`) et une syntaxe alternative basée sur un objet (`Object`) qui permet une configuration avancée telle qu'une vérification de typage, des contrôles de validation personnalisés et des valeurs par défaut. - $todo With Object-based syntax, you can use following options: - - **type:** can be one of the following native constructors: `String`, `Number`, `Boolean`, `Array`, `Object`, `Date`, `Function`, `Symbol`, any custom constructor function or an array of those. Will check if a prop has a given type, and will throw a warning if it doesn't. [More information](../guide/components-props.html#Prop-Types) on prop types. + Avec la syntaxe objet, vous pouvez passer les options suivantes : + - Le **type** peut être l'un des constructeurs natifs suivants : `String`, `Number`, `Boolean`, `Array`, `Object`, `Date`, `Function`, `Symbol` ainsi que n'importe quelle fonction de construction ou tableau de ces types. Les types des props seront vérifiés. Un avertissement sera fourni si une prop n'est pas du bon type. [Plus d'information](../guide/components-props.html#Types-des-props) sur les types des props. - **default:** `any` - Specifies a default value for the prop. If the prop is not passed, this value will be used instead. Object or array defaults must be returned from a factory function. + Spécifie la valeur par défaut de la prop. Si la prop n'est pas passée, cette valeur sera utilisée à la place. Les objets ou tableaux par défaut doivent être retournés depuis une fonction de fabrique. - **required:** `Boolean` - Defines if the prop is required. In a non-production environment, a console warning will be thrown if this value is truthy and the prop is not passed. + Définie si la prop est requise. Dans un environnement autre que de production, un avertissement sera affiché dans la console si cette valeur est évaluée à vrai et que la prop n'est pas passée. - **validator:** `Function` - Custom validator function that takes the prop value as the sole argument. In a non-production environment, a console warning will be thrown if this function returns a falsy value (i.e. the validation fails). You can read more about prop validation [here](../guide/components-props.html#Prop-Validation). + Une fonction de validation personnalisée qui prend la valeur de prop comme seul argument. Dans un environnement autre que de production, un avertissement sera affiché dans la console si cette fonction retourne une valeur évaluée à faux. (c.-à-d. que la validation a échoué). Vous pouvez en lire plus à propos de la validation des props [ici](../guide/components-props.html#Validation-des-props). - **Exemple :** @@ -1441,11 +1441,11 @@ type: api Accéder à `vm.$scopedSlots` est surtout utile lors de l'écriture d'un composant avec une [fonction de rendu](../guide/render-function.html). - **$todo Note:** since 2.6.0+, there are two notable changes to this property: + **Note :** depuis la 2.6.0+, il y a deux changements notables pour cette propriété : - 1. Scoped slot functions are now guaranteed to return an array of VNodes, unless the return value is invalid, in which case the function will return `undefined`. + 1. Les fonctions de slot avec portée garantissent de retourner un tableau de VNodes, sauf si la valeur de retour est invalide, auquel cas la fonction retournera `undefined`. - 2. All `$slots` are now also exposed on `$scopedSlots` as functions. If you work with render functions, it is now recommended to always access slots via `$scopedSlots`, whether they currently use a scope or not. This will not only make future refactors to add a scope simpler, but also ease your eventual migration to Vue 3, where all slots will be functions. + 2. Tous les `$slots` sont maintenant exposés via `$scopedSlots` en tant que fonctions. Si vous travaillez avec des fonctions de rendu, il est maintenant recommandé de toujours accéder aux slots via `$scopedSlots`, si elles utilisent actuellement une portée ou non. Cela ne va pas seulement permettre d'ajouter des scopes simplement lors de futures refactorisations, mais également de faciliter votre éventuelle migration vers Vue 3, où tous les slots seront des fonctions. - **Voir aussi :** - [Composant ``](#slot-1) @@ -2022,7 +2022,7 @@ type: api ``` - $todo In 2.6+, `v-for` can also work on values that implement the [Iterable Protocol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterable_protocol), including native `Map` and `Set`. However, it should be noted that Vue 2.x currently does not support reactivity on `Map` and `Set` values, so cannot automatically detect changes. + En 2.6+, `v-for` peut également travailler sur des valeurs qui implémentent le [protocole Iterable](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Les_protocoles_iteration#The_iterable_protocol), incluant les natifs `Map` et `Set`. Cependant, il est à noter que Vue 2.x ne supporte pour le moment pas la réactivité sur les valeurs de `Map` et `Set` et ne pourra pas automatiquement détecter les changements.

Quand utilisé conjointement avec v-if, v-for a une plus grande priorité que v-if. Consultez le guide de rendu de listes pour plus de détails.

@@ -2069,7 +2069,7 @@ type: api - + @@ -2078,7 +2078,7 @@ type: api - + @@ -2151,13 +2151,13 @@ type: api - + - + @@ -2224,39 +2224,39 @@ type: api - [Liaisons sur les champs de formulaire](../guide/forms.html) - [Composants - Composants de champ de formulaire utilisant les évènements personnalisés](../guide/components.html#Composants-de-champ-de-formulaire-utilisant-les-evenements-personnalises) -### $todo v-slot +### v-slot -- **Shorthand:** `#` +- **Notation abrégée :** `#` -- **Expects:** JavaScript expression that is valid in a function argument position (supports destructuring in [supported environments](../guide/components-slots.html#Slot-Props-Destructuring)). Optional - only needed if expecting props to be passed to the slot. +- **Attend comme valeur :** Une expression JavaScript qui est valide a une position d'argument dans une fonction (supporte la décomposition dans les [environments la supportant](../guide/components-slots.html#Décomposition-de-props-de-slot)). Optionnel - seulement nécessaire si le passage des props est attendu par le slot. -- **Argument:** slot name (optional, defaults to `default`) +- **Argument :** nom du slot (optionel, `default` par défaut) -- **Limited to:** +- **Limité à :** - `