ng-toggle-button v1.5.3
AngularToggleButton
This is a toggle switch button component, you can see the demo here and test it in StackBlitz.
Versions
Angular | ng-toggle-button |
---|---|
>=15.0.0 | v1.5.x |
>=14.0.0 | v1.4.x |
>=13.0.0 | v1.3.x |
>=12.0.0 | v1.2.x |
>=11.0.0 | v1.1.x |
>=10.0.0 | v1.0.x |
>=9.0.0 | v0.2.x |
v8.x.x | v0.1.x |
Instalation
npm i ng-toggle-button
or
yarn add ng-toggle-button
Usage
Import the module
import { NgToggleModule } from 'ng-toggle-button';
@NgModule({
...
imports: [
...,
NgToggleModule.forRoot() //or NgToggleModule
],
})
Also, you can pass a global configuration for all ng-toggle
component in your app
import { NgToggleModule } from 'ng-toggle-button';
@NgModule({
...
imports: [
...,
NgToggleModule.forRoot(config)
],
})
The config
object is described in the table bellow
Use
<ng-toggle
[value]="true"
[color]="{
unchecked: '#939da2',
checked: '#f62d51'
}"
></ng-toggle>
Properties
Name | Type | Default | Description |
---|---|---|---|
value | boolean | false | Initial state of the toggle button |
speed | number | 300 | Transition time for the animation |
disabled | boolean | false | Button does not react on mouse events |
color | string | #0099CC | If String - color of the button when checked If Object - colors for the button when checked/unchecked or disabledExample: {checked: '#00FF00', unchecked: '#FF0000', disabled: '#CCCCCC'} |
labels | boolean Object | false | If boolean - shows/hides default labels If Object - sets custom labels for both states. Example: {checked: 'Foo', unchecked: 'Bar'} |
switchColor | string Object | #fff | If string - color or background property of the switch when checked If Object - colors or background property for the switch when checked/uncheked Example: {checked: '#25EF02', unchecked: 'silver'} |
width | number | 50 | Width of the button |
height | number | 22 | Height of the button |
margin | number | 3 | Space between the switch and background border |
name | string | undefined | Name to attach to the generated input field |
fontSize | number | 10 | Font size in pixels |
fontColor | string Object | undefined | If string - color when checked If Object - colors for labels when checked/uncheked Example: {checked: '#25EF02', unchecked: '#35DB15'} by default the text color is white. |
textAlign | string \| toggleConfig | {checked: 'left', unchecked: 'right'} | If string : text-align is applied both checked and unchecked labelsIf toggleConfig : Text align of checked/unchecked labelsExample: {checked: 'center', unchecked: 'center'} |
values | {checked: any, unchecked: any} | {checked: true, unchecked: false} | Values for checked and unchecked states, by default checked value is true and unchecked value is false Example: {checked: 1, unchecked: 0} . |
toggleConfig
type is described below:
toggleConfig = {
checked: string;
unchecked: string;
disabled?: string;
};
Outputs events
Name | Payload | Description |
---|---|---|
change | value | Triggered when state of the component changes. Contains: value - state of the button |
Keyboard Accessibility (WCAG)
The toggle is tabbable, and can be triggered using the spacebar - WCAG 2.4.3(A)
Development server
Clone this repo and download the dependencies.
Run ng serve
for a dev server. Navigate to http://localhost:4200/
.
4 months ago
4 months ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago