Skip to content
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
_cq_design_dialog
_cq_dialog
clientlibs
.content.xml
README.md
group.html
item.html
itemContent.html
navigation.html

README.md

Navigation (v1)

Navigation component written in HTL that renders a website navigation tree.

Features

  • Can be used on both templates and pages
  • Defines a configurable navigation root, and structure depth to allow flexibility in building the navigation tree
  • Automatically filters out pages that should be hidden from navigation
  • Automatically handles redirect targets defined on pages

Use Object

The Navigation component uses the com.adobe.cq.wcm.core.components.models.Navigation Sling model as its Use-object.

Component Policy Configuration Properties

The following configuration properties are used:

  1. ./navigationRoot - the root page from which to build the navigation. Can be a blueprint master, language master or regular page.
  2. ./skipNavigationRoot - if true, excludes the navigation root in the resulting tree, including its descendants only.
  3. ./collectAllPages - if true, collects all pages that are descendants of the ./navigationRoot. Overrides ./structureDepth.
  4. ./structureDepth - the depth of the navigation structure, relative to the navigation root.

Edit Dialog Properties

The following properties are written to JCR for the Navigation component and are expected to be available as Resource properties:

  1. ./navigationRoot - the root page from which to build the navigation. Can be a blueprint master, language master or regular page.
  2. ./skipNavigationRoot - if true, excludes the navigation root in the resulting tree, including its descendants only.
  3. ./collectAllPages - if true, collects all pages that are descendants of the ./navigationRoot. Overrides ./structureDepth.
  4. ./structureDepth - the depth of the navigation structure, relative to the navigation root.

Client Libraries

The component provides a core.wcm.components.navigation.v1.editor editor client library category that includes JavaScript handling for dialog interaction. It is already included by its edit and design dialogs.

BEM Description

BLOCK cmp-navigation
    ELEMENT cmp-navigation__group
    ELEMENT cmp-navigation__item
        MOD cmp-navigation__item--active
        MOD cmp-navigation__item--level-*
    ELEMENT cmp-navigation__item-link

Information

You can’t perform that action at this time.