Name: angular-post-message
Owner: Bisnode Informatics Deutschland
Description: Allow angularJS to listen and publish cross-document messages though window.postMessage API.
Forked from: kylewelsby/angular-post-message
Created: 2015-05-27 12:06:05.0
Updated: 2015-05-27 12:06:06.0
Pushed: 2015-05-27 13:27:42.0
Homepage: null
Size: 146
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Allow angularJS to listen and publish cross-document messages though window.postMessage
API.
Cross-document messaging is compatible with the following browsers as seen on Can I Use:
Partial support in IE8-9 refers to only working in frames/iframes (not other tabs/windows). Also in IE 9 and below an object cannot be sent using postMessage. Partial support in IE10 refers to limitations in certain conditions
Tested on AngularJS versions 1.2
, 1.3
and 1.4
in Chrome, Firefox, Opera, and IE9+.
IE8 is not officially supported by AngularJS
The repository comes with the modules pre-built and compressed into the dist/
directory.
Install the component via bower
bower install angular-post-message
Or alternatively checkout this repo into your project.
Then include dist/angular-post-message.min.js
into your project.
This is a simple example which uses postMessage to deliver messages between two origins. There is a gist which will deliver a message every second
<html>
<head>
<script src="bower_components/angular/angular.js"></script>
<script src="bower_components/angular-post-message/angular-post-message.js"></script>
</head>
<body>
<iframe src="https://rawgit.com/kylewelsby/585b3a5395c6731acc50/raw/f661e856adbccf39549ed7c550661f09158f8d55/index.html"></iframe>
<br>
<button ng-click="sendMessage();">Send response</button>
<br>
<ol>
<li ng-repeat="message in messages">{{message}}</li>
</ol>
</body>
</html>
var app = angular.module('app',['ngPostMessage']);
app.controller('MainCtrl', function($scope) {
$scope.messages = [];
$scope.$root.$on('$messageIncoming', function (event, data){
$scope.messages.push(angular.fromJson(data));
});
$scope.sendMessage = function (){
$scope.$emit(
'$messageOutgoing',
angular.toJson({"response":"hi"})
);
};
});
You do not need to build the project to use it, but if you are working on it then this is what you need to know.
To run all the tests
npm test
To run tests while developing (limited to latest Angular version on Google Chrome)
karma start
or run tests once
./scripts/ci