Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kirstein/angular-autodisable
ngAutodisable directive for angular. Automatic disable for buttons rocks!
https://github.com/kirstein/angular-autodisable
Last synced: about 2 months ago
JSON representation
ngAutodisable directive for angular. Automatic disable for buttons rocks!
- Host: GitHub
- URL: https://github.com/kirstein/angular-autodisable
- Owner: kirstein
- License: mit
- Archived: true
- Created: 2013-11-04T22:07:56.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2016-11-21T17:14:40.000Z (almost 8 years ago)
- Last Synced: 2024-07-26T07:20:44.957Z (2 months ago)
- Language: JavaScript
- Homepage: http://jsfiddle.net/kirstein/wXnks/embedded/result/
- Size: 50.8 KB
- Stars: 63
- Watchers: 5
- Forks: 26
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# angular-autodisable [](https://travis-ci.org/kirstein/angular-autodisable)
An extension to angular `ng-click` directive that automatically sets the element to disabled if the handler would return a promise.
### Requirements
---
1. angular.js version >1.2+
2. following es5 functions:
1. [`bind`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind)
2. [`map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
3. [`forEach`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)
4. [`indexOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf)
### Usage
---
Include `ngAutodisable` as dependency
```
angular.module('MyApp', [ 'ngAutodisable', ... ]);
```
If that's done then just follow those simple steps:
1. just attach `ng-autodisable` directive to the element which happens to have `ng-click` directive OR a form that has the `ng-submit` directive.
2. ???
3. profit!
#### On an element
```
Do something
Do something
```
#### On a form
```
...
Submit
```
The button with type `submit` within the form will be disabled.
#### Loading class
You can *optionally* add a list of classes which will be added to the element while this is disabled. This is useful to add a spinner or something similar.
```
Do something
...
Submit
```
The button with type `submit` within the form will get the class.
### Demo
---
A quick demo is available at [jsfiddle](http://jsfiddle.net/kirstein/wXnks/embedded/result/)
### How it works
---
When `ngClick` and `ngAutodisable` are on the same element then `ngAutodisable` overwrites the handler for `click` event. The default `ngClick` action is recreated _(and passes all the angular specs)_.
If the click handlers result happens to be a `promise` _(`$http` or `$q`)_ then the element attribute `disabled` will be set as true. If the promise fulfills then the element `disabled` attribute will be removed.
This also works with multiple click handlers, given that click handlers are separated by `;` as such:
```
Do something
```
If there are multiple click handlers then the element disabled style will be removed after the last promise resolves.
### Note
---
Throws an exception `ngAutodisable requires ngClick attribute in order to work` if `ngAutodisable` is on an element without `ngClick`.
### Devel
---
```
npm install
bower install
grunt test
grunt build
```
### License
---
MIT