Interpolation markup with embedded expressions is used by Angular to provide data-binding to text nodes and attribute values.
An example of interpolation is shown below:
<a ng-href="img/{{username}}.jpg">Hello {{username}}!</a>
During the compilation process the compiler uses the $interpolate service to see if text nodes and element attributes contain interpolation markup with embedded expressions.
If that is the case, the compiler adds an interpolateDirective to the node and registers watches on the computed interpolation function, which will update the corresponding text nodes or attribute values as part of the normal digest cycle.
Note that the interpolateDirective has a priority of 100 and sets up the watch in the preLink function.
Attributes such as disabled
are called boolean
attributes, because their presence means true
and
their absence means false
. We cannot use normal attribute bindings with them, because the HTML
specification does not require browsers to preserve the values of boolean attributes. This means that
if we put an Angular interpolation expression into such an attribute then the binding information
would be lost, because the browser ignores the attribute value.
In the following example, the interpolation information would be ignored and the browser would simply interpret the attribute as present, meaning that the button would always be disabled.
Disabled: <input type="checkbox" ng-model="isDisabled" />
<button disabled="{{isDisabled}}">Disabled</button>
For this reason, Angular provides special ng
-prefixed directives for the following boolean attributes:
disabled
, required
, selected
,
checked
, readOnly
, and open
.
These directives take an expression inside the attribute, and set the corresponding boolean attribute to true when the expression evaluates to truthy.
Disabled: <input type="checkbox" ng-model="isDisabled" />
<button ng-disabled="isDisabled">Disabled</button>
ngAttr
for binding to arbitrary attributesWeb browsers are sometimes picky about what values they consider valid for attributes.
For example, considering this template:
<svg>
<circle cx="{{cx}}"></circle>
</svg>
We would expect Angular to be able to bind to this, but when we check the console we see
something like Error: Invalid value for attribute cx="{{cx}}"
. Because of the SVG DOM API's
restrictions, you cannot simply write cx="{{cx}}"
.
With ng-attr-cx
you can work around this problem.
If an attribute with a binding is prefixed with the ngAttr
prefix (denormalized as ng-attr-
)
then during the binding it will be applied to the corresponding unprefixed attribute. This allows
you to bind to attributes that would otherwise be eagerly processed by browsers
(e.g. an SVG element's circle[cx]
attributes). When using ngAttr
, the allOrNothing
flag of
$interpolate is used, so if any expression in the interpolated string
results in undefined
, the attribute is removed and not added to the element.
For example, we could fix the example above by instead writing:
<svg>
<circle ng-attr-cx="{{cx}}"></circle>
</svg>
If one wants to modify a camelcased attribute (SVG elements have valid camelcased attributes),
such as viewBox
on the svg
element, one can use underscores to denote that the attribute to bind
to is naturally camelcased.
For example, to bind to viewBox
, we can write:
<svg ng-attr-view_box="{{viewBox}}">
</svg>
Other attributes may also not work as expected when they contain interpolation markup, and
can be used with ngAttr
instead. The following is a list of known problematic attributes:
<select>
elements (see issue 1619)<textarea>
in Internet Explorer 10/11 (see issue 5025)<button>
in Internet Explorer 11 (see issue 14117)<div ng-show="form{{$index}}.$invalid"></div>
You should instead delegate the computation of complex expressions to the scope, like this:
<div ng-show="getForm($index).$invalid"></div>
function getForm(index) {
return $scope['form' + index];
}
You can also access the scope
with this
in your templates:
<div ng-show="this['form' + $index].$invalid"></div>