v0.9.4defuss-shadcn
Theme

defuss-shadcn / Website / Landing Page / site-header

Built with: CSS

Site HeaderBLK

A marketing page header: brand, container-aware dropdown nav, and actions. The nav collapses below 30rem container width - pure CSS, popovers native.

On this page (8)
Component Skill — components/site-header/component-skill.md

Native basis

<header> landmark with <nav>; no script. The nav collapses via a container query (@container), so the block adapts to the width it is placed in, not the viewport. Dropdowns compose the Navigation Menu component: trigger buttons wired with popovertarget and popover panels - the Popover API handles open/close, Escape, and light dismiss natively.

Web Platform APIs

<header><nav>position: stickyContainer queriespopovertarget` / `popoverCSS anchor positioning:focus-visible

Classes

.mk-header.mk-header-inner.mk-header-brand.mk-header-name.mk-header-nav.mk-header-actions

Variants

data-variantPurposestickyHeader sticks to the top on scroll (opt-in)

§Default

Composes navigation-menu: triggers + popovertarget, no JS.

§Sticky

data-variant='sticky' pins the header while the box below it scrolls.

§Floating

data-variant='floating': a blurred, rounded pill that floats over the page and stays on top while it scrolls - scroll the box.

§Announcement bar

.mk-header-announcement: a primary-colored bar above the header row - one line and a link.

§Over an image

data-variant='overlay': transparent and white over a hero picture - the wrapper is positioned, the header sits absolutely on top of it.

§Store

data-variant='centered': the brand in the middle, the nav left, the actions right - with an inline search (.mk-header-search, from 48rem) and a cart with a count (.mk-header-count).

§Elevate on scroll

data-elevate on a sticky header: flat at the top, a rule and a shadow appear within the first 64px of scrolling - a scroll-driven animation, no script.

§CSS view file

/* -- Site Header (marketing) -------------------------------------
   Fixed-height product header: brand left, nav center, actions right.
   The doc site's own chrome uses .site-header/<site-header>; marketing
   pages use .mk-header so the two never collide. */
