Gets or sets the layout of the app bar contents.
"commands" if the content of the app bar is laid out using AppBarCommand.section; otherwise "custom", indicating that the app is responsible for its own custom layout. The default is "commands".
A layout property set to "commands" can include two sections: "global" and "selection".
"global" maps to right and "selection" maps to left in LTR (left-to-right) layouts. The opposite is true in RTL (right-to-left) layouts.
"global" is intended for commands that should be displayed at all times.
"selection" is intended for context commands for selected objects.
"global" is for primary commands that are always visible in the app bar. Only the first four commands declared as "global" are displayed.
"selection" is for non-primary (or secondary) commands. These are text-based menu items that appear when a primary command is invoked. All commands declared as "selection" are displayed (based on display resolution).
An AppBar control with a layout property set to "custom" can contain any HTML. However, an app bar with a "custom" layout doesn’t have the full functionality available to an app bar using the "commands" layout.
Minimum supported client
|Windows 8 [Windows Store apps only]|
Minimum supported server
|Windows Server 2012 [Windows Store apps only]|
Minimum supported phone
- 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
- Command patterns
- Navigation patterns
- Guidelines for app bars
- Bottom app bar
- Top app bar