section
Last updated
Last updated
Sections are used to group related items with each other. Sections can have headings, can be collapsable and are not associated with a destination.
Grouping items into sections:
makes them discoverable
makes them easy to locate
tells the user that they are related
section
best practices
Grouping items: When grouping items, think about how they relate and place them in order of most to least frequently used.
Naming sections: Give your sections short, concise names. Avoid using action words (you can keep those for button copy) - e.g. use “Wells” instead of “View wells”.
label
Optional
Default: unset
<section label="{$:getRole()}: General"/>
Provide a label for a group of navigation items.
collapsable
Optional
Type: boolean
Default: false
<section collapsable="true"/>
Specify that the section should be collapsable.
from-js
Optional
id
items
<section items="$:buildItems()"/>
show-if
and hide-if
Type: string
(static text, a or the return value of a )
Construct a section from JavaScript/TypeScript using a that returns an object array of type navigationSection
.
Construct a section's items from Javascript using a that returns an object array of type navigationItem
.