できない.dev

CSSで見た目は隠して読み上げには残すには

アイコンだけのボタンなどで、文字を画面からは見えなくしつつスクリーンリーダーには読み上げさせるための .visually-hidden クラスの定番の書き方を示す。

公開:

プレビュー
<button class="icon-btn" type="button"><span aria-hidden="true">🔍</span><span class="visually-hidden">検索する</span></button>
.icon-btn {
  padding: 6px 10px;
  border: 1px solid #94a3b8;
  border-radius: 6px;
  background: #fff;
  font: 14px/1.7 system-ui;
}
 
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

文字を 1px の箱に押し込み、overflow: hidden と clip-path で切り取ると、画面には何も出ないがアクセシビリティツリーには文字が残る。
アイコンだけのボタンのように、見た目には要らないが読み上げには必要な説明を足すために使う。

display: none では読み上げからも消える

見えなくしたいだけなら display: none で足りそうに見えるが、読み上げに残したい文字には使えない。

  • display: none は要素と子孫をアクセシビリティツリーから外すため、スクリーンリーダーは読み上げない
  • visibility: hidden も同様に読み上げから外れ、フォーカスも受けられない

読み上げに残したい文字は、表示を消さずに見える範囲だけを潰す書き方で隠す。

width: 0 と height: 0 だけでははみ出して見える

箱を width: 0; height: 0 にしても、中の文字ははみ出して描画される。
overflow: hidden で切り取り、white-space: nowrap で折り返しを止めて、はみ出した文字が画面に出ないようにする。

position: absolute を付けるのは、1px の箱でも周りのレイアウトを動かさないためである。

できない例: width と height を 0 にするだけ
.wrap {
  position: relative;
  padding: 10px 14px;
  background: #f1f5f9;
  font: 14px/1.7 system-ui;
}
.icon-btn {
  padding: 6px 10px;
  border: 1px solid #94a3b8;
  border-radius: 6px;
  background: #fff;
}
.label {
  width: 0;
  height: 0;
}
できる例: .visually-hidden を当てる
.wrap {
  position: relative;
  padding: 10px 14px;
  background: #f1f5f9;
  font: 14px/1.7 system-ui;
}
.icon-btn {
  padding: 6px 10px;
  border: 1px solid #94a3b8;
  border-radius: 6px;
  background: #fff;
}
.label {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

使いすぎない

W3C の技術文書(C7)は、この手法が向くのは「詳細」「PDF」のようにリンク文言だけでは意味が伝わらない場面だと述べる。
同じ文言を何度も隠して置くと、読み上げが冗長になって利用者が詳細度を調べにくくなるという指摘もある。

画面に見える文字で足りるなら、隠さずに見せる方を選ぶ。