Landcare Design System Brand governed documentation

Menu

A list of navigation choices or actions grouped in a predictable order. This is a digital component: Interface parts for websites, apps, online forms, documentation sites, and Opries-style repositories.

Purpose

The Menu component gives Landcare groups a repeatable way to solve this communication problem without rebuilding the layout from scratch. It should inherit approved colour, typography, spacing, grid, accessibility, and logo guidance from the design system.

When To Use

UseAvoid
Use when the content or interaction matches the component purpose and benefits from a familiar pattern.Avoid inventing a one-off layout when this component already solves the job.
Use the component with clear hierarchy, generous spacing, and one obvious first-read message or action.Avoid adding extra borders, colours, icons, or type styles just to make the component feel more designed.
Use approved Landcare tokens so group forks can inherit brand updates cleanly.Avoid local colour, typography, or logo changes that break brand consistency.

Web Guidance

Use navigation to show location, choices, progression, or related sections without making people remember where they are.

  • Structure: use semantic HTML, predictable reading order, and responsive sizing.
  • Accessibility: support keyboard access, visible focus, meaningful labels, sufficient contrast, and colour-independent meaning.
  • Layout: align the component to the page grid where it is a major element; use local spacing inside the component.
  • State: document default, hover, focus, active, disabled, loading, error, and success states where relevant.

Menu Pattern Guidance

PatternUseAvoid
Sidebar or section menuUse for documentation, resource libraries, long pages, portals, dashboards, and nested information structures. Use a compact rhythm with tight gaps and faint dividers between top-level items, similar to the Landcare Design System sidebar.Avoid using a sidebar menu for a short marketing site where a header menu is enough, or adding card-like spacing between every item.
Header navigation linksUse .lds-menu-header inside a website header or topbar when a small number of top-level destinations such as About, Events, Resources, and Contact are needed. Keep dropdowns short and predictable.Avoid large, multi-column dropdown systems unless the information architecture has been tested.
Website topbar with searchUse .lds-site-topbar for a full-width header with a brand or logo position on the left and .lds-header-search on the right. Use Ctrl K or Command K to focus search, then support arrow keys, Enter, and Escape in the results panel.Avoid placing result lists directly inside .lds-menu-header without a content wrapper, because descendant links can otherwise be mistaken for navigation items. Avoid single-character global shortcuts such as / unless users can turn them off or remap them.

Digital Examples

Sidebar or section menu

Use for documentation, resource libraries, portals, dashboards, and long pages where people need compact nested section navigation.

CSS Implementation

Import the selected brand token file first, then import the shared component layer.

@import "@landcare-design-system/css/dist/landcare.css";
@import "@landcare-design-system/css/dist/components.css";
ClassUse
.lds-menuStyles compact navigation lists. Use `--lds-menu-item-gap`, `--lds-menu-divider-colour`, `--lds-menu-link-padding-block`, `--lds-menu-link-padding-start`, `--lds-menu-link-font-size`, and `--lds-menu-link-font-weight` to tune rhythm.
.lds-menu-sidebarUse for left navigation, section navigation, documentation menus, and nested page structures. Defaults to the compact rhythm and faint top-level dividers used by the Landcare Design System sidebar.

Starter Markup

<nav class="lds-menu lds-menu-sidebar" aria-label="Section navigation">
  <ul>
    <li><a href="#overview">Overview</a></li>
    <li>
      <details open>
        <summary>Programs</summary>
        <ul>
          <li><a href="#landcare">Landcare</a></li>
          <li><a href="#coastcare">Coastcare</a></li>
          <li><a href="#junior-landcare">Junior Landcare</a></li>
        </ul>
      </details>
    </li>
    <li>
      <details>
        <summary>Resources</summary>
        <ul>
          <li><a href="#forms">Forms</a></li>
          <li><a href="#field-guides">Field guides</a></li>
        </ul>
      </details>
    </li>
    <li><a href="#contact">Contact</a></li>
  </ul>
</nav>

Header navigation links

Use inside a website header or topbar when the site needs a small number of top-level destinations and short dropdowns.

CSS Implementation

Import the selected brand token file first, then import the shared component layer.

@import "@landcare-design-system/css/dist/landcare.css";
@import "@landcare-design-system/css/dist/components.css";
ClassUse
.lds-menuStyles compact navigation lists. Use `--lds-menu-item-gap`, `--lds-menu-divider-colour`, `--lds-menu-link-padding-block`, `--lds-menu-link-padding-start`, `--lds-menu-link-font-size`, and `--lds-menu-link-font-weight` to tune rhythm.
.lds-menu-headerUse for horizontal website header navigation with a small set of top-level items.

