Show Menu

AngularJS Cheat Sheet by ProLoser

The official - unofficial AngularJS cheatsheet.


amount | currency[:symbol]
Formats a number as a currency (ie $1,234.56).
date | date[:format]
array | filter:expression
Selects a subset of items from array. Expression takes strin­g|O­bje­ct|­fun­cti­on()
data | json
Convert a JavaScript object into JSON string.
array | limitTo:limit
Creates a new array containing only a specified number of elements in an array.
text | linky 1
Finds links in text input and turns them into html links.
string | lowercase
Converts string to lowercase.
number | number[:fractionSize]
Formats a number as text. If the input is not a number an empty string is returned.
array | orderBy:predicate[:reverse]
Predicate is functi­on(­*)|­str­ing­|Array. Reverse is boolean
string | uppercase
Converts string to uppercase.

You can inject the $filter service and do $filt­er(­'fi­lte­rNa­me'­)(v­alue[, :optio­nal­Par­am][, :optio­nal­Par­am]) in use it in your javasc­ript.
1 Requires ngSanitize Module


compil­edHtml = $com­pil­e­(ht­ml)­(scope)
$exc­ept­ion­Han­dle­r­(ex­cep­tion[, cause])
$int­erp­ola­te­(t­ext[, mustHa­veE­xpr­ess­ion])
$res­our­ce­(url[, paramD­efa­ults][, actions])
$scope See $rootS­cope
$tim­eou­t­(fn[, delay][, invoke­App­ly])

Directive Definition Object

