Diretiva do modelo AngularJS
A diretiva ng-model vincula o valor dos controles HTML (input, select, textarea) aos dados do aplicativo.
A diretiva de modelagem
Com a ng-model
diretiva você pode vincular o valor de um campo de entrada a uma variável criada no AngularJS.
Exemplo
<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>
Encadernação de duas vias
A ligação vai nos dois sentidos. Se o usuário alterar o valor dentro do campo de entrada, a propriedade AngularJS também alterará seu valor:
Exemplo
<div ng-app="myApp" ng-controller="myCtrl">
Name:
<input ng-model="name">
<h1>You entered: {{name}}</h1>
</div>
Validar a entrada do usuário
A ng-model
diretiva pode fornecer validação de tipo para dados do aplicativo (número, e-mail, obrigatório):
Exemplo
<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>
No exemplo acima, o span será exibido apenas se a expressão no ng-show
atributo retornar true
.
Se a propriedade no ng-model
atributo não existir, o AngularJS criará uma para você.
Status do aplicativo
A ng-model
diretiva pode fornecer status para dados do aplicativo (válido, sujo, tocado, erro):
Exemplo
<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
A ng-model
diretiva fornece classes CSS para elementos HTML, dependendo de seu status:
Exemplo
<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>
A ng-model
diretiva adiciona/remove as seguintes classes, de acordo com o status do campo do formulário:
- de vazio
- de-não-vazio
- tocado
- intocado
- de-válido
- inválido
- de-sujo
- pendente
- imaculado