A bar whose menus open across the page: three columns beside a release card.

Last updated

Open block
Show code
---
/**
 * Three columns with sidebar: A bar whose menus open across the page: three columns beside a release card.
 *
 * @block header-navigation
 * @order 12
 */
import { Book, CircleCheck, CircleDollarSign, CirclePlay, Flag, HeartHandshake, MessageCircle, Orbit, Sparkles, Users } from '@lucide/astro'
import Navbar from '@/components/apogee/Navbar/Navbar.astro'
import NavLink from '@/components/apogee/NavLink/NavLink.astro'
import NavDropdown from '@/components/apogee/NavDropdown/NavDropdown.astro'
import Link from '@/components/apogee/Link/Link.astro'
import Button from '@/components/apogee/Button/Button.astro'
import FeaturedIcon from '@/components/apogee/FeaturedIcon/FeaturedIcon.astro'
import Badge from '@/components/apogee/Badge/Badge.astro'
import Image from '@/components/apogee/Image/Image.astro'
import type { Action, Media } from '@/components/apogee/sections/_shared/spine.ts'
import type { NavGroup, NavigationContent } from '@/components/apogee/sections/_shared/navigation.ts'

// One icon set per column, cycling by position.
const icons = [
  [CircleCheck, HeartHandshake, CircleDollarSign],
  [Book, Sparkles, CirclePlay],
  [Flag, MessageCircle, Users],
]
const groups: NavGroup[] = [
  { heading: 'Use cases', items: [
    { label: 'Convert', href: '#', description: 'Read conversion rates, and raise them.' },
    { label: 'Engage', href: '#', description: 'Measure active use, and find what to improve.' },
    { label: 'Retain', href: '#', description: 'Find what keeps customers with you.' },
  ] },
  { heading: 'Resources', items: [
    { label: 'Blog', href: '#', description: 'The latest industry news and guides, written by our team.' },
    { label: 'Customer stories', href: '#', description: 'How teams use the product to grow faster.' },
    { label: 'Video tutorials', href: '#', description: 'Get up and running on new features with short guides.' },
  ] },
  { heading: 'Company', items: [
    { label: 'About us', href: '#', description: 'Our team and what we are working towards.' },
    { label: 'Press', href: '#', description: 'News, press releases and press resources.' },
    { label: 'Careers', href: '#', description: 'We are always looking for talented people. Join our remote team.', badge: "We're hiring" },
  ] },
]

/** @composable */
interface Props extends NavigationContent {
  /** The bar's fill: the page, a grey band or the brand colour. */
  background?: 'page' | 'neutral-faded' | 'primary' | undefined
  /** `dark` sets the bar in the dark theme on a light page. */
  theme?: 'dark' | undefined
  /** The card beside each menu's columns. @category content */
  card?: { media: Media; heading: string; description?: string; action?: Action } | null
}
const {
  brand = 'Example',
  links = [
    { label: 'Products', groups },
    { label: 'Services', groups },
    { label: 'Pricing', href: '#' },
    { label: 'Resources', groups },
    { label: 'About', href: '#' },
  ],
  primaryAction = { label: 'Sign up', href: '#' },
  secondaryAction = { label: 'Log in', href: '#' },
  card = {
    media: { src: 'https://picsum.photos/seed/apogee-nav-update/560/320', alt: '' },
    heading: "We've just released an update",
    description: 'The new dashboard view is here. Pages now load up to three times faster.',
    action: { label: 'Read the changelog', href: '#' },
  },
  background,
  theme,
} = Astro.props
---

<Navbar background={background} data-theme={theme}>
  <Link slot="brand" href="/" color="inherit" underline="none" class="inline-flex items-center gap-2 text-lg font-semibold"><FeaturedIcon theme="solid" color="primary" size="small"><Orbit /></FeaturedIcon>{brand}</Link>
  {links.map((l) => 'groups' in l ? (
  <NavDropdown label={l.label} fullWidth>
    <div class="mx-auto max-w-7xl px-gutter py-6 md:py-8">
        <div class="grid gap-6 xl:grid-cols-[minmax(0,1fr)_18rem]">
          <div class="grid gap-4 md:grid-cols-3">
            {l.groups.map((g, gi) => {
              const set = icons[gi % icons.length]!
              return (
            <div class="flex flex-col gap-2">
          {g.heading && <p class="px-3 text-sm font-semibold text-primary">{g.heading}</p>}
          <ul class="list-none p-0 flex flex-col gap-0.5">
            {g.items.map((i, n) => {
              const Icon = set[n % set.length]!
              return (
              <li>
                <Link href={i.href} color="inherit" underline="none" class="flex gap-3 rounded-lg p-3 transition-colors hover:bg-neutral-faded">
                  <Icon class="mt-0.5 size-5 shrink-0 text-primary" aria-hidden="true" />
                  <span class="flex flex-col gap-1">
                    <span class="flex flex-wrap items-center gap-2 font-semibold">{i.label}{i.badge && <Badge size="small" color={i.badge === 'New' ? 'neutral' : 'positive'} variant="faded">{i.badge}</Badge>}</span>
                    {i.description && <span class="line-clamp-2 text-sm text-neutral-faded">{i.description}</span>}
                  </span>
                </Link>
              </li>
            )})}
          </ul>
        </div>
            )})}
          </div>
          {card && <div class="flex flex-col gap-4 rounded-xl bg-neutral-faded p-4">
          <Image src={card.media.src} alt={card.media.alt} width={560} height={320} fit="cover" radius="lg" class="h-40 w-full" />
          <div class="flex flex-col gap-1">
            <p class="font-semibold">{card.heading}</p>
            {card.description && <p class="text-sm text-neutral-faded">{card.description}</p>}
          </div>
          {card.action && <Link href={card.action.href} class="text-sm font-semibold">{card.action.label}</Link>}
        </div>}
        </div>
      </div>
  </NavDropdown>
  ) : <NavLink href={l.href}>{l.label}</NavLink>)}
  {secondaryAction && <Button slot="actions" href={secondaryAction.href} variant="outline" color="neutral" size="small">{secondaryAction.label}</Button>}
  {primaryAction && <Button slot="actions" href={primaryAction.href} size="small">{primaryAction.label}</Button>}
</Navbar>

Add

npx @ava-ui/apogee add header-navigation/three-col-with-sidebar

This copies the block to src/components/apogee/blocks/header-navigation/ with everything it uses: Badge, Button, FeaturedIcon, Image, Link, NavDropdown, NavLink, Navbar. Every piece of copy is a prop, with the sample copy as its default. Pass yours, or null to hide a part; see copy is props.

Accessibility

  • Each menu is a button with a native popover: Esc or a click outside closes it and focus returns to the button. On phones the menus are rows that expand inside the menu. No JS is needed for either.
  • Photos that only decorate have an empty alt; give yours one when it carries meaning.