Self-contained, mobile friendly slider component for Angular based on angularjs-slider
npm install @angular-slider/ngx-sliderWebsite: https://angular-slider.github.io/ngx-slider/
Discord: https://discord.gg/DHsDghZRwZ
Self-contained, mobile friendly slider component for Angular based on angularjs-slider.
| ngx-slider | Angular | RxJS | Actively supported |
| ------------- | ----------- | ----------- | ------------------ |
| 2.0.x | 6.x - 12.x | 6.x | No |
| 13.x | 13.x | 6.x | No |
| 14.x | 14.x | 6.x | No |
| 15.x | 15.x | 7.x | No |
| 16.x | 16.x | 7.x | No |
| 17.x | 17.x | 7.x | No |
| 18.x | 18.x | 7.x | No |
| 19.x | 19.x | 7.x | Yes |
| 20.x | 20.x | 7.x | Yes |
| 21.x | 21.x | 7.x | Yes |
Note: Like with Angular only the latest 3 versions are actively supported.
* Single slider - StackBlitz
* Range slider - StackBlitz
* Slider with ticks - StackBlitz
* Customised slider - StackBlitz
* Slider with custom style - StackBlitz
* Vertical slider - StackBlitz
* More examples on official website
To add the slider to your Angular project:
``
npm install --save @angular-slider/ngx-slider
Once installed, add the slider to your app.module.ts:
`typescript
import { NgxSliderModule } from '@angular-slider/ngx-slider';
...
@NgModule({
...
imports: [
...
NgxSliderModule,
...
],
...
})
export class AppModule {}
`
Now you can use the slider component in your app components, for example in app.component.ts:
`typescript
import { Options } from '@angular-slider/ngx-slider';
...
@Component({...})
export class AppComponent {
value: number = 100;
options: Options = {
floor: 0,
ceil: 200
};
}
`
And in template file app.component.html:`html`
Full API documentation is available on official website.
An overview of how to apply your own style to the slider is described in STYLING.md.
As of v1.2.0 the slider features CSS animations of slider movement. If you prefer the previous behaviour, without animations, you can set the flag animate: false` in your slider options.
In addition to mouse/touch events, the slider can also be controlled through keyboard. The available shortcuts are:
- right/up arrow - increase by single step,
- left/down arrow - decrease by single step,
- page up - increase by 10% of slider range,
- page down - decrease by 10% of slider range,
- home - move to minimum value,
- end - move to maximum value.
The slider allows for customising how to implement tooltips. See TOOLTIPS.md for more information.
Before reporting a new bug, please look at KNOWN_ISSUES.md for a list of known problems and their workarounds. New bugs reports for these problems will not be accepted.
You can report any bugs as Github issues.
Please describe the issue in detail pasting any relevant code, or preferrably a StackBlitz with reproduction of the problem by forking and editing this sample StackBlitz. Please also provide the version of NPM package you are using.
For list of changes and bugfixes, see CHANGELOG.md.
If you would like to contribute to the project, see DEVELOPERS.md.
The project is licensed under the MIT license.
For instructions on upgrading from previous (1.x) versions of the library, see UPGRADING.md.