Dyrektywa o modelu AngularJS


Dyrektywa ng-model wiąże wartość kontrolek HTML (input, select, textarea) z danymi aplikacji.


Dyrektywa modelowa

Za pomocą ng-modeldyrektywy można powiązać wartość pola wejściowego ze zmienną utworzoną w AngularJS.

Przykład

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

Wiązanie dwukierunkowe

Wiązanie działa w obie strony. Jeśli użytkownik zmieni wartość wewnątrz pola wejściowego, właściwość AngularJS również zmieni swoją wartość:

Przykład

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


Sprawdź dane wprowadzone przez użytkownika

Dyrektywa ng-modelmoże zapewnić walidację typu danych aplikacji (numer, e-mail, wymagane):

Przykład

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

W powyższym przykładzie zakres zostanie wyświetlony tylko wtedy, gdy wyrażenie w ng-showatrybucie zwróci true.

Jeśli właściwość w ng-modelatrybucie nie istnieje, AngularJS utworzy ją dla Ciebie.


Status aplikacji

Dyrektywa ng-modelmoże podać status danych aplikacji (prawidłowy, brudny, dotknięty, błąd):

Przykład

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

Klasy CSS

Dyrektywa ng-modeldostarcza klasy CSS dla elementów HTML, w zależności od ich statusu:

Przykład

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

Dyrektywa ng-modeldodaje/usuwa następujące klasy, zgodnie ze stanem pola formularza:

  • pusty
  • nie-puste
  • dotkniętych
  • nietknięty
  • z-ważny
  • nieważny
  • brudny
  • ng-oczekujące
  • nieskazitelny