Skip to content
fandhe-frontend
GitHub

Nav List

見出し + リンクリストのみで構成する文書ナビ向けの静的なリンク集です。fandhe-frontend-headless-uinav_list mod が構造・アクセシビリティ(WAI-ARIA・キーボード操作)・表示状態(data-*)のみを提供する unstyled 部品であり、Themes 版と異なりスタイル(CSS)は一切持ちません。menu ロールへの誤読を避けるため role 属性を一切付与せず、素の nav/ul/li/a の暗黙 ARIA ロールに依拠します。

スタイル済みの表示例は Nav List を参照してください。

関連 API: fandhe-frontend-headless-ui API

Demo

枠線・余白は docs サイト側のデモ枠であり、fandhe-frontend-headless-ui 自体はスタイルを持ちません。

Features

  • 文書ナビ向け Link リスト。root(nav)/ heading(h2)/ list(ul)/ item(li)/ link(a)の 5 anatomy パーツを持つ(nav_list.rs モジュール doc)。
  • 5 パーツいずれも role 属性を一切付与しない。素の nav/h2/ul/li/a の暗黙 ARIA ロールをそのまま使うことが、menu ロールへの誤読を避ける本部品の存在理由そのものである(module doc「role を一切付与しない」節)。
  • root の aria-label(label 引数)は必須引数であり、複数 nav ランドマークが存在する文書でスクリーンリーダー利用者がランドマーク間を区別できるようにする。
  • navigation_menu との使い分けの軸は role の有無ではなくディスクロージャの有無(本部品は状態機械を持たない静的なリンク集、navigation_menu は Trigger/Content で開閉するパネル)。

Anatomy

root
  heading
  list
    item
      link

API Reference

Arguments

NameTypeDefaultDescription
root(label)&strroot(nav)へ付与する aria-label(必須引数)。
link(current)booltrue のとき aria-current="page"+data-current を付与する(role は付与しない)。

Data Attributes

PartAttributeObserved Values
linkdata-current

Examples

heading を省いたフラットなリンクリスト

heading パーツを使わず、見出しなしのリンクリストのみで構成した例です。

Accessibility

WAI-ARIA

AttributeDescription
aria-labelroot(nav)に必須付与。role は一切付与しない(module doc「role を一切付与しない」節)。
aria-current="page"link に付与(current が true のときのみ)。role は付与しない。