ngMessages.ngMessages (directive)
Improve this Doc View Source ngMessages
- directive in module ngMessages
ngMessages
is a directive that is designed to show and hide messages based on the state of a key/value object that it listens on. The directive itself compliments error message reporting with the ngModel
$error object (which stores a key/value state of validation errors).
ngMessages
manages the state of internal messages within its container element. The internal messages use the ngMessage
directive and will be inserted/removed from the page depending on if they're present within the key/value object. By default, only one message will be displayed at a time and this depends on the prioritization of the messages within the template. (This can be changed by using the ng-messages-multiple on the directive container.)
A remote template can also be used to promote message reusability and messages can also be overridden.
Click here to learn more about ngMessages
and ngMessage
.
Directive Info
- This directive executes at priority level 0.
Usage
<!-- using attribute directives --> <ANY ng-messages="expression"> <ANY ng-message="keyValue1">...</ANY> <ANY ng-message="keyValue2">...</ANY> <ANY ng-message="keyValue3">...</ANY> </ANY> <!-- or by using element directives --> <ng-messages for="expression"> <ng-message when="keyValue1">...</ng-message> <ng-message when="keyValue2">...</ng-message> <ng-message when="keyValue3">...</ng-message> </ng-messages>
Arguments
Param | Type | Details |
---|---|---|
ngMessages | string | an angular expression evaluating to a key/value object (this is typically the $error object on an ngModel instance). |
ngMessagesMultiple | multiple (optional) | string | when set, all messages will be displayed with true |
ngMessagesInclude | include (optional) | string | when set, the specified template will be included into the ng-messages container |
© 2010–2016 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.3.20/docs/api/ngMessages/directive/ngMessages