Skip to content

Traduction de custom-directive.md #68

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 1, 2017
Merged

Traduction de custom-directive.md #68

merged 5 commits into from
Jul 1, 2017

Conversation

MachinisteWeb
Copy link
Member

@MachinisteWeb MachinisteWeb commented Jun 17, 2017

La prochaine page à devoir être traduit dans l'ordre des traductions du guide.

Copy link

@forresst forresst left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quelques remarques ...


<p class="tip">**Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vuejs.org).**</p><p>In addition to the default set of directives shipped in core (`v-model` and `v-show`), Vue also allows you to register your own custom directives. Note that in Vue 2.0, the primary form of code reuse and abstraction is components - however there may be cases where you just need some low-level DOM access on plain elements, and this is where custom directives would still be useful. An example would be focusing on an input element, like this one:</p>
En supplément de la palette de directive fournie en standard (`v-model` et `v-show`), Vue vous permet également d'enregistrer vos propres directives. Notez qu'avec Vue 2, la forme de code préféré pour la réutilisabilité et l''abstraction est le composant. Il y a cependant des cas où vous aurez juste besoin d'un accès de bas niveau aux éléments du DOM, et c'est là que les directives personnalisées vous seraient utiles. Un exemple pourrait être la prise du focus sur un élément de champ, comme celui-ci :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

l'abstraction est le composant

une seule apostrophe

