geheugen-angular

Angular bindings for geheugen.

Installation

npm install --save @kjots/geheugen-angular

Usage

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

<script src="@kjots/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 factory¹ 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 factory¹ 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.

properties

Type: Object<String, Object>

The memo properties.

These properties will be defined on the memo via Object.defineProperties().

Properties with the names get, set, reset, and resetDependants will be ignored.

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 factory¹ 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));
    });

onSet

Type: Function

The set event handler.

This function will be invoked when the memo is set.

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

The value of the memo will be available as the value local to this function.

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<String|Function>

The Angular factory¹ 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.get(name)

Type: Function

Return the value of the memo with the provided name.

name

Type: String

The name of the memo.

memos.set(name, value)

Type: Function

Update the value of the memo with the provided name.

name

Type: String

The name of the memo.

value

Type: ?

The value.

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.get()

Type: Function

Return the value of the memo.

memo.set(value)

Type: Function

Update the value of the memo.

value

Type: ?

The value.

memo.reset()

Type: Function

Reset the memo.

memo.resetDependants()

Type: Function

Reset the dependants of the memo.

Notes

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