Skip to content
Angular touchspin
TypeScript JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dev
dist Default import is now enabled. Nov 14, 2018
other Default import is now enabled. Nov 14, 2018
src Default import is now enabled. Nov 14, 2018
.gitignore Fix for bower empty dist folder May 23, 2016
.npmignore Removed angular-touchspin.d.ts from .npmignore. Dec 23, 2017
.travis.yml Initial project boilerplate added Feb 4, 2016
LICENSE Initial commit Feb 3, 2016
README.md
bower.json Default import is now enabled. Nov 14, 2018
gulpfile.js Updated npm packages and compatibility for npm > 3.x Apr 20, 2016
karma.conf.js
package-lock.json Default import is now enabled. Nov 14, 2018
package.json Default import is now enabled. Nov 14, 2018
tsconfig.json
tslint.json Initial project boilerplate added Feb 4, 2016

README.md

Angular Touchspin

License NPM Release NPM Monthly Downloads

angular-touchspin is a port of istvan-ujjmeszaros/bootstrap-touchspin. It could now show some differences with it.

The goal is to provide the same API than the original one but without jQuery and using all the angular power.

Requirements

  1. AngularJS1.4.x
  2. Bootstrap3.x for the default styles (Can use bootstrap-css-only, you must add this to your bower or include this manually)
  3. NOTE: please check the requirements for earlier releases, if these are an issue.

Where to get it

Via Bower:

Run bower install angular-touchspin from the command line. Include script tags similar to the following:

<link rel='stylesheet' href='/bower_components/angular-touchspin/dist/angular-touchspin.css'>
<script src='/bower_components/angular-touchspin/dist/angular-touchspin.min.js'></script>

Via NPM:

Run npm install angular-touchspin from the command line. Include script tags similar to the following:

<link rel='stylesheet' href='/node_modules/angular-touchspin/dist/angular-touchspin.css'>
<script src='/node_modules/angular-touchspin/dist/angular-touchspin.min.js'></script>

Install using commonjs (eg componentjs, Webpack, Browserify):

import { default as touchspinModule } from 'angular-touchspin';
import 'angular-touchspin/dist/angular-touchspin.css'; 

angular.module('myModule', [touchspinModule]);

For CSS support with Webpack, install the style-loader, css-loader (and postcss-loader) and configure the loader in your webpack.config.js similar to the following:

loaders: [
  {test: /\.css$/, loader: 'style!css!postcss'}
]

Via Github

Download the code from https://github.com/nkovacic/angular-touchspin/releases/latest, unzip the files then add script tags similar to the following:

<link rel='stylesheet' href='/path/to/unzipped/files/dist/angular-touchspin.min.css'>
<script src='/path/to/unzipped/files/dist/angular-touchspin.min.js'></script>

Demo

The demo can be found on stackblitz and features all the examples found in the dev folder in this repository.

Usage

  1. Include angular-touchspin.min.js
  2. Add a dependency to angular-touchspin in your app module, for example: angular.module('myModule', ['nk.touchspin']).
  3. Create an element to hold the control and add an ng-model="numberVariable" attribute where numberVariable is the scope variable that will hold the selected number value:
<div touch-spin ng-model="numberVariable"></div>

OR

<touch-spin ng-model="numberVariable"></touch-spin>

This acts similar to a regular AngularJS / form input if you give it a name attribute, allowing for form submission and AngularJS form validation.

Options

angular-touchspin can be configured using an options attribute options="optionsVariable" where optionsVariable is the scope variable that will hold options for the touchspin control.

<div touch-spin ng-model="numberVariable" options="optionsVariable"></div>

OR

<touch-spin ng-model="numberVariable" options="optionsVariable"></touch-spin>

Available options:

interface ITouchSpinOptions {
	buttonDownClass?: string;	
	buttonDownShow?: boolean;	
	buttonDownTxt?: string;
	buttonUpClass?: string;
	buttonUpShow?: boolean;
	buttonUpTxt?: string;
	min?: number;
	max?: number;
	step?: number;
	decimals?: number;
	decimalsDelimiter?: string;
	stepInterval?: number;
	forceStepDivisibility?: string; // none | floor | round | ceil
	inputReadOnly?: boolean;
	stepIntervalDelay?: number;
	verticalButtons?: boolean;
	verticalUpClass?: string;
	verticalDownClass?: string;
	prefix?: string;
	postfix?: string;
	prefixExtraClass?: string;
	postfixExtraClass?: string;
	mousewheel?: boolean;
}

It also supports min and max attributes for validating input value range (useful if the default value is not preffered).

<touch-spin ng-model="numberVariable" min="minValue" max="maxValue"></touch-spin>

Callback

angular-touchspin supports callback on model change using an attribute on-change="valueChanged(value,oldValue)" where valueChanged is the scope function that will be called on change.

<div touch-spin ng-model="numberVariable" options="optionsVariable" on-change="valueChanged(value,oldValue)"></div>

OR

<touch-spin ng-model="numberVariable" options="optionsVariable" on-change="valueChanged(value,oldValue)"></touch-spin>
You can’t perform that action at this time.