https://github.com/changliuunsw/angular-numeric-input
An AngularJS directive for number input to provide real-time number input formatting and validations.
https://github.com/changliuunsw/angular-numeric-input
angularjs bower number number-input
Last synced: 3 months ago
JSON representation
An AngularJS directive for number input to provide real-time number input formatting and validations.
- Host: GitHub
- URL: https://github.com/changliuunsw/angular-numeric-input
- Owner: changLiuUNSW
- License: mit
- Created: 2016-11-29T08:22:02.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2022-08-14T17:38:29.000Z (about 3 years ago)
- Last Synced: 2025-06-18T13:06:23.618Z (4 months ago)
- Topics: angularjs, bower, number, number-input
- Language: JavaScript
- Homepage:
- Size: 16.6 KB
- Stars: 10
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/changLiuUNSW/angular-numeric-input/releases) [](https://www.npmjs.org/package/angular-numeric-input) [](https://travis-ci.org/changLiuUNSW/angular-numeric-input)
# Angular-numeric-input
An Angular directive for number input to provide **real-time** number input formatting and validations.
It does a few things:
- Real-time number input formatting
- Support decimal (max 2 decimal places) and positive integer number
- Support dynamic Min and Max validation
- Support Maximum length validation (default to 9)
**Note** Not suport negative number.
## Latest Changes
- Check [CHANGELOG.md](/CHANGELOG.md)
## Demo
[See directive in action] (https://cdn.rawgit.com/changLiuUNSW/angular-numeric-input/master/docs/index.html)
## Angular Requirements
Require Angular 1.3.0 or higher and it has been tested with Angular 1.5.8.
## Installation Methods
### npm
```
$ npm install angular-numeric-input
```
### bower
```
$ bower install angular-numeric-input
```
## Usage
Load the unminified or minified file from `dist` dir:
```
```
Then include it as a dependency in your app.
```
angular.module('myApp', ['ui.numericInput'])
```
### Attributes:
- `ng-model`: _required_
- `type`: Set to `text` or `tel` or just leave it out. Do _not_ set to `number`.
- `min`: _optional_ Defaults to `1`.
- `max`: _optional_ Not enforced by default
- `max-length`: _optional_ Defaults to `9`
- `allow-decimal`: _optional_ Defaults to `false` (Postive Integer)
- `min-not-equal`: _optional_ Defaults to `false`
- `max-not-equal`: _optional_ Defaults to `false`
Basic example:
``` html
```
`min`, `max` can be set dynamically:
``` html
```
## Development
### Prepare your environment
* Install [Node.js](http://nodejs.org/) and NPM (should come with)
* Install global dev dependencies: `npm install -g gulp`
* Install local dev dependencies: `npm install` in repository directory
### Development Commands
* `gulp` to build and test
* `gulp build` to build
* `gulp test` for one-time test with karma
## Contributing
- Run the tests
- Try the [examples](./docs/index.html)