コンテンツにスキップ
開発ガイドライン
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

パスとリンク

ルート相対パスの使用、ページ内リンク、外部リンクの設定ルール

パスの書き方

href や src 属性に記述するパスは、原則 /(スラッシュ)で始まるルート相対パスで記述します。
これは CMS などの動的に生成されるページでも、どの階層からでも同じリンク先を参照できるようにするためです。

ただし、ファイルが設置されるディレクトリ構成やプロジェクトのビルド・デプロイ方式によっては、推奨されるパスの書き方が異なる場合があります。
その場合は、プロジェクトのルールや運用方針に従って記述してください。

<!-- ✅ 良い例 -->
<a href="/path/to/link">...</a>

<!-- ❌ 悪い例 -->
<a href="path/to/link">...</a>
<a href="./path/to/link">...</a>
<a href="../path/to/link">...</a>

ページ内リンク

ページ内リンク(アンカーリンク)を設定する場合は、#id名 を使って対象要素の id 属性と一致させてください。
id 属性はページ内で一意となるように命名します。

id の命名規則

  • 英小文字、数字、ハイフン(-)を使用し、単語はハイフンで区切る(例:section-about)
  • 先頭は英字で始める
  • 意味が分かる名前を付ける
  • ページ内で重複しないようにする
<!-- ✅ 良い例 -->
<a href="#section-about">About セクションへ</a>
...
<section id="section-about">...</section>

<!-- ❌ 悪い例 -->
<a href="#SectionAbout">About セクションへ</a>
...
<section id="SectionAbout">...</section>
<!-- キャメルケースや大文字は避ける -->

<a href="#123about">About セクションへ</a>
...
<section id="123about">...</section>
<!-- 先頭を数字にしない -->

固定ヘッダーがある場合

固定ヘッダーがあると、リンク先の見出しや、Tab キーで移動したフォーカス先の要素がヘッダーの下に隠れます。スクロールコンテナに scroll-padding-top を指定して、ヘッダーの高さ分をずらしてください。

html {
  scroll-padding-top: var(--header-height);
}

scroll-behavior: smooth でスムーズスクロールにする場合は、動きを減らす設定の利用者に配慮して prefers-reduced-motion で切り替えます。

@media (prefers-reduced-motion: no-preference) {
  html {
    scroll-behavior: smooth;
  }
}

別タブで開くリンク

target="_blank" で別タブを開くのは、PDF や外部サービスなど、元のページに戻る必要が高い場合に限ります。利用者の予想に反して別タブが開くと、戻る操作が効かず混乱の原因になるためです。

別タブで開く場合は、アイコンやテキストでそのことを示してください。アイコンだけで示す場合は、代替テキストを付けます。

<a href="https://example.com/" target="_blank">
  外部サイト<img src="/images/icon-external.svg" alt="(新しいタブで開きます)" width="16" height="16" />
</a>

rel 属性

<a>、<area>、<form> 要素に target="_blank" を設定すると、暗黙的に rel="noopener" を指定した場合と同じ動作になるため、rel="noopener" の指定は不要です。

rel="noreferrer" は「遷移先にリファラー情報を渡さない」という明確な目的がある場合にのみ指定してください。

<!-- ✅ 良い例 -->
<a href="https://example.com/" target="_blank">外部サイト</a>

<!-- ❌ 不要な指定 -->
<a href="https://example.com/" target="_blank" rel="noopener">外部サイト</a>

WordPress のエディターなどが自動で付ける rel="noopener" は、削除しなくて構いません。

参考リソース

このページは役に立ちましたか?