Tabs is a Kineo presentation component.
The component displays a vertically or horizontally stacked list of heading tabs. Each heading is associated with a hidden content panel. Clicking a heading toggles the visibility of its content panel. The first content panel is visible by default. Content panels may contain text and/or an image.
If using the Adapt CLI, run adapt install adapt-tabs
.
Alternatively, open the /src/components folder in a new terminal window on Mac OSX or right click the folder and select 'Git Bash Here' on Windows.
Git clone the component, making sure to delete the hidden .git folder from the adapt-tabs folder.
The attributes listed below are used in components.json to configure Tabs, and are properly formatted as JSON in example.json.
_id (string): A unique identifier.
_parentId (string): An identifier that links the component to the parent block.
_type (string): The type of the particular item. Examples include block and component.
_component (string): This value must be: tabs
.
_classes (string): CSS class name to be applied to the container div. The class must be predefined in one of the Less files. Separate multiple classes with a space.
_layout (string): This defines the horizontal position of the component in the block. Acceptable values are full
, left
or right
.
title (string): The title of the particular item.
displayTitle (string): This is the title that Adapt displays when viewing a course.
body (string): The body text content of the particular item.
instruction (string): This optional text appears above the component. It is frequently used to guide the learner’s interaction with the component.
_tabLayout (string): Defines the layout of the tabs. Acceptable values are left
and top
. By default, component displays left
layout for medium screen size and below.
_items (array): Multiple items may be created. Each _item represents one element of the tabs component and contains values for tabTitle, title, body, _classes and _graphic.
tabTitle (string): This text is displayed in the actual tab heading. Recommend keeping this title short.
title (string): This text is displayed as the content panel's header. It is displayed when the tab has been selected.
body (string): This content will be displayed when the learner opens this content panel. It may contain HTML.
_classes (string): An optional class that will be applied to the Tabs Item.
_graphic (object): An optional image which is displayed below the item body when the learner opens this content panel. It contains values for src and alt.
src (string): File name (including path) of the image. Path should be relative to the src folder (e.g., course/en/images/tabs.jpg).
alt (string): This text becomes the image’s alt attribute.
Tabs has been assigned a label using the aria-label attribute: ariaRegion. This label is not a visible element. It is utilized by assistive technology such as screen readers. Should the region's text need to be customised, it can be found within the globals object in course.json.
tabTitle headings will be replaced by ... if the heading is too long for the container.
Version number: 2.1.0
Framework versions: 2.0+
Author / maintainer: Kineo
Accessibility support: WAI AA
RTL support: Yes
Cross-platform coverage: To be confirmed