Share via

Quickstart: Adding a flyout (HTML)

[ This article is for Windows 8.x and Windows Phone 8.x developers writing Windows Runtime apps. If you’re developing for Windows 10, see the latest documentation ]

This Quickstart explains how to create and style a flyout. (Windows only)


Building your first Windows Windows Store app with JavaScript

Guidelines and checklist for flyouts

1. Create a flyout

In this example, when the user presses the Buy button, a flyout appears above the button. A flyout is a control in the Windows Library for JavaScript, WinJS.UI.Flyout, and should be the direct child of the <body> element.

    <!-- Button that launches the confirmation Flyout. -->
    <button class="action" id="buyButton">Buy</button>

    <!-- Confirmation Flyout. -->
    <div id="confirmFlyout" data-win-control="WinJS.UI.Flyout" aria-label="{Confirm purchase flyout}">
        <div>Your account will be charged $252.</div>
        <button id="confirmButton">Complete Order</button>
// Initialize WinJS controls.

// Initialize event listeners.
document.getElementById("buyButton").addEventListener("click", showConfirmFlyout, false);
document.getElementById("confirmButton").addEventListener("click", confirmOrder, false);

// Command and Flyout functions.
function showConfirmFlyout() {
    showFlyout(confirmFlyout, buyButton, "top");
function showFlyout(flyout, anchor, placement) {, placement);
function confirmOrder() {

2. Style the flyout.

You can keep the standard styling of the Light and Dark UI themes, shown here, or customize the styling, as we'll show next.

A Flyout in the light style

A flyout in the dark style


There are a number of CSS properties for flyouts that you can customize.

Property Example


Controls the font of the text

font-family:'Segoe UI';


Controls the size of the text



Controls the color of the text

color:rgb(0, 0, 0);


Controls the background color of the face

background-color:rgb(255, 255, 255);


Controls the thickness, color, and line style of the border

border:2px solid rgb(128, 128, 128);


Controls the maximum width of the box



This example is from the HTML flyout control sample and depends primarily on the default styling.

    /* Flyout title. */
    .win-flyout:not(.win-menu) .win-type-x-large
        font-weight: 300;
        margin-top: -13px;
        padding-bottom: 18px;

    /* Flyout buttons. */
    .win-flyout:not(.win-menu) button,
    .win-flyout:not(.win-menu) input[type="button"]
        margin-top: 16px;
        margin-left: 20px;
        float: right;

This example goes a bit further with the more obvious visual elements, but is pretty ugly.

    /* Flyout with attent-getting colors. */
        background-color: yellow;
        border-color: red;
        color: green;

A styled flyout


In this Quickstart you created and styled a flyout in response to a user action.


HTML flyout control sample