Angular2 async pipe implemented as Angular 1 filter to handle promises & RxJS observables
Switch branches/tags
Clone or download
Latest commit 076beb2 Mar 16, 2017

README.md

Angular1 async filter

Angular2 async pipe implemented as Angular 1 filter to handle Promises & RxJS Observables

The async filter takes a Promise or Observable as input and subscribes to the input automatically, eventually returning the emitted value(s) similarly as with Angular2 Async pipe. Works with RxJS Observables even without https://github.com/Reactive-Extensions/rx.angular.js

Install

Install from npm:

npm install angular1-async-filter --save

And bundle with Browserify, Webpack etc.

Or install with bower:

bower install angular1-async-filter --save

And add script to html:

<script src="bower_components/angular1-async-filter/async-filter.js"></script>

Add Angular module dependency. For example:

angular.module('myApp', ['asyncFilter']);

Usage

Basic usage:

<div>Value: {{ promiseOrObservable | async }}</div>

Works with any directive that takes an expression, like ng-if, ng-show and ng-repeat etc.

<ul>
    <li ng-repeat="item in list|async">{{ item }}</li>
</ul>

Angular $q and $http promises automatically trigger digest cycle when they resolve so all views will get updated. For compatibility with RxJS Observables, as well as other Promise or Observable implementations, you can provide the current scope as a parameter to the filter, which will then automatically trigger digest cycle whenever a new value is emitted:

<div ng-if="{{ observable | async:this }}">
    Value: {{ observable | async:this }}
</div>

If you are using the safeApply operator from https://github.com/Reactive-Extensions/rx.angular.js for example, then this is not needed.

Live example: http://jsbin.com/qoxaqo/edit?html,js,output

License

MIT