@layer components {
  .mk-header {
    /* container query, not @media: the header adapts to the width it is
       placed in (doc preview box, sidebar layout, full page) */
    container: mk-header / inline-size;
    position: relative;
    width: 100%;
    background: var(--background);
    color: var(--foreground);
    &[data-variant="sticky"] {
      position: sticky;
      top: 0;
      z-index: 50;
    }
  }
  .mk-header-inner {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    min-height: 3.5rem;
    max-width: 80rem;
    margin-inline: auto;
    padding: 0.5rem 1.25rem;
  }
  .mk-header-brand {
    display: flex;
    align-items: center;
    gap: 0.25rem;
    flex-shrink: 0;
    /* the glyph follows the name - never the browser's link blue */
    color: var(--primary);
    text-decoration: none;
    & svg { width: 1.25rem; height: 1.25rem; flex-shrink: 0; }
  }
  .mk-header-name {
    color: var(--primary);
    font-size: 0.875rem;
    font-weight: 500;
    white-space: nowrap;
  }
  /* nav collapses below the container breakpoint (source: `hidden md:flex`).
     The nav composes the navigation-menu component (.nav-menu-list /
     .nav-menu-trigger / .nav-menu-content) - its dropdown popovers are the
     native Popover API, so the header stays CSS-only. */
  .mk-header-nav { display: none; align-items: center; }
  .mk-header-actions { display: flex; align-items: center; gap: 0.5rem; flex-shrink: 0; }
  /* narrow: the nav moves into a Sheet behind a menu button; secondary
     actions (.mk-header-wide) step aside */
  .mk-header-menu { display: inline-flex; }
  .mk-header-actions .mk-header-wide { display: none; }
  /* the navigation inside the sheet: big tap targets, groups with a label */
  .mk-header-sheet-nav {
    display: flex;
    flex-direction: column;
    gap: 0.125rem;
    margin: 0;
    padding: 0;
    list-style: none;
    & a {
      display: flex;
      align-items: center;
      justify-content: space-between;
      gap: 0.75rem;
      min-height: 2.75rem;
      padding: 0.5rem 0.75rem;
      border-radius: var(--radius-md);
      color: var(--foreground);
      font-size: 1rem;
      font-weight: 500;
      text-decoration: none;
      &:hover { background: var(--accent); color: var(--accent-foreground); }
      &[aria-current] { background: var(--accent); }
      &:focus-visible { outline: 2px solid var(--ring); outline-offset: -2px; }
      & small { color: var(--muted-foreground); font-size: 0.8125rem; font-weight: 400; }
    }
  }
  .mk-header-sheet-label {
    margin: 0.75rem 0 0.25rem;
    padding-inline: 0.75rem;
    color: var(--muted-foreground);
    font-size: 0.75rem;
    font-weight: 600;
    letter-spacing: 0.06em;
    text-transform: uppercase;
  }
  .mk-header-sheet-actions { display: grid; gap: 0.5rem; }
  .mk-header-sheet-actions .btn { width: 100%; }
  @container mk-header (min-width: 40rem) {
    .mk-header-inner { padding-inline: 2rem; }
    .mk-header-nav { display: flex; }
    .mk-header-menu { display: none; }
    .mk-header-actions .mk-header-wide { display: inline-flex; }
  }
  /* -- variants ------------------------------------------------- */
  /* floating: a blurred pill that hovers over the page (sticky) */
  .mk-header[data-variant="floating"] {
    position: sticky;
    top: 0;
    z-index: 50;
    padding: 0.75rem;
    background: transparent;
    & .mk-header-inner {
      max-width: 64rem;
      min-height: 3.25rem;
      padding: 0.375rem 0.5rem 0.375rem 1rem;
      border: 1px solid color-mix(in oklch, var(--border) 80%, transparent);
      border-radius: 999px;
      background: color-mix(in oklch, var(--background) 78%, transparent);
      box-shadow: var(--shadow-lg);
      backdrop-filter: blur(12px) saturate(1.4);
    }
    & .btn { border-radius: 999px; }
  }
  /* an announcement bar above the header row */
  .mk-header-announcement {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: center;
    gap: 0.25rem 0.75rem;
    padding: 0.5rem 1rem;
    background: var(--primary);
    color: var(--primary-foreground);
    font-size: 0.8125rem;
    text-align: center;
    & p { margin: 0; }
    & a { display: inline-flex; align-items: center; gap: 0.25rem; color: inherit; font-weight: 600; text-underline-offset: 3px; }
    & svg { width: 0.875rem; height: 0.875rem; }
    & a:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; border-radius: var(--radius-sm); }
  }
  /* overlay: transparent over a hero picture, white text */
  .mk-header[data-variant="overlay"] {
    position: absolute;
    inset: 0 0 auto;
    z-index: 5;
    background: transparent;
    color: #fff;
    & .mk-header-brand,
    & .mk-header-name,
    & .nav-menu-link,
    & .btn[data-variant="ghost"] { color: inherit; }
    & .nav-menu-link:hover { background: oklch(1 0 0 / 0.12); color: inherit; }
    & .nav-menu-link[aria-current] { background: oklch(1 0 0 / 0.16); }
  }
  /* centered: the brand in the middle, the nav left, the actions right */
  .mk-header[data-variant="centered"] .mk-header-inner {
    display: grid;
    /* minmax(0, …): a wide actions column must not push the brand off-center */
    grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
    & .mk-header-brand { grid-column: 2; grid-row: 1; }
    & .mk-header-nav { grid-column: 1; grid-row: 1; justify-self: start; }
    & .mk-header-actions { grid-column: 3; grid-row: 1; justify-self: end; }
    & .mk-header-name { font-size: 1rem; font-weight: 600; letter-spacing: -0.01em; }
  }
  /* search: an inline search field (wide only - the sheet carries it when narrow) */
  .mk-header-search {
    position: relative;
    display: none;
    width: 100%;
    max-width: 20rem;
    & svg { position: absolute; inset-inline-start: 0.75rem; top: 50%; translate: 0 -50%; width: 1rem; height: 1rem; color: var(--muted-foreground); pointer-events: none; }
    & .input { padding-inline-start: 2.25rem; }
  }
  /* an icon button with a count (cart, inbox) */
  .mk-header-icon { position: relative; }
  .mk-header-count {
    position: absolute;
    top: -0.125rem;
    inset-inline-end: -0.125rem;
    min-width: 1.125rem;
    height: 1.125rem;
    padding-inline: 0.25rem;
    border: 2px solid var(--background);
    border-radius: 999px;
    background: var(--primary);
    color: var(--primary-foreground);
    font-size: 0.625rem;
    font-weight: 700;
    line-height: 0.875rem;
    text-align: center;
    box-sizing: border-box;
  }
  /* elevate: a sticky header gains a rule and a shadow once the page scrolls */
  @keyframes mk-header-elevate {
    to { border-block-end-color: var(--border); box-shadow: var(--shadow-md); }
  }
  .mk-header[data-elevate] {
    border-block-end: 1px solid transparent;
    animation: mk-header-elevate linear both;
  }
  @supports (animation-timeline: scroll()) {
    .mk-header[data-elevate] { animation-timeline: scroll(nearest block); animation-range: 0 64px; }
  }
  @supports not (animation-timeline: scroll()) {
    .mk-header[data-elevate] { animation: none; border-block-end-color: var(--border); }
  }
  @container mk-header (min-width: 48rem) {
    .mk-header-search { display: block; }
  }
  /* -- Accessibility ------------------------------------------- */
  @media (prefers-reduced-motion: reduce) {
    .mk-header[data-elevate] { animation: none; border-block-end-color: var(--border); }
  }
  @media (forced-colors: active) {
    .mk-header[data-variant="floating"] .mk-header-inner { border-color: CanvasText; }
    .mk-header-count { border-color: Canvas; }
  }
  @media (prefers-reduced-motion: reduce) {
    /* navigation-menu suppresses its own transitions; nothing header-side
       animates, so no overrides needed here */
  }
  @media (forced-colors: active) {
    .mk-header { border-bottom: 1px solid CanvasText; }
  }
}

Comments, ideas or improvements? Edit this page's source on GitHub