Nav List
見出し + リンクリストのみで構成する文書ナビ向けの静的なリンク集です。fandhe-frontend-headless-ui の nav_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
linkAPI Reference
Arguments
| Name | Type | Default | Description |
|---|---|---|---|
| root(label) | &str | root(nav)へ付与する aria-label(必須引数)。 | |
| link(current) | bool | true のとき aria-current="page"+data-current を付与する(role は付与しない)。 |
Data Attributes
| Part | Attribute | Observed Values |
|---|---|---|
| link | data-current |
Examples
heading を省いたフラットなリンクリスト
heading パーツを使わず、見出しなしのリンクリストのみで構成した例です。
Accessibility
WAI-ARIA
| Attribute | Description |
|---|---|
| aria-label | root(nav)に必須付与。role は一切付与しない(module doc「role を一切付与しない」節)。 |
| aria-current="page" | link に付与(current が true のときのみ)。role は付与しない。 |