Loading

ROUTE

ルートゼロの
アクティビティ

CSS Anchor Positioningでツールチップを配置する

3

ツールチップや吹き出しを基準ボタンの近くへ置きたいとき、CSS Anchor Positioningを使うと、JavaScriptで座標を測らずに要素同士を関連付けて配置できます。基本は、基準側にanchor-name、配置する側にposition-anchorを指定し、anchor()関数で位置を決める流れです。新しいCSS機能なので、古いブラウザー向けのフォールバックも用意して使いましょう。

CSS Anchor Positioningとは?

CSS Anchor Positioningは、ある要素を「基準となるアンカー」として登録し、別のposition指定要素をその位置や大きさに合わせて配置する仕組みです。ツールチップ、吹き出し、メニュー、ラベルなど、基準要素の近くへ別要素を置きたい場面で役立ちます。

用語解説:アンカー(anchor)
位置決めの基準にする要素です。CSSではanchor-nameで名前を付け、別の要素からposition-anchorやanchor()で参照できます。

役割 主なCSS 何をするか
基準要素 anchor-name アンカーとして名前を付ける
配置要素 position-anchor どのアンカーを基準にするか指定する
座標指定 anchor() アンカーの上・下・中央などを位置の基準にする

最小例:ボタンの下へツールチップを置く

まず、ボタンをアンカーにして、その下へツールチップを配置します。anchor-nameの識別子は–で始まる名前を使います。

<button class="help-button">ヘルプ</button>
<p class="tooltip">ここに説明が表示されます</p>
.help-button {
  anchor-name: --help-anchor;
}

.tooltip {
  position: absolute;
  position-anchor: --help-anchor;
  top: anchor(bottom);
  left: anchor(center);
  transform: translate(-50%, 0.5rem);
}

この例では、ツールチップの上端をボタンの下端に合わせ、横方向はボタンの中央を基準にしています。JavaScriptでgetBoundingClientRect()を呼び、topやleftを計算する処理はありません。


anchor-nameとposition-anchorの関係

anchor-nameは基準要素の名前、position-anchorは配置要素が参照する名前です。同じ名前を使うことで、2つの要素を関連付けます。

.target {
  anchor-name: --profile-card;
}

.menu {
  position: absolute;
  position-anchor: --profile-card;
}
  • anchor-nameは基準要素側へ指定する。
  • position-anchorはposition:absoluteまたはfixedなどで配置する側へ指定する。
  • 同じアンカー名を複数回使う場合は、どの要素が参照されるかソース順やスコープに注意する。

anchor()で上下左右の位置を決める

関連付けだけでは場所は決まりません。top、right、bottom、leftなどのinset系プロパティにanchor()を使い、アンカーのどの位置へ合わせるか指定します。

指定例 意味
top: anchor(bottom) 配置要素の上端をアンカーの下端に合わせる
left: anchor(center) 横方向の基準をアンカー中央にする
right: anchor(left) 配置要素の右端をアンカー左端に合わせる

実際のUIでは余白や中央寄せも必要になるため、marginやtransformなど既存CSSと組み合わせます。複雑な配置ではposition-areaやposition-try系の機能もありますが、まずはanchor-name、position-anchor、anchor()の3点から試すと理解しやすいです。

従来のposition:absoluteとの違い

観点 従来のabsolute配置 Anchor Positioning
基準 近いposition指定祖先など 明示したアンカー要素
位置計算 親要素との関係を設計する アンカーの位置を直接参照する
JavaScript測定 複雑なUIでは必要になることがある 単純な追従なら不要にできる場合がある
古いブラウザー 広く使える 対応状況の確認が必要

Anchor Positioningはposition:absoluteを置き換えるというより、absolute/fixed要素が「どの要素を基準にするか」をCSSでより明示しやすくする機能です。

未対応ブラウザー向けフォールバック

MDNではAnchor Positioningの主要機能がBaseline 2026として案内されていますが、古いブラウザーでは利用できない場合があります。まず従来の配置でも読める状態を作り、対応環境だけ新機能を有効化する方法が安全です。

.tooltip {
  position: absolute;
  top: 100%;
  left: 50%;
  transform: translate(-50%, 0.5rem);
}

@supports (anchor-name: --test) {
  .help-button {
    anchor-name: --help-anchor;
  }

  .tooltip {
    position-anchor: --help-anchor;
    top: anchor(bottom);
    left: anchor(center);
  }
}

フォールバック側では、ツールチップをボタンと同じposition基準のコンテナー内へ置くなど、従来のレイアウト条件を整えておきます。

うまく配置されないときの確認ポイント

  • anchor-nameとposition-anchorの名前が完全に一致しているか。
  • アンカー名が–で始まる識別子になっているか。
  • 配置要素にposition:absoluteまたはfixedなど適切なpositionが指定されているか。
  • anchor()をtop/leftなど適切な位置プロパティへ設定しているか。
  • 同名アンカーが複数あり、意図しない要素を参照していないか。
  • 利用ブラウザーがAnchor Positioningへ対応しているか。

まず最小構成へ戻し、アンカー1個・配置要素1個で動きを確認してから、実際のコンポーネントへ広げると原因を切り分けやすくなります。

よくある質問とまとめ

Anchor Positioningを使えばJavaScriptは不要ですか?

位置を基準要素へ追従させるだけなら不要にできる場面があります。開閉状態、複雑な衝突回避、アクセシビリティ上の振る舞いなどは別途JavaScriptやHTML設計が必要になる場合があります。

anchor-nameだけ指定すれば配置されますか?

いいえ。配置側でposition-anchorなどを使って関連付け、さらにanchor()やposition-areaなどで実際の位置を指定します。

古いブラウザーではどうすればよいですか?

従来のposition:absoluteなどで最低限表示できるフォールバックを先に用意し、@supportsで対応環境だけAnchor Positioningを有効化する方法があります。

最初はボタン1個とツールチップ1個の小さな例を作り、anchor-name → position-anchor → anchor()の順に確認してみてください。

ルートゼロの採用情報を見る

RANKINGranking-icon

すべてを開示している会社です

ポジティブな面もネガティブな面も、包み隠さず誠実にお答えします。
気になることがあれば、面談の際にすべてオープンにお話します。