ngRequired adds the required validator
to ngModel
.
It is most often used for input
and select
controls, but can also be
applied to custom controls.
The directive sets the required
attribute on the element if the Angular expression inside
ngRequired
evaluates to true. A special directive for setting required
is necessary because we
cannot use interpolation inside required
. See the interpolation guide
for more info.
The validator will set the required
error key to true if the required
attribute is set and
calling NgModelController.$isEmpty
with the
ngModel.$viewValue
returns true
. For example, the
$isEmpty()
implementation for input[text]
checks the length of the $viewValue
. When developing
custom controls, $isEmpty()
can be overwritten to account for a $viewValue that is not string-based.
<ANY>
...
</ANY>
<script>
angular.module('ngRequiredExample', [])
.controller('ExampleController', ['$scope', function($scope) {
$scope.required = true;
}]);
</script>
<div ng-controller="ExampleController">
<form name="form">
<label for="required">Toggle required: </label>
<input type="checkbox" ng-model="required" id="required" />
<br>
<label for="input">This input must be filled if `required` is true: </label>
<input type="text" ng-model="model" id="input" name="input" ng-required="required" /><br>
<hr>
required error set? = <code>{{form.input.$error.required}}</code><br>
model = <code>{{model}}</code>
</form>
</div>