Editor Menubar Example

NOTE: Please provide feedback on this example in issue 144.

The following example demonstrates using the menubar design pattern to provide access to sets of actions. Each item in this example menubar represents a category of text formatting commands. The formatting commands are revealed in popup menus that can be opened from items in the menubar. This example also demonstrates menuitemradio and menuitemcheckbox elements.

Similar examples include:

Navigation Menubar Example: Example of a menubar with popup menus with navigational links.

Example

Four score and seven years ago our fathers brought forth on this continent a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.

Now we are engaged in a great civil war, testing whether that nation, or any nation, so conceived and so dedicated, can long endure. We are met on a great battle-field of that war. We have come to dedicate a portion of that field, as a final resting place for those who here gave their lives that that nation might live. It is altogether fitting and proper that we should do this.

But, in a larger sense, we can not dedicate, we can not consecrate, we can not hallow, this ground. The brave men, living and dead, who struggled here, have consecrated it, far above our poor power to add or detract. The world will little note, nor long remember what we say here, but it can never forget what they did here. It is for us the living, rather, to be dedicated here to the unfinished work which they who fought here have thus far so nobly advanced. It is rather for us to be here dedicated to the great task remaining before us, that from these honored dead we take increased devotion to that cause for which they gave the last full measure of devotion, that we here highly resolve that these dead shall not have died in vain, that this nation, under God, shall have a new birth of freedom, and that government of the people, by the people, for the people, shall not perish from the earth.

More information on Gettysburg Address

Notes

Menu radio buttons and checkboxes indicate the current format settings.
Disabled menu items are demonstrated in the font size menu, which includes two disabled menuitems .

Keyboard Support

Menubar

Key	Function
`Space or Enter`	Opens popup menu and places focus on the first item in the popup.
`Right Arrow`	Moves focus to the next item in the menubar. If focus is on the last item, moves focus to the first item.
`Left Arrow`	Moves focus to the previous item in the menubar. If focus is on the first item, moves focus to the last item.
`Down Arrow`	Opens popup menu and places focus on the first item in the popup.
`Up Arrow`	Opens popup menu and places focus on the last item in the popup.
`Home`	Moves focus to first item in the menubar.
`End`	Moves focus to last item in the menubar.
`Character`	Moves focus to next item in the menubar having a name that starts with the typed character. If none of the items have a name starting with the typed character, focus does not move.

Popup

Key	Function
`Space or Enter`	Executes action or command, e.g., bolds text, change font.
`Escape`	Closes popup menu. Places focus on parent menubar item.
`Right Arrow`	Closes popup menu. Moves focus to next item in the menubar. Opens popup menu for newly focused item, leaving focus in the menubar.
`Left Arrow`	Closes popup menu. Moves focus to previous item in the menubar. Opens popup menu for newly focused item, leaving focus in the menubar.
`Down Arrow`	Moves focus to the next item in the popup. If focus is on the last item, moves focus to the first item.
`Up Arrow`	Moves focus to previous item in the popup. If focus is on the first item, moves focus to the last item.
`Home`	Moves focus to the first item in the popup.
`End`	Moves focus to the last item in the popup.
`Character`	Moves focus to the next item having a name that starts with the typed character. If none of the items have a name starting with the typed character, focus does not move.

Role, Property, State, and Tabindex Attributes

Menubar

Role	Attribute	Element	Usage
`menubar`		`ul`	Identifies the `ul` element as a container for set of `menuitem` widgets associated with the menubar. Is not focusable because focus is managed using roving tabindex,
	`aria-label="string"`	`ul`	Defines an acessible name for the `menubar`. Helps assistive technology users understand the purpose of the menubar and distinguish it from any other menubars or similar elements on the page.
`menuitem`		`li`	Identifies the `li` element as a menu item within the menubar widget.
	`aria-label="string"`	`li`	Defines an acessible name for the `menuitem`. Overrides browser calculation of accessible name from inner text of all descendants, which includes all the popup menu item names.
	`tabindex="-1"`	`li`	Makes the `menuitem` element keyboard focusable but not part of the `Tab` sequence of the page.
	`tabindex="0"`	`li`	Makes the `menuitem` element keyboard focusable and part of the `tab` sequence of the page. Only one `menuitem` in the `menubar` has `tabindex="0"`. When the page loads, the first item in the menubar has `tabindex="0"`. Focus is managed using roving tabindex, so the most recently focused item will be in the page `Tab` sequence.
	`aria-haspopup="true"`	`li`	Identifies the `menuitem` as having a child popup menu.
	`aria-expanded="true"`	`li`	Indicates the child popup menu is open.
	`aria-expanded="false"`	`li`	Indicates the child popup menu is closed.

Popup Menu

Role	Attribute	Element	Usage
`menu`		`ul`	Identifies the `ul` element as a container for set of `menuitem` widgets associated with the menu. Is not focusable because focus is managed using roving tabindex,
	`aria-label="string"`	`ul`	Defines an acessible name for the `menu`.
`menuitem`		`li`	Identifies the `li` element as a menu item in the popup menu.
	`tabindex="-1"`	`li`	Makes the item focusable but not part of the page `tab` sequence.
`menuitemcheckbox`		`li`	Identifies the `li` element as a menuitemcheckbox widget.
	`tabindex="-1"`	`li`	Makes the menuitemcheckbox focusable but not part of the page `tab` sequence.
	`aria-checked="true"`	`li`	Indicates that the `menuitemcheckbox` is checked. The visual state of the selection is synchronized with the `aria-checked` value using CSS attribute selectors, e.g., [aria-checked="true"], the CSS pseudo selector `:before`, and the `content` property.
	`aria-checked="false"`	`li`	Indicates that the `menuitemcheckbox` is NOT checked. The visual state of the selection is synchronized with the `aria-checked` value using CSS attribute selectors, e.g., [aria-checked="true"], the CSS pseudo selector `:before`, and the `content` property.
`group`		`ul`	Identifies the `ul` element as a container for a set of `menuitemradio` widgets. Enables browsers to compute values of `aria-setsize` and `aria-posinset`.
`menuitemradio`		`li`	Identifies the `li` element as a `menuitemradio` widget. In this example the menuitemradio group is defined by either `ul[role="menu"]` or `[role="group"]`.
	`tabindex="-1"`	`li`	Makes the menuitemradio focusable but not part of the page `tab` sequence.
	`aria-checked="true"`	`li`	Indicates the `menuitemradio` is checked. The visual state of the selection is synchronized with the `aria-checked` value using CSS attribute selectors, e.g., [aria-checked="true"], the CSS pseudo selector `:before`, and the `content` property.
	`aria-checked="false"`	`li`	Indicates that the `menuitemradio` is NOT checked. The visual state of the selection is synchronized with the `aria-checked` value using CSS attribute selectors, e.g., [aria-checked="true"], the CSS pseudo selector `:before`, and the `content` property.

Javascript and CSS Source Code

CSS: menubarAction.css
Javascript: MenubarAction.js
Javascript: MenubarItemAction.js
Javascript: PopupMenuAction.js
Javascript: MenuItemAction.js
Javascript: TextStyling.js

Editor Menubar Example

Example

Notes

Keyboard Support

Menubar

Popup

Role, Property, State, and Tabindex Attributes

Menubar

Popup Menu

Javascript and CSS Source Code

HTML Source Code