boxmenu RDME

adapt-contrib-boxMenu

Box Menu is a menu bundled with the Adapt framework.
Menu choices are framed within a box element and arranged in a grid.

Visit the Box Menu wiki for more information about its functionality and for explanations of key properties. Options include an estimated time for completion (duration) and a progress bar to indicate the percentage of components that have been completed.

##Installation

As Adapt's core menu, Box Menu is included with the installation of the Adapt framework and the installation of the Adapt authoring tool.

• If Box Menu has been uninstalled from the Adapt framework, it may be reinstalled. With the Adapt CLI installed, run the following from the command line:
  adapt install adapt-contrib-boxMenu

  Alternatively, this component can also be installed by adding the following line of code to the adapt.json file:
  "adapt-contrib-boxMenu": "*"
  Then running the command:
  adapt install
  (This second method will reinstall all plug-ins listed in adapt.json.)

• If Box Menu has been uninstalled from the Adapt authoring tool, it may be reinstalled using the Plug-in Manager.

##Uninstallation
The Adapt framework does not allow the installation of more than one menu at a time. In order to replace Box Menu it must be uninstalled. With the root of your framework installation as your current working directory, run the following command:
adapt uninstall adapt-contrib-boxMenu

Back to Top

Settings Overview

The attributes listed below are used in contentObjects.json to configure BoxMenu, and are properly formatted as JSON in example.json. Visit the BoxMenu wiki for more information about how they appear in the authoring tool.

Attributes

_id (string): This is a unique identifier that establishes relationships with other content structures. It is referenced in articles.json as the _parentid of an article model.

_parentId (string): This value is sourced from the parent element's _id found within course.json. It must match.

_type (string): This value determines what the learner will access by clicking the provided link/button. Acceptable values are "page" and "menu". "page" will direct the learner to a page structured with articles, blocks, and components. "menu" will direct the learner to a page with more menus.

_classes (string): CSS class name to be applied to Box Menu’s containing div. The class must be predefined in one of the Less files. Separate multiple classes with a space.

title (string): This text is a reference title for the content object.

displayTitle (string): This text is displayed on the menu item.

body (string): Optional text that appears on the menu item. Often used to inform the learner about the menu choice.

_graphic (object): The image that appears on the menu item. It contains values for alt and src.

alt (string): This text becomes the image’s alt attribute.

src (string): File name (including path) of the image. Path should be relative to the src folder (e.g., "course/en/images/origami-menu-one.jpg").

linkText (string): This text is displayed on the menu item's link/button.

durationLabel (string): Optional text which precedes duration (e.g., "Duration:").

duration (string): Optional text which follows durationLabel (e.g., "2 mins").

Back to Top

Limitations

No known limitations.

Browser Spec

This menu has been tested to the standard Adapt browser specification.

---

Version number: 2.0
Framework versions: 2.0
Author / maintainer: Adapt Core Team
Accessibility support: WAI AA
RTL support: yes
Cross-platform coverage: Chrome, Chrome for Android, Firefox (ESR + latest version), IE 11, IE10, IE9, IE8, IE Mobile 11, iPhone (iOS 7+8), Safari iPad (iOS 7+8), Safari 8, Opera