AppBarCommand.priority property

Gets or sets the priority of the command.

Syntax

<div data-win-control="WinJS.UI.AppBarCommand" data-win-options="{ priority : value}" />
var priority = appBarCommand.priority;
appBarCommand.priority = priority;

Property value

Type: ****

A number greater than or equal to 0 that specifies the priority level of the command. Lower numbers indicate greater priority. The default value is undefined.

Remarks

By default, the AppBar displays as many commands as possible in the action area. Commands that don't fit in the action area appear in the AppBar control's overflow area.

When space is limited, the AppBar moves commands at the end of the list, or with lower priority values, to the overflow area. You can use the commands' section property to influence whether they appear in the action area or the overflow area. If you want the command to appear in the action area (if space permits), set its section property to "primary". If you want a command to always appear in the overflow area (regardless of whether there is space in the action area), set its section property to "secondary".

Requirements

Minimum WinJS version

WinJS 4.0

Namespace

WinJS.UI

See also

AppBarCommand