Syntaxe
<element ng-copy="expression"></element>
|
Paramètres
Nom |
Description |
element |
Ce paramètre permet d'indiquer une balise. |
expression |
Ce paramètre permet d'indiquer une expression a exécuter quand le texte d'un élément est copié. |
Description
Cette directive permet d'indiquer le comportement dans la copie des événements.
Remarques
- Rôle et fonctionnement : La directive ng-copy permet de définir un gestionnaire d'événement s'exécutant lorsqu'un utilisateur effectue une action de
copie (copy) dans la vue. Cette action est capturée via le DOM, et le comportement souhaité peut être défini dans une
expression Angular associée à cette directive.
- Événement DOM natif : ng-copy repose sur l'événement DOM natif copy, étant déclenché lorsqu'un
contenu est copié dans le presse-papiers (par exemple via Ctrl+C ou un clic droit suivi de "Copier"). La directive agit donc comme un raccourci pour
surveiller cet événement sans utiliser explicitement addEventListener.
- Expression Angular : La valeur associée à la directive ng-copy doit être une expression Angular, comme un appel de fonction ou une modification
de variable.
- Portée limitée : ng-copy ne fonctionne que dans le contexte de l'élément HTML sur lequel elle est définie. Si l'utilisateur copie quelque chose en
dehors de cet élément, la directive ne sera pas déclenchée. Il est donc crucial de bien cibler l'élément pour éviter tout comportement inattendu.
- Cas d'utilisation : Cette directive est souvent utilisée pour des scénarios spécifiques, comme afficher un avertissement ou journaliser les interactions
utilisateur lorsqu'un contenu est copié. Par exemple, dans une application éducative, on pourrait enregistrer chaque fois qu'un étudiant copie un extrait de texte.
- Support du navigateur : Étant donné qu'elle repose sur l'événement natif copy, la directive ng-copy fonctionne dans tous les navigateurs modernes.
Toutefois, certains anciens navigateurs ou contextes très spécifiques (comme certains environnements mobiles ou des navigateurs intégrés) pourraient ne pas gérer correctement
cet événement.
- Interopérabilité avec d'autres événements : ng-copy peut être utilisé conjointement avec d'autres directives liées aux événements utilisateur, comme
ng-cut et ng-paste. Cela permet de gérer l'ensemble des interactions avec le presse-papiers dans une application AngularJS, par exemple pour suivre les
actions de couper, copier et coller.
- Alternatives modernes : Dans les versions modernes d'Angular (2+), les événements comme copy peuvent être capturés directement avec (copy) dans
les gabarits HTML.
Dernière mise à jour : Dimanche, le 9 décembre 2018