- Overview
- Include Resource Files
- Default Options
- Button Properties
- Button Classes
- Methods
- Events
- Examples
Overview
The SK.UI.Button.OnOff class allows you to create on/off buttons.
Include Resource Files
- /Shared/UIComponents/Internal/Buttons
- css/on_off.css
<link type="text/css" rel="stylesheet" href="/Shared/UIComponents/Internal/Buttons/css/on_off.css"> - Scripts/on_off.js
<script type="text/javascript" src="/Shared/UIComponents/Internal/Buttons/Scripts/on_off.js"></script>
- css/on_off.css
The dependency files may already exist in the environment and you may not need to include them.
Default Options
Button Properties
Name | Description | Type | Default Value |
---|---|---|---|
duration | The duration in milliseconds of the slide animation. | Integer | 200 |
checkedLabel | The button's label in checked state. | String | 'ON' |
uncheckedLabel | The button's label in unchecked state. | String | 'OFF' |
resizeHandle | Whether the slide handle determines its size based on the labels length. | Boolean | true |
resizeContainer | Whether the button container determines its size based on the labels length. | Boolean | true |
disabled | Whether the button is disabled or not. | Boolean | false |
caption | The text that appears next to the button. | String | false |
classNames | Allows you to add custom class names for any button element. | Object | See button classes |
offsets | Allows you to control the offset of the labels. | Object | { knobRadius: 2 } |
Button Classes
Name | Description | Default Value |
---|---|---|
stateon | This class applies to the whole button when it is in checked state. | 'oobtn-state-on' |
stateoff | This class applies to the whole button when it is in unchecked state. | 'oobtn-state-off' |
status | The checkbox (hidden by default) which holds the state of the button. | 'oobtn-rendered' |
caption | The caption of the button. | 'oobtn-caption' |
container | The button container. This does not include the caption. | 'oobtn-container' |
labelOn | The checked state label. | 'oobtn-label-on' |
labelOff | The unchecked state label. | 'oobtn-label-off' |
handle | The slide handle. | 'oobtn-handle' |
handleCenter | The central portion of the slide handle. | 'oobtn-handle-center' |
handleRight | The right portion of the slide handle. | 'oobtn-handle-right' |
disabled | This class applies when the button is disabled. | 'oobtn-disabled' |
Methods
Name | Description | Parameters | Returns |
---|---|---|---|
enable | Enable the button. | - | - |
disable | Disable the button. | - | - |
turnOn | Change button state to checked. | - | - |
turnOff | Change button state to unchecked. | - | - |
isOn | Checks if button is checked. | - | Boolean |
isOff | Checks if button is unchecked. | - | Boolean |
isDisabled | Checks if button is disabled. | - | Boolean |
isEnabled | Checks if button is enabled. | - | Boolean |
destroy | Removes the button UI leaving only the checkbox. | - | - |
Events
Name | Description | Arguments |
---|---|---|
click | Triggers on clicking the button. | - |
change | Triggers on button state change. | - |
Examples
Initializing a basic on/off button.
var onoffButton = new SK.UI.Button.OnOff( window ).inject( document.body ); |
Initializing a small on/off button with a caption and attaching a custom click event.
var onoffButton = new SK.UI.Button.OnOff( window, { caption : 'My Button' event : 'eventName', classNames : { container : 'oobtn-container oobtn-small' } }).inject( document.body ); |
Setting up custom labels and an event. The event is handled in the manager object.
var onoffButton = new SK.UI.Button.OnOff( window, { checkedLabel : 'YES', uncheckedLabel : 'NO', event : 'action' }).inject( document.body ); window.addEvent('action', function () { alert('The dropdown button is clicked.'); }) |