geheugen-angular

geheugen-angular

Angular bindings for geheugen.

Installation

npm install --save geheugen-angular

Usage

<script src="babel-polyfill/dist/polyfill.js"></script>
<script src="angular/angular.js"></script>

<script src="geheugen-angular/dist/geheugen-angular.js"></script>

<script>
    angular.module('exampleApp', [ 'geheugen' ]);
</script>

API

Constants

Memo

Type: Class

The geheugen Memo class.

memos.registry

Type: Object<String,Memo>

The registry of geheugen Memo instances, keyed by their name.

Services

memosProvider(name)

Type: Function

Returns an Angular constructor¹ for the resolved value of the memo with the provided name.

The return value of this function is suitable for being used as a dependency of an Angular route, e.g.:

angular.module('exampleApp')
    .config(($routeProvider, memosProvider) => {
        $routeProvider.when('/exampleRoute', {
            resolve: {
                example: memosProvider('example')
            }
        });
    });

name

Type: String

The name of the memo.

memosProvider(name, [opts], factory)

Type: Function

Register a memo with the provided name.

Returns an Angular constructor¹ for the memo.

The return value of this function is suitable for being used as the $get method of an Angular provider, e.g.:

angular.module('exampleApp')
    .provider('exampleMemo', function (memosProvider) {
        this.$get = memosProvider('example',
            $filter => $filter('number')('3.1415', 2));
    });

name

Type: String

The name of the memo.

opts

Type: Object<String, ?>

Default: {}

The memo options.

singleton

Type: Boolean

Default: true

The singleton flag.

dependencies

Type: Array<String>

Default: []

The dependencies of the memo.

This array contains the names of the memos upon which this memo depends.

The resolved values of the dependant memos will be available as locals to the Angular constructor¹ provided via factory, e.g.:

angular.module('exampleApp')
    .provider('dependencyMemo', function (memosProvider) {
        this.$get = memosProvider('dependency', () => '3.1415');
    })
    .provider('exampleMemo', function (memosProvider) {
        this.$get = memosProvider('example', { dependencies: [ 'dependency' ] },
            ($filter, dependency) => $filter('number')(dependency, 2));
    });

onReset

Type: Function

The reset event handler.

This function will be invoked when the memo is reset.

This function will be invoked via $injector.invoke().

factory

Type: Function or Array

The Angular constructor¹ for the resolved value of the memo.

The factory can return the either resolved value itself or a promise for the resolved value.

memos(name)

Type: Function

Returns the resolved value of the memo with the provided name.

name

Type: String

The name of the memo.

memos.reset(name)

Type: Function

Reset the memo with the provided name.

name

Type: String

The name of the memo.

memos.resetDependants(name)

Type: Function

Reset the dependants of the memo with the provided name.

name

Type: String

The name of the memo.

Instances

memo()

Type: Function

Returns the resolved value of the memo.

A memo instance can be created via memosProvider().

memo.reset()

Type: Function

Reset the memo.

memo.resetDependants()

Type: Function

Reset the dependants of the memo.

Notes

1: An Angular constructor is any value that can be passed as the `Type` argument to [`$injector.instantiate()`](https://docs.angularjs.org/api/auto/service/$injector#instantiate).