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

セマンティクス

言語指定、ランドマーク、ボタンとリンク、フォーム、改行のマークアップルール

内容の意味に合った要素と属性を使うと、スクリーンリーダーなどの支援技術が構造や役割を正しく伝えられます。div や span に ARIA 属性を足して代用する前に、同じ役割を持つ HTML 要素がないかを確認してください。

言語指定

html 要素に lang 属性を指定します。スクリーンリーダーの読み上げ言語や、ブラウザの翻訳機能の判定に使われます。

<html lang="ja">

ページ内に別の言語のまとまった文章がある場合は、その要素にも lang 属性を指定します。

<p lang="en">This page is also available in English.</p>

ランドマーク

ページの大きな区画は、次の要素でマークアップします。支援技術の利用者は、ランドマーク単位でページ内を移動できます。

要素 用途
header サイト共通のヘッダー
nav グローバルナビゲーション、パンくずリストなどの主要なナビゲーション
main ページ固有の主要コンテンツ(1 ページに 1 つ)
aside 本文と関連の薄い補足(サイドバーなど)
footer サイト共通のフッター

同じ種類のランドマーク(nav や aside など)を複数置く場合は、aria-label か aria-labelledby でそれぞれに異なる名前を付けます。ロール名は支援技術が読み上げるので、名前に「ナビゲーション」などは含めません。

<nav aria-label="グローバル">...</nav>
<nav aria-label="パンくず">...</nav>

ボタンとリンク

  • ページや場所を移動する: a 要素(href 属性あり)
  • その場で処理を実行する(開閉、送信、切り替えなど): button 要素

div や span にクリックイベントを付けてボタンの代わりにしないでください。キーボード操作やフォーカス、役割の読み上げを自前で実装することになります。

<!-- ✅ 良い例 -->
<a href="/contact/">お問い合わせ</a>
<button type="button" aria-expanded="false" aria-controls="menu">メニュー</button>

<!-- ❌ 悪い例 -->
<a href="#" onclick="openMenu()">メニュー</a>
<div class="button" onclick="openMenu()">メニュー</div>

フォーム

  • 入力欄には label 要素でラベルを関連付けます。プレースホルダーはラベルの代わりにしません。
  • ラジオボタンやチェックボックスのグループは、fieldset と legend でまとめます。
  • 必須項目には required 属性を指定し、画面上でも「必須」と分かるように表示します。
  • 氏名・メールアドレス・電話番号・住所などには、type 属性と autocomplete 属性を指定し、入力の手間を減らします。
  • エラーメッセージや補足説明は、aria-describedby で入力欄と関連付けます。
<label for="email">メールアドレス(必須)</label>
<input
  id="email"
  type="email"
  name="email"
  autocomplete="email"
  required
  aria-describedby="email-error"
/>
<p id="email-error">メールアドレスの形式で入力してください。</p>

<fieldset>
  <legend>お問い合わせの種類</legend>
  <label><input type="radio" name="type" value="estimate" /> 見積もり</label>
  <label><input type="radio" name="type" value="other" /> その他</label>
</fieldset>

改行

br 要素は、詩や歌詞、住所のように、改行そのものが内容の一部である場合に限って使います。見た目を整えるための改行や、段落の間の余白には使いません。

br は「ここで改行する」という内容上の意味を持つ要素です。見た目の調整に使うと、文章の途中に意味のない区切りが入ります。また、利用者が文字サイズを大きくしたり、画面幅が変わったりすると、固定した改行位置が意図しないところで行を途切れさせ、読みにくくなります。

改行位置を調整したい場合は、区切りたいまとまりを span 要素で囲み、CSS の display プロパティで改行のしかたを決めます。

  • inline-block: 画面幅が足りないときだけ、まとまりの切れ目で改行する
  • block: 常にまとまりごとに改行する
  • flex: 親要素に指定し、まとまりを並べる向きや折り返しを画面幅に応じて切り替える
<!-- ✅ 良い例 -->
<p><span>こんにちは。</span><span>さようなら。</span></p>

<!-- ❌ 悪い例:見た目の調整に br を使う -->
<p>こんにちは。<br class="sp-break" />さようなら。</p>

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