The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ToggleSwitch.onchange event

Applies to Windows and Windows Phone

Occurs when the ToggleSwitch control is flipped to on (checked == true) or off (checked == false).

Syntax

HTML


<div data-win-control="WinJS.UI.Toggle" 
    data-win-options="{onchange : handler}">
</div>

JavaScript


function handler(eventInfo) { /* Your code */ }
 
// addEventListener syntax
toggleSwitch.addEventListener("change", handler);
toggleSwitch.removeEventListener("change", handler);

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

eventInfo

Type: Event

An object that contains information about the event.

Remarks

Setting event handlers declaratively (in HTML)

To set the event handler declaratively, it must be accessible to the global scope, and you must also call WinJS.Utilities.markSupportedForProcessing or WinJS.UI.eventHandler on the handler. You can make the handler accessible to the global scope by using WinJS.Namespace.define. For more information, see How to set event handlers declaratively.

Requirements

Minimum WinJS version	WinJS 1.0
Namespace	WinJS.UI