Link Overlay
カード全体をクリック可能にする(カード全面クリック化)ための部品です。fandhe-frontend-headless-ui の link_overlay mod が構造・アクセシビリティ(WAI-ARIA・キーボード操作)・表示状態(data-*)のみを提供する unstyled 部品であり、Themes 版と異なりスタイル(CSS)は一切持ちません。overlay パーツを root 全面へ展開するのは呼び出し側の CSS(position: absolute; inset: 0;)の責務です。
スタイル済みの表示例は Link Overlay を参照してください。
関連 API: fandhe-frontend-headless-ui API
Demo
枠線・余白は docs サイト側のデモ枠であり、fandhe-frontend-headless-ui 自体はスタイルを持ちません。
Card body contentRead article
Features
- カード全面クリック化。root(div、位置決めコンテキスト)/ overlay(a、カード全面へ拡張されるリンク)の 2 パーツ構成(chakra-ui LinkBox/LinkOverlay パターン相当、link_overlay.rs モジュール doc)。
- ::before 疑似要素を使わず、overlay 自身を position: absolute; inset: 0; で root 全面へ展開する方式を採る(styled 層の CSS 責務、headless 層は CSS を持たない)。
- overlay がフローから外れるため、root の高さは overlay 以外の子ノード(見出し・説明文等の通常フロー要素)が確立する契約である(module doc「全面拡張の実装方針」)。
- 単一リンクのみの overlay へ可視テキストを渡す代わりに、見出しを root の他の子ノードとして描画し overlay へは aria-label 等でアクセシブルネームのみを与える運用が推奨される。
Anatomy
root
overlayAPI Reference
Arguments
| Name | Type | Default | Description |
|---|---|---|---|
| overlay(href) | &str | 遷移先 URL。危険な URL スキームは core の render() が属性ごと拒否する。 |
Examples
見出しを別描画し overlay へ aria-label のみ与える構成
module doc が推奨する運用(可視見出しは root の子として描画し、overlay へはアクセシブルネームのみを渡す)を実演します。
Accessibility
WAI-ARIA
| Attribute | Description |
|---|---|
| aria-label | overlay 自身は aria-label を自動付与しない。単一リンクのみで完結する構成では呼び出し側が attrs 経由でアクセシブルネームを与える運用が推奨される(module doc 参照)。 |