Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Primary navigation (also referred to as site navigation) is main navigation element appearing at the top of every page that allows visitor to explore the various areas of your site.

Primary navigation example.Image Added

To modify the contents of the primary navigation, locate and edit:
Base Folder/inc/nav-primary

 

Primary nav asset location in Cascade.Image Added

Below are the editable elements of the primary navigation used to add items to the primary nav. You will need to publish the navigation for changes to take effect.

Datadef elementDescription
Nav widget

This option adds extra content to the right side of the navigation bar. Available options are:

  • None - nothing is added.
  • Date - adds displays the current date.
  • Weather - displays the current weather (updated hourly).

Note: for the weather widget to function properly, you must also add the following custom external JavaScript reference in

Weather

your site settings (refer to Configuring Customizations):
//web.communications.uci.edu/php/uci-weather/weather.js.php

Nav itemThis represents a single item in the navigation. You can add and remove instances of this field group using the + and - toggles.
Nav item > Item type

Defines the characteristics of the nav item.

  • link - defines the nav item as a simple link.
  • dropdown - defines the nav item as a button that toggles a dropdown menu.
  • link and dropdown - defines the nav item as a link with a dropdown menu toggle button next to it.

Nav item types

Below are the available primary nav item types, selectable via the 'Item type' datadef element (see above).

Setting 'Item type' to 'link' adds a simple link to the primary nav and reveals the following datadef elements:

Datadef elementDescription
Nav item > LinkOnly appears if 'Item type' is set to 'link'. Refer to 'Working with links'.

Dropdown

Setting 'Item type' to 'Dropdown' adds a dropdown menu to the primary nav and reveals the following datadef elements:

Datadef elementDescription
Nav item > TextRequired. Defines the text label for the nav item dropdown toggle.
Nav item > Set internationalizationUsed to apply internationalization to dropdown toggle labels. Refer to 'Internationalization '.
Nav item > Dropdown > Dropdown itemRepresents an item in the dropdown menu. You can add and remove instances of this field group using the + and - toggles.
Nav item > Dropdown > Dropdown item > Item type

Indicated what is added to the dropdown menu. Available options are:

  • link - adds a link.
  • heading - adds a heading, useful if your have multiple categorizable groups of links in the dropdown menu. Note that headings are not linkable.
  • divider - adds a divider, useful for separating groups of links in the dropdown menu.
Nav item > Dropdown > Dropdown item > Text

Required. Only appears if 'Item type' is set to 'heading'. Defines the text used for the heading.

Nav item > Dropdown > Dropdown item > Set internationalization

Used to apply internationalization options for dropdown menu headings. Refer to 'Internationalization'.

Nav item > Dropdown > Dropdown item > LinkRefer to 'Working with links'.

Link and dropdown

Setting 'Item type' to 'link and dropdown' adds a link to the primary nav with an associated dropdown menu. The datadef element reference tables for Link and Dropdown above apply.