パスとリンク
ルート相対パスの使用、ページ内リンク、外部リンクの設定ルール
パスの書き方
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" は、削除しなくて構いません。