Starter Markup

<nav class="lds-menu lds-menu-header" aria-label="Website navigation">
  <a href="/">Home</a>
  <details>
    <summary>About</summary>
    <div>
      <a href="/about/">About the group</a>
      <a href="/projects/">Projects</a>
      <a href="/partners/">Partners</a>
    </div>
  </details>
  <a href="/events/">Events</a>
  <a href="/contact/">Contact</a>
</nav>

Website topbar with search

Use when a site header needs a brand or logo position on the left and instant search on the right. Use text such as Landcare as a proxy until approved inline logo artwork is supplied. Support Ctrl K or Command K to focus search, then Arrow Up, Arrow Down, Enter, and Escape inside the results.

Landcare
Ctrl K
  1. Planting guide

    Species selection, site preparation, and follow-up care.

  2. Community field day

    Event details, registration, and accessibility notes.

CSS Implementation

Import the selected brand token file first, then import the shared component layer.

@import "@landcare-design-system/css/dist/landcare.css";
@import "@landcare-design-system/css/dist/components.css";
ClassUse
.lds-site-topbarWraps a site brand link, header navigation, and optional search or utility content in one topbar.
.lds-site-topbar-brandStyles the home or organisation link inside a site topbar.
.lds-header-searchWraps an instant header search form and result dropdown so result links do not inherit menu-item spacing. Pair with Ctrl K / Command K focus behaviour where scripted search is used.
.visually-hiddenKeeps accessible labels available to assistive technology while hiding repeated visible text.
.lds-header-search-fieldWraps the search input and keyboard shortcut hint so the hint sits inside the field without becoming the accessible label.
.lds-header-search-resultsStyles a compact header search results surface with normal content links and excerpts.

Starter Markup

<header class="lds-site-topbar">
  <a class="lds-site-topbar-brand" href="/" aria-label="Landcare home">
    <span>Landcare</span>
  </a>
  <search class="lds-header-search">
    <form role="search">
      <label class="visually-hidden" for="site-search-example">Search documentation</label>
      <span class="lds-header-search-field">
        <input id="site-search-example" type="search" name="q" placeholder="Search documentation" autocomplete="off" aria-autocomplete="list" aria-controls="site-search-example-results" aria-expanded="false">
        <kbd data-search-shortcut-hint>Ctrl K</kbd>
      </span>
    </form>
    <ol class="lds-header-search-results" id="site-search-example-results">
      <li>
        <a href="/resources/planting-guide/">Planting guide</a>
        <p>Species selection, site preparation, and follow-up care.</p>
      </li>
      <li>
        <a href="/events/community-field-day/">Community field day</a>
        <p>Event details, registration, and accessibility notes.</p>
      </li>
    </ol>
  </search>
</header>

Print Guidance

Use contents, section numbers, running headers, page references, and wayfinding strips to orient readers across pages or sites.

  • Format: size the component for the final artefact, viewing distance, paper stock, and reproduction method.
  • Legibility: use Open Sans, strong contrast, and line lengths that suit the medium.
  • Production: preserve margins, trim safety, logo clear space, and enough room for handwriting where required.
  • Translation: when the web component becomes print, replace interaction states with clear instructions, labels, QR codes, or contact details.

States And Variants

Document current, hover, focus, expanded, collapsed, unavailable, and visited states.

VariantUse
DefaultThe standard form used across normal web and print contexts.
EmphasisA higher-weight version for primary messages, urgent information, or first-read actions.
CompactA denser version for tables, sidebars, forms, footers, and constrained print areas.
ExampleA filled version for documentation, templates, learning resources, and production references.

Anatomy

PartGuidance
ContainerUse only when grouping helps. Prefer quiet rules and spacing over heavy boxes.
Title or labelMake the component purpose clear in plain language.
Body contentKeep copy short, scannable, and aligned to the typography hierarchy.
Action or outcomeMake the next step visible, especially in forms, posters, signs, and templates.

Review Checklist

  • Brand: approved colour, typography, logo clear space, and tone.
  • Hierarchy: one clear first read, then supporting information.
  • Grid: major edges align to the page, print, or component grid.
  • Accessibility: contrast, labels, focus, reading order, and colour-independent meaning are covered.
  • Output: the component survives the final medium: mobile, desktop, A4, poster, signage, social, or presentation.