Start using .component() now!
angular-component.js is a ~1kb script that adds component() support in Angular 1.5 to all Angular versions above 1.3, so you can begin using the new method now.
Note: you must include this script straight after angular.js and before your application code to ensure the component() method has been added to the angular.module global.
Read about the Angular 1.5
component()method here
This polyfill supports the following feature set of the .component() method:
| Feature | Support |
|---|---|
angular.module.component() method |
Yes |
bindings property |
Yes |
'E' restrict default |
Yes |
$ctrl controllerAs default |
Yes |
transclude property |
Yes |
template support |
Yes |
templateUrl injectable for $element and $attrs |
Yes |
Lifecycle hooks: $onInit, $postLink, $onDestroy |
Yes |
require Object for parent Component inheritance |
Yes |
$ prefixed properties such as $canActivate |
Yes |
| One-way data-binding emulated | No, todo |
$onChanges lifecycle hook |
No, todo |
<div ng-app="app">
<div ng-controller="MainCtrl as vm">
<counter count="vm.count"></counter>
</div>
</div>
<script>
angular
.module('app', [])
.component('counter', {
bindings: {
count: '='
},
controller: 'CounterCtrl',
template: function ($element, $attrs) {
return `
<div class="counter">
<p>Counter component</p>
<input type="text" ng-model="$ctrl.count">
<button type="button" ng-click="$ctrl.decrement();">-</button>
<button type="button" ng-click="$ctrl.increment();">+</button>
</div>
`;
}
})
.controller('CounterCtrl', function CounterCtrl() {
this.$onInit = function () {
// component initialisation
};
this.$postLink = function () {
// component post-link
};
this.$onDestroy = function () {
// component $destroy function
};
function increment() {
this.count++;
}
function decrement() {
this.count--;
}
this.increment = increment;
this.decrement = decrement;
})
.controller('MainCtrl', function MainCtrl() {
this.count = 4;
});
</script>npm install angular-component --save
bower install angular-component.js --save
Ensure you're using the files from the dist directory (contains compiled production-ready code). Ensure you place the script before the closing </body> tag.
<body>
<!-- html above -->
<script src="angular-1.x.js"></script>
<script src="dist/angular-component.js"></script>
<script src="app.js"></script>
</body>In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Gulp.
- 0.0.8
- Add new lifecycle hooks ($onInit, $onDestroy, $postLink)
- 0.0.7
- Add
requireproperty from 1.5 stable,restrict: 'E'as default
- Add
- 0.0.6
- Add automated
$prefixed properties to factory Object
- Add automated
- 0.0.5
- Add automatic function annotations
- 0.0.4
- Fix Array dependency annotations #11
- 0.0.3
- Fix bug caused by bugfix (aligns with new 1.5 changes)
- 0.0.2
- Bugfix isolate scope when
bindingsis omitted, short-circuit if .component() is already supported
- Bugfix isolate scope when
- 0.0.1
- Initial release
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent