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.

NavBar.addEventListener method

Applies to Windows only

[NavBar is no longer available for use as of Windows Library for JavaScript (WinJS) 4.2. Instead, use SplitViewCommand. ]

Registers an event handler for the specified event.

Syntax

JavaScript


navBar.addEventListener(eventName, eventHandler, useCapture);

Parameters

eventName

Type: String

The name of the event to handle. Note that you drop the "on" when specifying the event name. For example, instead of specifying "onclick", you specify "click".

eventHandler

Type: Function

The event handler function to associate with the event.

useCapture

Type: Boolean

Set to true to register the event handler for the capturing phase; otherwise, set to false to register the event handler for the bubbling phase.

Return value

This method does not return a value.

Remarks

Setting event handlers declaratively (in HTML)

To set an 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 2.0
Namespace	WinJS.UI