Directiva de modelo AngularJS


La directiva ng-model vincula el valor de los controles HTML (entrada, selección, área de texto) a los datos de la aplicación.


La Directiva de modelado

Con la ng-modeldirectiva, puede vincular el valor de un campo de entrada a una variable creada en AngularJS.

Ejemplo

<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>

Encuadernación bidireccional

La unión va en ambos sentidos. Si el usuario cambia el valor dentro del campo de entrada, la propiedad AngularJS también cambiará su valor:

Ejemplo

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


Validar entrada de usuario

La ng-modeldirectiva puede proporcionar validación de tipo para los datos de la aplicación (número, correo electrónico, requerido):

Ejemplo

<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>

En el ejemplo anterior, el lapso se mostrará solo si la expresión en el ng-showatributo devuelve true.

Si la propiedad en el ng-modelatributo no existe, AngularJS creará una para usted.


Estado de la aplicación

La ng-modeldirectiva puede proporcionar el estado de los datos de la aplicación (válido, sucio, tocado, error):

Ejemplo

<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>

Clases CSS

La ng-modeldirectiva proporciona clases CSS para elementos HTML, dependiendo de su estado:

Ejemplo

<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-modeldirectiva agrega/elimina las siguientes clases, según el estado del campo de formulario:

  • vacío
  • de-no-vacío
  • de-tocado
  • de-intocado
  • de-válido
  • de-inválido
  • de-sucio
  • ng-pendiente
  • de-prístino