Menu Item Object

From MSX - Wiki
Revision as of 11:48, 8 January 2021 by Benzac (talk | contribs) (Created page with "<syntaxhighlight lang="json"> { "id": "menu_item_id", "type": "default", "display": true, "enable": true, "focus": false, "icon": "blank", "label":...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
{
    "id": "menu_item_id",
    "type": "default",
    "display": true,
    "enable": true,
    "focus": false,
    "icon": "blank",
    "label": "Item Label",
    "background": "http://link.to.image",    
    "extensionIcon": "blank",
    "extensionLabel": "Extension Label",
    "data": null,
    "options": null
}
Property Type Default Value Mandatory Since Version Description
id string null No 0.1.0

The ID of the menu item. This property can be used to identify the item. The ID must be unique and only consist of letters, numbers, and the special characters "_", "-", ".".

type string "default" No 0.1.0

The type of the menu item.

  • "default": Default item.
  • "separator": Separator item. This type can be used to group menu items by adding separator lines. It is also possible to add a label to a separator line.
display boolean true No 0.1.0

Indicates if the menu item is displayed. This property can be used to temporarily remove items.

enable boolean true No 0.1.0

Indicates if the menu item is enabled. This property can be used to temporarily disable items.

focus boolean false No 0.1.0

Indicates if the menu item is focused. This property can be used to set the focus to a specific item.

Note: If this property is set to true for multiple items, only the first item will get the focus.

icon string null No 0.1.0

The icon of the menu item. Please see Icons for possible values.

label string null No 0.1.0

The label of the menu or separator item. This property supports inline expressions. For more information, please see Inline Expressions.

background string null No 0.1.0

The background image that is used if no other background is set at lower levels.

extensionIcon string null No 0.1.0

The extension icon. This property can be used to display an additional icon on the right side of the menu item. Please see Icons for possible values.

extensionLabel string null No 0.1.0

The extension label. This property can be used to display an additional label on the right side of the menu item. This property is only used if no extensionIcon is set. This property supports inline expressions. For more information, please see Inline Expressions.

data string|object null No 0.1.0

The menu item data. This property is used to display the corresponding content. It can be indicated as link (string) or directly as content root object (object). If this property is not set, a default content page with headline "Content Not Available" is displayed. Please see Content Root Object for the data structure.

options object null No 0.1.120

A special content page object that is displayed in a content panel if the menu item is selected and the menu button is pressed. The availability of options for the current selected item is indicated in the lower right corner of the content screen. Please see Content Page Object for the data structure.