Saisie utilisateur Angular 2

Lorsque les utilisateurs cliquent sur des liens, appuient sur des boutons ou saisissent du texte, ces interactions utilisateur déclenchent des événements DOM.

Dans ce chapitre, nous allons apprendre à utiliser la syntaxe de liaison d'événements Angular pour lier ces événements.

Le GIF suivant illustre le fonctionnement de cet exemple :

Le code source peut être téléchargé à la fin de l'article.


Liaison aux événements de saisie utilisateur

Nous pouvons utiliser le mécanisme de liaison d'événements d'Angular pour répondre à n'importe quel événement DOM.

L'exemple suivant lie un événement click :

<button (click)="onClickMe()">点我!</button>

Le (click) à gauche du signe égal indique que l'événement click du bouton est la cible de la liaison. À droite, le texte entre guillemets est une instruction de modèle.

Le code complet est le suivant :

fichier app/click-me.component.ts :

import { Component } from '@angular/core'; @Component({ selector: 'click-me', template: ` <button (click)="onClickMe()">Cliquez-moi !</button> {{clickMessage}}` }) export class ClickMeComponent { clickMessage = ''; onClickMe() { this.clickMessage = 'Exemple !'; } }

Récupérer la saisie de l'utilisateur via l'objet $event

Nous pouvons nous lier à tous les types d'événements.

Essayons de nous lier à l'événement keyup d'une zone de saisie et de renvoyer la saisie de l'utilisateur à l'écran.

app/keyup.component.ts (v1) fichier :

@Component({ selector: 'key-up1', template: ` <input (keyup)="onKey($event)"> <p>{{values}}</p> ` }) export class KeyUpComponent_v1 { values = ''; /*// Non fortement typé onKey(event:any) { this.values += event.target.value + ' | '; }*/ //Fortement typé onKey(event: KeyboardEvent) { this.values += (<HTMLInputElement>event.target).value + ' | '; } }

Dans le code ci-dessus, nous écoutons un événement et capturons la saisie de l'utilisateur. Angular stocke l'objet événement dans la variable $event.

La méthode onKey() du composant est utilisée pour extraire la saisie de l'utilisateur de l'objet événement, puis ajouter la valeur saisie à la propriété values.


Récupération de la saisie utilisateur à partir d'une variable de référence de template

Vous pouvez afficher les données utilisateur en utilisant une variable de template locale. Une variable de référence de template est créée en ajoutant un symbole dièse (#) avant un identifiant.

L'exemple suivant montre comment utiliser une variable de template locale :

fichier app/loop-back.component.ts :

@Component({ selector: 'loop-back', template: ` <input #box (keyup)="0"> <p>{{box.value}}</p> ` }) export class LoopbackComponent { }

Nous,<input>sur l'élément, avons défini uneboxvariable de référence de template nommée.boxLa variable fait référence à<input>l'élément lui-même, ce qui signifie que nous pouvons obtenir lavaluevaleur de l'élément d'entrée, et l'afficher via une expression d'interpolation dans le<p>balise.

Nous pouvons utiliser des variables de référence de modèle pour modifier l'exemple keyup ci-dessus :

fichier app/keyup.components.ts (v2) :

@Component({ selector: 'key-up2', template: ` <input #box (keyup)="onKey(box.value)"> <p>{{values}}</p> ` }) export class KeyUpComponent_v2 { values = ''; onKey(value: string) { this.values += value + ' | '; } }

Filtrage des événements clavier (via key.enter)

Nous pouvons obtenir la valeur du champ de saisie uniquement lorsque l'utilisateur appuie sur la touche Entrée.

Le gestionnaire d'événement (keyup) écoute chaque appui sur une touche. Nous pouvons filtrer les appuis sur les touches, par exemple en vérifiant chaque $event.keyCode, et mettre à jour la propriété values uniquement lorsque la touche Entrée est enfoncée.

Angular peut filtrer les événements clavier pour nous en se liant au pseudo-événement keyup.enter d'Angular pour écouter la touche Entrée.

app/keyup.components.ts (v3):

@Component({ selector: 'key-up3', template: ` <input #box (keyup.enter)="values=box.value"> <p>{{values}}</p> ` }) export class KeyUpComponent_v3 { values = ''; }

événement blur (perte de focus)

Ensuite, nous pouvons utiliser l'événement blur (perte de focus), qui met à jour la propriété values après que l'élément perd le focus.

L'exemple suivant écoute à la fois l'événement d'appui sur la touche Entrée et l'événement de perte de focus de la zone de saisie.

app/keyup.components.ts (v4):

@Component({ selector: 'key-up4', template: ` <input #box (keyup.enter)="values=box.value" (blur)="values=box.value"> <p>{{values}}</p> ` }) export class KeyUpComponent_v4 { values = ''; }

Le code source utilisé dans cet article peut être téléchargé via les méthodes suivantes, à l'exclusion des répertoires node_modules et typings.

Téléchargement du code source

Autres extensions