AppBar.addEventListener method

Registers an event handler for the specified event.

Learn about events with Quickstart: adding HTML controls and handling events.

Syntax

appBar.addEventListener(type, listener, useCapture);

Parameters

  • type
    Type: String

    The event type (name) to register. It must be beforeopen, beforeclose, afteropen, or afterclose.

  • listener
    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. For more information, see Event capture and event bubbling with DOM events.

Return value

This method does not return a value.

Requirements

Minimum WinJS version

WinJS 1.0

Namespace

WinJS.UI

See also

AppBar

AppBarCommand

AppBarIcon

BackButton

NavBar

Your first app - Part 3: PageControl objects and navigation

Navigating between pages (HTML)

Adding app bars

Adding nav bars

HTML AppBar control sample

HTML NavBar control sample

Navigation and navigation history sample

Designers

Command patterns

Navigation patterns

Guidelines for app bars

Bottom app bar

Top app bar