name {string}
Name of the current scope. Optional defaults to the name at regist­ration.
prio­rity {inte­ger}
Specifies order multiple directives apply on single DOM element (higher = first)
term­inal {true}
Current priority will be last set of directives to execute
scope {true | object}
True - create child scope. Undef­ine­d|f­alse - use parent scope. {} - isolate scope (with specified attrib­ute­s/scope variables passed): @ or @attr - bind local model to value of DOM attribute (string), = or =attr - bi-dir­ect­ional binding between local model and the parent scope, & or &attr - execute an expression in context of parent. Reference attr OR assumes model of same name
cont­rol­ler funct­ion­($s­cope, $element, $attrs, $trans­clude)
Controller constr­uctor function instan­tiated before pre-li­nking phase and shared with other directives if requested by name
requ­ire {string | array[­str­ings]}
Require another controller (ngMo­del). Prefixes: ? - Don't raise error. ^ - Look on parent elements too
rest­rict {string: 'EACM'}
E - Element: <m­y-d­ire­ctive />. A - Attrib­ute (default): <div my-di­rec­tiv­e=­"­exp­" />. C - Class: <div class=­"­my­-di­rec­tive: exp;" />. M - Comment: <!-- directive: my-di­rec­tive exp -->
temp­late {string}
Replace current element with contents and migrates all attributes / classes
temp­lat­eUrl {string}
Same as template but the template is loaded from the specified URL
repl­ace {bool­ean}
true: template replaces element instead of appending
tran­scl­ude {bool­ean}
Compiles contents on parent (pre-i­solate) scope. Usually used with ngTran­sclude & templates.
comp­ile funct­ion­(tE­lement, tAttrs, fn transc­lud­e(f­unc­tio­n(s­cope, cloneL­ink­ingFn) ) returns link()
For transf­orming the template (rare, run once per template instance).
link funct­ion­(scope, iElement, iAttrs, contro­ller)
Executed after template is cloned (run once per clone). Contains most logic (DOM listeners, etc). Contr­oller can be an array.




<html ng-csp> (Content Security Policy)
<form|ng-form name="plaintext"> | ng-form="plaintext"
ng-include="string"|<ng-include src="string" onload="expression" autoscroll="expression">
<input ng-p­att­ern­=­"­/re­gex­/" ng-m­inl­ength ng-m­axl­ength ng-r­equ­ired
<input ng-list="delimiter|regex">
<input type="c­hec­kbo­x" ng-t­rue­-va­lue­=­"­pla­int­ext­" ng-f­als­e-v­alu­e­="pl­ain­tex­t">
<select ng-m­ult­ipl­e>
ng-options="select [as label] [group by group] for ([key,] value) in object|array"
ng-pluralize|<ng-pluralize count="number" when="object" offset="number">
ng-repeat="([key,] value) in object|array"
<option ng-selected="boolean">
ng-switch="expression"|<ng-switch on="expression">
ng-transclude templates

Bold means the actual directive
Italics mean optional
Pipes mean either|or
Plaintext means no string encaps­ulation
Super­script means notes or context
<Br­ack­ets> mean tag compti­bility
Lack of <br­ack­ets> means the attribute can apply to any tag


Use this method to register work which needs to be performed on module loading.
constant(name, object)
Because the constant are fixed, they get applied before other provide methods.
controller(name, constructor)
directive(name, directiveFactory)
factory(name, providerFunction)
filter(name, filterFactory)
provider(name, providerType)
Use this method to register work which needs to be performed when the injector with with the current module is finished loading.
service(name, constructor)
value(­name, object)
Name of the module.
Holds the list of modules which the injector will load before the current module is loaded.


Scope Properties and Methods

$root or $roo­tSc­ope
Move to the top-most $scope (ng-app)
Move to the immediate parent of the current $scope
Auto generated Unique ID
$destroy (event)
Broadc­asted when a scope and its children are being destroyed
Executes logic within the AngularJS context and refreshes all models checks.
$bro­adc­ast­(name, args)
Dispatches an event name downwards to all child scopes
Removes the current scope (and all of its children) from the parent scope
Process all of the watchers of the current scope and its children. Since watchers can change models, they will continue firing until all changes stop. BEWARE OF RECURSIVE CODE
$emi­t(name, args)
Dispatches an event name upwards through the scope hierarchy
Executes the expression on the current scope and returns the result
Executes the expression on the current scope at a later point in time
Creates a new child scope
$on(­name, listen­er)
Listens on events of a given type
$wat­ch(­wat­chExp, listen­er(­newVal, oldVal, scope), object­Equ­ali­ty)
Watch a model (exp) for changes and fires the listener callback. Pass true as a third argument to watch an object's properties too.

The following directives create child scopes: ngInc­lude, ngSwi­tch, ngRep­eat, ngCon­tro­ller, uiIf. Calls to the same ngCon­tro­ller will create multiple instances and do not share scopes. Remember to traverse up the tree to affect primi­tives on the intended scope: ng-cl­ick­="$p­are­nt.s­ho­wPa­ge=­tru­e"


Global Functions

angular.bind(self, fn, args)
Returns a function which calls function fn bound to self (self becomes the this for fn).
angular.bootstrap(element[, modules])
Use this function to manually start up angular applic­ation.
angular.copy(source[, destination])
Creates a deep copy of source, which should be an object or an array.
Wraps a raw DOM element or HTML string as a jQuery element.
angular.equals(o1, o2)
Determines if two objects or two values are equiva­lent.
angular.extend(dst, src)
Extends the destin­ation object dst by copying all of the properties from the src object(s) to dst.
angular.forEach(obj, iterator[, context])
Invokes the iterator function once for each item in obj collec­tion, which can be either an object or an array.
Deseri­alizes a JSON string.
A function that returns its first argument. This function is useful when writing code in the functional style.
Creates an injector function that can be used for retrieving services as well as for dependency injection.
Determines if a reference is an Array.
Determines if a value is a date.
Determines if a reference is defined.
Determines if a reference is a DOM element (or wrapped jQuery element).
Determines if a reference is a Function.
Determines if a reference is a Number.
Determines if a reference is an Object. Unlike typeof in JavaSc­ript, nulls are not considered to be objects.
Determines if a reference is a String.
Determines if a reference is undefined.
Converts the specified string to lowercase.
Namespace from 'angul­ar-­moc­ks.js' which contains testing related code.
angular.module(name[, requires], configFn)
The angula­r.m­odule is a global place for creating and regist­ering Angular modules. Requires argument always creates a new module.
A function that performs no operat­ions.
angular.toJson(obj[, pretty])
Serializes input into a JSON-f­orm­atted string.
Converts the specified string to uppercase.
An object that contains inform­ation about the current AngularJS version.


$render()Called when the view needs to be updated. It is expected that the user of the ng-model directive will implement this method.
$setVa­lid­ity­(va­lid­ati­onE­rro­rKey, isValid)
$parsersarray of function after reading val from DOM to sanitize / convert / validate the value
$forma­ttersarray of functions to convert / validate the value


Deferred and Promise

$q.a­ll(­[array of promis­es])
Creates a Deferred object which represents a task which will finish in the future.
$q. defer()
Creates a Deferred object which represents a task which will finish in the future.
Creates a promise that is resolved as rejected with the specified reason
Wraps an object that might be a value or a (3rd party) then-able promise into a $q promise
Resolves the derived promise with the value
Rejects the derived promise with the reason
Promise object associated with this deferred
Prom­­en(­suc­ces­sCa­llback, errorC­all­back)



Share This Cheat Sheet!

Favourited by 47 Members:

Hanny fkorling xtiam57 twbcs BobGuzek John Li Jaime MADRID johneric72 mehdi abdulqabiz yabasha and 37 more ...


Vinay Vinay, 20:00 9 Aug 12

I think the angularjs fiddles is a great resource, add this to the cheatsheet:

Gary Weaver Gary Weaver, 10:01 20 May 13

Great stuff! Would be good to add compatible Angular version(s) at the top.

Dillon Dillon, 10:19 20 May 13

Is it just me, or does the 'find' not work for this page? If i type in 'ng-app' it doesn't find anything...

DaveChild DaveChild, 13:13 20 May 13

Hi Dillon. Well spotted - looks like an issue with JavaScript handling of shy hyphens, which are used to help cheat sheet text wrap well. I'm working on a solution now.

DaveChild DaveChild, 13:27 20 May 13

Hi Dillon. I've fixed the search and "ng-app" now returns the right rows. Thanks for letting me know about the problem!

DaveChild DaveChild, 11:22 20 May 13

Dean, your excellent cheat sheet made the front page of Hacker News:

ProLoser ProLoser, 11:25 20 May 13

Cheatography's built-in search sucks. You're better off using your browser to do a native page search

DaveChild DaveChild, 13:38 20 May 13

The build-in search was choking on soft hyphens, but I've fixed the problem now and search is working normally.

ProLoser ProLoser, 01:51 21 May 13

Hey Dave!

I had no idea you were still working on this website, I was under the impression it was one of those side projects that just fell by the wayside.

HOW do I let other people collaborate on the cheat sheet with me? It's really annoying that I'm the only one who can work on a sheet.

Also, have you considered supporting hyperlinks (I know sheets are designed to be printed) like [test](

Also, can you add support for <br> so that I can list sub-details instead of cramming them together like I had to for 'rest­rict'

Also, how about descriptions at the TOP of content panes?

Also, maybe add underscore?

DaveChild DaveChild, 19:15 28 May 13

Not exactly by the wayside, but I've been struggling with the new PDF builder for ages. Didn't seem to be much point in working on anything else until the compilation process and builder were fixed (and both are almost finished).

Collaboration is something I'm going to be adding in the future, but I'm not planning much until after the builder stuff is done. Hyperlinks in that style and line breaks are both good ideas, and as above - as soon as the new builder is done those are on the list. Line breaks will be a little tricky, as the new builder does a lot of line count estimation to try and paginate the PDFs better, but definitely something I want to add.

For underscore, do you mean in the titles? I'll add that in the current round of dev.

ProLoser ProLoser, 19:28 28 May 13

I'm just talking about having more formatting options at my disposal. Personally, this specific cheatsheet isn't super PDF friendly, and I think almost everyone can 'print to pdf' nowadays, so it might be easier to focus on a simple print stylesheet.

Bruno Felthes Bruno Felthes, 14:15 13 Feb 14

Include the ng-animation tag.
Some good samples at the site:

Karin Karin, 07:48 19 Jun 14

The PDFs don't display the text correctly.

Johannes Johannes, 08:31 9 Oct 14

ng-if is missin in the list of directives.

Besides great work.

Add a Comment

Your Comment

Please enter your name.

    Please enter your email address

      Please enter your Comment.