Directive de modèle AngularJS


La directive ng-model lie la valeur des contrôles HTML (input, select, textarea) aux données de l'application.


La directive modélisation

Avec la ng-modeldirective, vous pouvez lier la valeur d'un champ d'entrée à une variable créée dans AngularJS.

Exemple

<div ng-app="myApp" ng-controller="myCtrl">
  Name: <input ng-model="name">
</div>

<script>
var app = angular.module('myApp', []);
app.controller('myCtrl', function($scope) {
  $scope.name = "John Doe";
});
</script>

Reliure bidirectionnelle

La liaison va dans les deux sens. Si l'utilisateur modifie la valeur dans le champ de saisie, la propriété AngularJS modifiera également sa valeur :

Exemple

<div ng-app="myApp" ng-controller="myCtrl">
  Name: <input ng-model="name">
  <h1>You entered: {{name}}</h1>
</div>


Valider l'entrée de l'utilisateur

La ng-modeldirective peut fournir une validation de type pour les données d'application (numéro, e-mail, requis) :

Exemple

<form ng-app="" name="myForm">
  Email:
  <input type="email" name="myAddress" ng-model="text">
  <span ng-show="myForm.myAddress.$error.email">Not a valid e-mail address</span>
</form>

Dans l'exemple ci-dessus, l'étendue ne sera affichée que si l'expression dans l' ng-showattribut renvoie true.

Si la propriété dans l' ng-modelattribut n'existe pas, AngularJS en créera une pour vous.


État de la candidature

La ng-modeldirective peut fournir un statut pour les données d'application (valide, sale, touché, erreur) :

Exemple

<form ng-app="" name="myForm" ng-init="myText = '[email protected]'">
  Email:
  <input type="email" name="myAddress" ng-model="myText" required>
  <h1>Status</h1>
  {{myForm.myAddress.$valid}}
  {{myForm.myAddress.$dirty}}
  {{myForm.myAddress.$touched}}
</form>

Classes CSS

La ng-modeldirective fournit des classes CSS pour les éléments HTML, en fonction de leur statut :

Exemple

<style>
input.ng-invalid {
  background-color: lightblue;
}
</style>
<body>

<form ng-app="" name="myForm">
  Enter your name:
  <input name="myName" ng-model="myText" required>
</form>

La ng-modeldirective ajoute/supprime les classes suivantes, selon le statut du champ de formulaire :

  • vide
  • du-pas-vide
  • de-touché
  • de-intouché
  • valide
  • invalide
  • de sale
  • ng-en attente
  • de vierge