Reader Level:
Article

App-Bar in Windows Store Apps

By Deepak Middha on Dec 10, 2012
In this article I described how to create a Windows Store App for App-Bar using JavaScript.

Introduction

In this article I describe how to create Windows Store Apps for App-Bar using JavaScript. If a command in an App-Bar requires a flyout, then one can be shown using the AppBarCommand control. When the user executes a command in a flyout off of an AppBar, then the flyout and the AppBar should both dismiss.

I assume you can create a simple Windows Store App using JavaScript; for more help visit Simple Windows Store Apps using JavaScript.

To start the creation of the apps, add one JavaScript page by right-clicking on the js folder in the Solution Explorer and select Add > new item > JavaScript Page and then provide an appropriate name. In the same way, add a HTML page to your project.

formating-text-in-windows-stopre-app.jpg

Write the following code in the default.html:

<!DOCTYPE html>

<html>

<head>

    <meta charset="utf-8" />

    <title></title>

    <link rel="stylesheet" href="//Microsoft.WinJS.1.0/css/ui-light.css" />

    <script src="//Microsoft.WinJS.1.0/js/base.js"></script>

    <script src="//Microsoft.WinJS.1.0/js/ui.js"></script>

    <link rel="stylesheet" href="/css/default.css" />

    <script src="/js/default.js"></script>

</head>

<body role="application" style="background-color: lightgoldenrodyellow">

    <center><div id="rootGrid">

        <div id="content">

            <h1 id="featureLabel"></h1>

            <div id="contentHost"></div>

        </div>

    </div></center>

</body>

</html>

Write the following code in the default.js:
 

(function () {

    "use strict";

    var appTitle = "app";

    var pages = [

        { url: "page.html" }

    ];

    function activated(eventObject) {

        if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {

            eventObject.setPromise(WinJS.UI.processAll().then(function () {

                var url = WinJS.Application.sessionState.lastUrl || pages[0].url;

                return WinJS.Navigation.navigate(url);

            }));

        }

    }

    WinJS.Navigation.addEventListener("navigated", function (eventObject) {

        var url = eventObject.detail.location;

        var host = document.getElementById("contentHost");

        host.winControl && host.winControl.unload && host.winControl.unload();

        WinJS.Utilities.empty(host);

        eventObject.detail.setPromise(WinJS.UI.Pages.render(url, host, eventObject.detail.state).then(function () {

            WinJS.Application.sessionState.lastUrl = url;

        }));

    });

    WinJS.Namespace.define("App", {

        appTitle: appTitle,

        pages: pages

    });

    WinJS.Application.addEventListener("activated", activated, false);

    WinJS.Application.start();

})();

Write the following code in the page.html:

<!DOCTYPE html>

<html>

<head>

    <title></title>

    <link rel="stylesheet" href="/css/appbar-flyout.css" />

    <script src="/js/script.js"></script>

</head>

<body>

    <div data-win-control="App.pageInput">

    </div>

    <div data-win-control="App.pageOutput">

    </div>

    <div id="respondFlyout" data-win-control="WinJS.UI.Menu">

        <button data-win-control="WinJS.UI.MenuCommand" data-win-options="{id:'alwaysSaveMenuItem',label:'Always save drafts',type:'toggle', selected:true}">

        </button>

        <hr data-win-control="WinJS.UI.MenuCommand" data-win-options="{id:'separator',type:'separator'}" />

        <button data-win-control="WinJS.UI.MenuCommand" data-win-options="{id:'replyMenuItem',label:'Reply'}">

        </button>

        <button data-win-control="WinJS.UI.MenuCommand" data-win-options="{id:'replyAllMenuItem',label:'Reply All'}">

        </button>

        <button data-win-control="WinJS.UI.MenuCommand" data-win-options="{id:'forwardMenuItem',label:'Forward'}">

        </button>

    </div>

    <div id="deleteFlyout" data-win-control="WinJS.UI.Flyout" aria-label="{Confirm delete flyout}">

        <div>

            If you delete this photo it cannot be recovered.

        </div>

        <button id="confirmDeleteButton">

            Delete Photo</button>

    </div>

    <div id="appBar" data-win-control="WinJS.UI.AppBar" data-win-options="{}">

        <button data-win-control="WinJS.UI.AppBarCommand" data-win-options="{id:'respondButton',label:'Respond',icon:'edit',type:'flyout',flyout:select('#respondFlyout')}">

        </button>

        <button data-win-control="WinJS.UI.AppBarCommand" data-win-options="{id:'deleteButton',label:'Delete',icon:'delete',type:'flyout',flyout:select('#deleteFlyout')}">

        </button>

    </div>

</body>

</html>

Write the following code in the script.js:

(function () {

    "use strict";

    var page = WinJS.UI.Pages.define("page.html", {

        ready: function (element, options) {

            document.getElementById("confirmDeleteButton").addEventListener("click", confirmDelete, false);

            document.getElementById("alwaysSaveMenuItem").addEventListener("click", alwaysSave, false);

            document.getElementById("replyMenuItem").addEventListener("click", reply, false);

            document.getElementById("replyAllMenuItem").addEventListener("click", replyAll, false);

            document.getElementById("forwardMenuItem").addEventListener("click", forward, false);

            document.getElementById("appBar").addEventListener("beforeshow", clearStatus, false);

            WinJS.log && WinJS.log("To show the bar, swipe up from the bottom of the screen, right-click, or press Windows Key+Z. To dismiss the bar, tap in the application, swipe, right-click, or press Windows Logo+Z again.", "page", "status");

        },

        unload: function () {

            var appbar = document.getElementById("appBar");

            appbar.parentNode.removeChild(appbar);

        }

    });

    function hideFlyoutAndAppBar() {

        document.getElementById("respondFlyout").winControl.hide();

        document.getElementById("appBar").winControl.hide();

    }

    function confirmDelete() {

        WinJS.log && WinJS.log("You have deleted the item.", "page", "status");

        hideFlyoutAndAppBar();

    }

    function alwaysSave() {

        var alwaysSaveState = document.getElementById("alwaysSaveMenuItem").winControl.selected;

        WinJS.log && WinJS.log("The Always save option is now set to: " + alwaysSaveState + ".", "page", "status");

        hideFlyoutAndAppBar();

    }

    function reply() {

        WinJS.log && WinJS.log("You replied to the message.", "page", "status");

        hideFlyoutAndAppBar();

    }

    function replyAll() {

        WinJS.log && WinJS.log("You replied all the message.", "page", "status");

        hideFlyoutAndAppBar();

    }

    function forward() {

        WinJS.log && WinJS.log("You forwarded the message.", "page", "status");

        hideFlyoutAndAppBar();

    }

    function clearStatus() {

        WinJS.log && WinJS.log("", "page", "status");

    }

})();

Summary

In this article I described how to create a Windows Store App for App-Bar using JavaScript. I hope this article has helped you to understand this topic. Please share it. If you know more about this, your feedback and constructive contributions are welcome.

Deepak Middha

Deepak Middha is one time Microsoft MVP(Client App Dev) , working as Sr. Software Developer with lots of hands on experience using ASP.NET 2.0/3.5, AJAX, MVC, C#,  SQL Server 2005/2008/2012, WCF, JQuery and Silverl... Read more

COMMENT USING