|
|
Whitebeam Library Definition
|
menuinfo
Menu item attributes.
See Also
rbaddmenulist() rbaddmenutree() Elements
The menuinfo struct has 8 elements:
| Name | Type/Value | Range/Length | Description | | key | string | text | Optional. Unique identifier of a menu item in the application (defaults to name). | | name | string | text | Optional. Display text of a menu item. | | parent | string | text | Optional. key of an existing menu item to which other specified attributes are applied or of parent of
sub menu items.
| | blockid | string | text | Optional. Identifier (rb:id attribute value) of <rb:block> tag that defines the menu item. The body of the block
can be any valid XML/HTML designed to fit within the menu bar but in place of the menu bullet and display (hyper)text.
| | href | string | text | Optional. Location of the menu item in the format:
protocol://hostname/pathname?search#hash
A full pathname should be specified with blockid and name attributes to ensure default menu item selection.
| | target | string | text | Optional. A companion attribute to href e.g. _blank displays selection in a new browser window. | | expand | string | yes | Optional. Selects a menu item with a similar but complementary result to default or forced menu item selection. | | rlevel | number | 1.. | Optional. Mandatory for rbaddmenulist. Relative level of menu item within the list (set to 1 for the first item in
the array).
|
Remarks
By default, the last menu item with href attribute value that is the longest substring of the location (URL/URI)
obtained from the browser becomes the selected menu item. The menu tree leading up to and including the selected
menu item is automatically expanded and the selected item is automatically highlighted. The style of menu item text can be specified (perhaps in a style sheet) with definitions:
a.menu when selectable (i.e. href specified);
.menunormal when unselectable;
.menuselect once selected. Where a menu item is defined with a blockid attribute, default selection will only be possible if href attribute is set appropriately.
The order of precedence is parent, blockid, name if any combination of these attributes are specified. By default, each menu level is implemented as a row per menu item indented by one column from the previous level.
The menu item bullet is in the first column for that level and name in next column. When a blockid is specified, its content spans
both of columns (i.e. a bullet is not automatically applied) of that level.
|
|
|
(loadtime : 11ms) |
