Skip to content

SiteHeader ​

すべてのページの上に置くヘッダーです。左にロゴ、右に主要ナビ・テーマ切替・「参加する」を並べます。

使い方 ​

tsx
import { SiteHeader } from '@under18dev/ui'

<SiteHeader
  currentPath={pathname}
  items={[
    { href: '/about/', label: '団体について' },
    { href: '/events/', label: 'イベント' },
    { href: '/support/', label: '支援する' },
  ]}
  cta={{ href: '/join/', label: '参加する' }}
/>

実際のサイトでは同じサイトの中のパスを渡します。このページのデモはドキュメントの外へ移動しないよう、https://under18.dev/... を渡しているため新しいタブで開きます。

例 ​

現在のページ ​

currentPath に今のページのパスを渡すと、一致する項目に aria-current="page" を付け、下線を引きます。/events/ を渡した場合は /events/kobe-univ/ のような下の階層でも「イベント」に印が付きます。/ だけは完全に一致したときに限ります。

項目を減らす ​

cta を省くと「参加する」のボタンを出しません。themeControl={false} でテーマ切替も消せます。ナビは design.md §2.3 に沿って4項目程度までにします。

スマホのメニュー ​

画面の幅が 1024px 未満になると、ナビと cta を隠して「メニュー」ボタンを出します。押すとヘッダーの下を覆うメニューを開き、cta もその最後に並びます。開いている間は次のように動きます。

  • 背景のページはスクロールしません。
  • フォーカスは「閉じる」ボタンとメニューのリンクの間だけを回ります。
  • Escape で閉じ、フォーカスをボタンに戻します。リンクを押したときも閉じます。
  • 幅が 1024px 以上に広がると自動で閉じます。

このページのプレビューは、ブラウザの幅を 1024px 未満にするとメニューの表示になります。

Props ​

Prop型既定値説明
itemsNavItem[]—主要ナビ。NavItem は { href, label }
ctaNavItem—右端に置く導線(「参加する」など)
currentPathstring—現在のページのパス。aria-current を付けるのに使う
themeControlbooleantrueテーマ切替を出す
logoReactNode'Under18 Developers'ロゴ。文字列なら団体名として描く
logoLabelstring'Under18 Developers トップページ'ロゴのリンクの読み上げ名
homeHrefstring'/'ロゴのリンク先

アクセシビリティ ​

  • 横並びのナビには「メイン」、スマホのメニューには「メニュー」というラベルを付けた <nav> を使います。
  • 「メニュー」ボタンは aria-expanded と aria-controls で開閉の状態とメニューを結びます。ボタンの文字も「メニュー」と「閉じる」で切り替わります。
  • ヘッダーの前に SkipLink を置きます(design.md §7.1)。
  • 上に固定し、スクロールすると背景と 1px の区切り線が付きます。プレビューの中では固定しません。

design.md(U18-DESIGN-001)と DECISION-001〜008 に沿って作っています。