Switch
The Switch
component allows users to toggle a control between two states.
The default state of the component is off, or false
, however you can change the state by setting the checked
property to a boolean value. To handle the state change event you can use the checkedChange
property, which notifies the app when the value has changed.
Usage
<Switch checked="true" (checkedChange)="onCheckedChange($event)"></Switch>
import { Component } from "@angular/core";
import { EventData } from "tns-core-modules/data/observable";
import { Switch } from "tns-core-modules/ui/switch";
@Component({
moduleId: module.id,
templateUrl: "./usage.component.html"
})
export class BasicSwitchComponent {
onCheckedChange(args: EventData) {
let sw = args.object as Switch;
let isChecked = sw.checked; // boolean
}
}
Styling
The styling properties for the Swtich
control are as follows:
-
color
- Controls the handle color -
bacxgroundColor
(background-color
in CSS) - Controls the background color while the switch is in ON state.-
offBackgroundColor
(off-background-color
in CSS) - Controls the background color while the switch is in OFF state.
-
<!-- Styling via inline properties -->
<Switch color="yellow" backgroundColor="green" offBackgroundColor="red">
</Switch>
Note: When using
@nativescript/theme
the default style will be set according to the used theme (no need to set additional CSS classes).
Properties
Name | Type | Description |
---|---|---|
checked |
boolean |
Gets or sets if a switch is checked or not. |
offBackgroundColor |
Color |
Gets or sets the off-state color. |
API References
Name | Type |
---|---|
tns-core-modules/ui/switch | Module |
Switch | Class |
Native Component
Android | iOS |
---|---|
android.widget.Switch | UISwitch |