Selectmenu Widget will act as a proxy back to the original select element, controlling its state for form submission or serialization.

Selectmenu Widget support both in-place "popup" or drop-down styles. It supports optgroups and custom markup to render specific presentations like multiple lines.

The select or its options can be disabled by adding the disbaled="disabled" attribite to that element.

Keyboard interaction

When the menu is open, the following key commands are available:

+
• UP/LEFT - Move focus to the previous item. If on first item, move focus to the last item.
+
• DOWN/RIGHT - Move focus to the next item. If on last item, move focus to the first item.
+
• END/PAGE DOWN - Focus last item.
+
• HOME/PAGE UP - Focus first item.
+
• ESCAPE - Close the select.
+
• ENTER - Select the currently focused item and close the select.
+
• ALT+UP/DOWN - Toggle select.
+
• SPACE - Toggle select.
+

When the menu is closed, the following key commands are available:

+
• UP/LEFT - Select the previous item. If on first item, select the last item.
+
• DOWN/RIGHT - Select the next item. If on last item, select the first item.
+
• END/PAGE DOWN - Select last item.
+
• HOME/PAGE UP - Select first item.
+
• ALT+UP/DOWN - Toggle select.
+
• SPACE - Toggle select.
+