セマンティクス
言語指定、ランドマーク、ボタンとリンク、フォーム、改行のマークアップルール
内容の意味に合った要素と属性を使うと、スクリーンリーダーなどの支援技術が構造や役割を正しく伝えられます。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>