View source Improve this doc

Attributes

type in module ng

Description

A shared object between directive compile / linking functions which contains normalized DOM element attributes. The values reflect current binding state {{ }}. The normalization is needed since all of these are treated as equivalent in Angular:

Methods

  • $addClass(classVal)

Adds the CSS class value specified by the classVal parameter to the element. If animations are enabled then an animation will be triggered for the class addition.

Parameters

ParamTypeDetailsclassValstring

The className value that will be added to the element

  • $observe(key, fn)

Observes an interpolated attribute.

The observer function will be invoked once during the next $digest following compilation. The observer is then invoked whenever the interpolated value changes.

Parameters

ParamTypeDetailskeystring

Normalized key. (ie ngAttribute) .

fnfunction(interpolatedValue

Function that will be called whenever the interpolated value of the attribute changes. See the Directives guide for more info.

Returns

function()

the fn parameter.

  • $removeClass(classVal)

Removes the CSS class value specified by the classVal parameter from the element. If animations are enabled then an animation will be triggered for the class removal.

Parameters

ParamTypeDetailsclassValstring

The className value that will be removed from the element

  • $set(name, value)

Set DOM element attribute value.

Parameters

ParamTypeDetailsnamestring

Normalized element attribute name of the property to modify. The name is revers translated using the $attr property to the original name.

valuestring

Value to set the attribute to. The value can be an interpolated string.

  • $updateClass(newClasses, oldClasses)

Adds and removes the appropriate CSS class values to the element based on the difference between the new and old CSS class values (specified as newClasses and oldClasses).

Parameters

ParamTypeDetailsnewClassesstring

The current CSS className value

oldClassesstring

The former CSS className value

Properties

  • $attr

Returns

object

A map of DOM element attribute names to the normalized name. This is needed to do reverse lookup from normalized name back to actual name.