@@ -24,69 +24,69 @@ new Vue({
</script>
{% endraw %}

When the page loads, that element gains focus (note: autofocus doesn't work on mobile Safari). In fact, if you haven't clicked on anything else since visiting this page, the input above should be focused now. Now let's build the directive that accomplishes this:
Quand la page charge, cet élément prend le focus (notez que l'autofocus ne fonctionne pas sur Safari mobile). En fait, si vous n'avez cliqué sur rien du tout depuis votre arrivée sur la page, le champ ci-dessous devrait avoir le focus en ce moment même. À présent, jetons un œil à la directive qui pourrait accomplir cela :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

votre arrivée sur la page, le champ ci-dessous devrait avoir le focus en ce moment même.

pas utile, cela parait implicite

el.focus()
}
})
```

If you want to register a directive locally instead, components also accept a `directives` option:
Si vous préférez enregistrer la directive en local à la place, les composants acceptent également l'option `directives` :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Si vous préférez enregistrer à la place la directive en local à la place,


``` html
<input v-focus>
```

## Hook Functions
## Fonction de hook

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fonctions

Au pluriel comme la version anglaise


- `update`: called after the containing component has updated, __but possibly before its children have updated__. The directive's value may or may not have changed, but you can skip unnecessary updates by comparing the binding's current and old values (see below on hook arguments).
- `update`: appelée après que le composant conteneur ai été mis à jour, __mais possiblement avant que ses enfants ai été mis à jour__. La valeur de la directive peut ou pas avoir changé, mais vous pouvez passer les mises à jour non nécessaire en comparant les valeurs couramment liées avec les anciennes valeurs (voir plus bas les arguments de hook).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mais peut-être possiblement avant que ses enfants

mais vous pouvez passer ignorer les mises à jour non nécessaire en comparant les valeurs couramment liées avec les anciennes valeurs inutiles en comparant les valeurs actuelles et anciennes de la liaison

Signed-off-by: Bruno Lesieur <[email protected]>
@MachinisteWeb
Copy link
Member Author

Merci @forresst, c'est top, j'ai tout pris en compte ;)

@MachinisteWeb
Copy link
Member Author

Une seconde review ? @Kocal, @sylvainpolletvillard ?

Copy link
Member

@Kocal Kocal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review partielle parce que j'ai pas trop le temps atm :/


- `update`: called after the containing component has updated, __but possibly before its children have updated__. The directive's value may or may not have changed, but you can skip unnecessary updates by comparing the binding's current and old values (see below on hook arguments).
- `update`: appelée après que le composant conteneur ai été mis à jour, __mais peut-être avant que ses enfants ai été mis à jour__. La valeur de la directive peut ou pas avoir changé, mais vous pouvez ignorer les mises à jour inutiles en comparant les valeurs actuelles et anciennes de la liaison (voir plus bas les arguments de hook).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

__mais peut-être avant que ses enfants soit mis à jour__


- `componentUpdated`: called after the containing component __and its children__ have updated.
- `componentUpdated`: appelée après que le composant conteneur __et ses enfants__ ai été mis à jour.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

soit mis à jour

Signed-off-by: Bruno Lesieur <[email protected]>
@MachinisteWeb
Copy link
Member Author

Merci @Kocal ! Bon pour toi ?

Copy link
Member

@sylvainpolletvillard sylvainpolletvillard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3ème relecture


<p class="tip">**Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vuejs.org).**</p><p>In addition to the default set of directives shipped in core (`v-model` and `v-show`), Vue also allows you to register your own custom directives. Note that in Vue 2.0, the primary form of code reuse and abstraction is components - however there may be cases where you just need some low-level DOM access on plain elements, and this is where custom directives would still be useful. An example would be focusing on an input element, like this one:</p>
En supplément de la palette de directive fournie en standard (`v-model` et `v-show`), Vue vous permet également d'enregistrer vos propres directives. Notez qu'avec Vue 2, la forme de code préféré pour la réutilisabilité et l'abstraction est le composant. Il y a cependant des cas où vous aurez juste besoin d'un accès de bas niveau aux éléments du DOM, et c'est là que les directives personnalisées vous seraient utiles. Un exemple pourrait être la prise du focus sur un élément de champ, comme celui-ci :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

En supplément de l'ensemble de directives fourni par défaut

Notez que dans Vue 2, la forme principale de réutilisabilité du code et d'abstraction est les composants - cependant il peut avoir des cas où vous avez juste besoin

Copy link
Member Author

@MachinisteWeb MachinisteWeb Jun 29, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merci, j'ai mis « directives fournies », me semble que c'est correcte ?

J'ai mis « sont les composants » du coup.

top

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

soit c'est l'ensemble qui est fourni, soit ce sont les directives qui sont fournies. Les deux sont valables.

pour éviter la confusion sur le sujet (la forme sont), il vaut mieux retourner la phrase:
Notez qu'avec Vue 2, les composants sont la forme principale de réutilisabilité et d'asbtraction du code.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Top bis

@@ -24,69 +24,69 @@ new Vue({
</script>
{% endraw %}

When the page loads, that element gains focus (note: autofocus doesn't work on mobile Safari). In fact, if you haven't clicked on anything else since visiting this page, the input above should be focused now. Now let's build the directive that accomplishes this:
Quand la page charge, cet élément prend le focus (notez que l'autofocus ne fonctionne pas sur Safari mobile). En fait, si vous n'avez cliqué sur rien du tout depuis votre arrivée sur la page, le champ ci-dessous devrait avoir le focus. À présent, jetons un œil à la directive qui pourrait accomplir cela :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quand la page se charge


A directive definition object can provide several hook functions (all optional):
Une définition d'objet directive peut fournir plusieurs fonctions de hook (toutes optionnelles) :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Un objet de définition de directive


- `bind`: called only once, when the directive is first bound to the element. This is where you can do one-time setup work.
- `bind` : appelée une fois quand la directive est attachée à l'élément. C'est ici que vous pouvez effectuer les actions uniques d'initialisation.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

une seule fois


- `inserted`: called when the bound element has been inserted into its parent node (this only guarantees parent node presence, not necessarily in-document).
- `inserted`: appelée quand l'élément lié a été inséré dans son nœud parent (cela garanti uniquement sa présence dans le nœud parent, mais pas nécessairement dans le DOM principal).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cela garantit

pas nécessairement dans le document

- **vnode**: The virtual node produced by Vue's compiler. See the [VNode API](../api/#VNode-Interface) for full details.
- **oldVnode**: The previous virtual node, only available in the `update` and `componentUpdated` hooks.
- **el**: L'élément sur lequel la directive est liée. Cela peut être utilisé pour directement manipuler le DOM.
- **binding**: Un objets contenant les propriétés suivantes.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Un objet

- **binding**: Un objets contenant les propriétés suivantes.
- **name**: Le nom de la directive, sans le préfixe `v-`.
- **value**: La valeur passée à la directive. Par exemple dans `v-my-directive="1 + 1"`, la valeur serait `2`.
- **oldValue**: La valeur précédente, seulement disponible dans `update` et `componentUpdated`. Elle est disponible, que la valeur ai changé ou non.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ait changé

- **name**: Le nom de la directive, sans le préfixe `v-`.
- **value**: La valeur passée à la directive. Par exemple dans `v-my-directive="1 + 1"`, la valeur serait `2`.
- **oldValue**: La valeur précédente, seulement disponible dans `update` et `componentUpdated`. Elle est disponible, que la valeur ai changé ou non.
- **expression**: L'expression liée en tant que chaîne de caractère. Par exemple dans `v-my-directive="1 + 1"`, l'expression serait `"1 + 1"`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

chaîne de caractères


In many cases, you may want the same behavior on `bind` and `update`, but don't care about the other hooks. For example:
La plupart du temps, vous souhaiterez un même comportement pour les hooks `bind` et `update`, sans avoir besoin des autres hooks. Par exemple :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dans de nombreux cas, vous pourriez vouloir le même comportement


``` js
Vue.directive('color-swatch', function (el, binding) {
el.style.backgroundColor = binding.value
})
```

## Object Literals
## Objet en tant que valeur

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MachinisteWeb
Copy link
Member Author

Merci @sylvainpolletvillard ! J'ai tout pris (avec le retournement de phrase) !

@MachinisteWeb
Copy link
Member Author

Je peux merge ?!

@Kocal
Copy link
Member

Kocal commented Jul 1, 2017

Je pense que oui ^^

@MachinisteWeb
Copy link
Member Author

Si @sylvainpolletvillard a des petites modifs, je les réinjecterai rétroactivement

@MachinisteWeb MachinisteWeb merged commit 0f7067d into vuejs-fr:master Jul 1, 2017
@MachinisteWeb MachinisteWeb deleted the custom-directive branch July 1, 2017 09:34
@sylvainpolletvillard
Copy link
Member

Je ne peux plus approuver les changements, mais bon pour moi

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants