angular-react-to
A helper for watching any value change related to the specified scope.
Planned to be used instead of scope.$watch
.
Put in other words:
reactTo
will call a handler when object's field is changed and the change is related to the specified scope.
Why I need this?
scope.$watch
allows you react to value changes in the scope.
But there are only 2 usecases:
- The value must be assigned to the scope
scopemyVal = 5scope; // fn is called when myVal is changed
- A custom function wrapper should be created:
var { return someServicesomeField;} scope
reactTo
unites those two approaches, allowing you the next usages:
reactTo(scope)('scopeValue', fn)
- callfn
whenscope.scopeValue
changesreactTo(scope)('prefix','value', fn)
- callfn
whenscope.prefix.value
changesreactTo(scope)(object, 'field', fn)
- callfn
whenobject.field
value changes (object must not be in scope)
Limitations
You can use reactTo
as a drop-in replacement for scope.$watch
.
You should keep an eye on scope change propagation when you do something exotic, e.g. using scope.$digest
instead of scope.$apply
.
Installation
You can install reactTo either as a bower component:
bower install --save mr-mig/angular-react-to
or as a CommonJS module:
npm install -S angular-react-to
All you need to do afterwards is to inject reactTo
in your component, e.g.:
angular ;
Tests
npm install
bower install
npm test
You can run gulp
to run a test watcher.