Skip to content
fandhe-frontend
GitHub

Link Overlay

カード全体をクリック可能にする(カード全面クリック化)ための部品です。fandhe-frontend-headless-uilink_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
  overlay

API Reference

Arguments

NameTypeDefaultDescription
overlay(href)&str遷移先 URL。危険な URL スキームは core の render() が属性ごと拒否する。

Examples

見出しを別描画し overlay へ aria-label のみ与える構成

module doc が推奨する運用(可視見出しは root の子として描画し、overlay へはアクセシブルネームのみを渡す)を実演します。

Getting Started

A short summary of the guide.

Accessibility

WAI-ARIA

AttributeDescription
aria-labeloverlay 自身は aria-label を自動付与しない。単一リンクのみで完結する構成では呼び出し側が attrs 経由でアクセシブルネームを与える運用が推奨される(module doc 参照)。