CSSのdisplay: contentsで包むdivを外す方法

​​CSS​CSS Grid,Flexbox,HTML,Playwright,アクセシビリティ

フォームのラベルと入力欄を CSS Grid で2列にそろえたいのに、1行ずつ div で包んでいるせいで、並びが崩れることがあります。包んでいる div に display: contents を付けると、その要素の箱だけがなくなり、中の子要素が親のグリッドやフレックスボックスに直接並びます。HTML の構造は変えずに済みます。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。フォントは Noto Sans CJK JP で、要素の位置と大きさは getBoundingClientRect() で測りました。Firefox と Safari での表示や、実際のスクリーンリーダーでの読み上げは試していません。

包んでいる div がグリッドの並びを崩す

次のフォームでは、1行ごとにラベルと入力欄を .row の div で包んでいます。違いが見えるように、.row には点線の枠線、余白、背景、文字の色を付けました。

html
<form class="form">
  <div class="row"><label for="name">お名前</label><input id="name"></div>
  <div class="row"><label for="mail">メール</label><input id="mail"></div>
  <div class="row"><label for="tel">電話番号</label><input id="tel"></div>
</form>
css
.form {
  display: grid;
  grid-template-columns: 120px 200px;
  gap: 8px 16px;
  width: 336px;
}

.row {
  border: 2px dashed #9aa5ab;
  padding: 8px;
  background: #eefafd;
  color: rgb(6, 122, 152);
}

検証環境では、グリッドのセルに入ったのは、ラベルと入力欄ではなく .row でした。1つ目の .row が幅 120px の左の列に、2つ目が幅 200px の右の列に入り、3つ目は次の行の左の列に回りました。ラベルと入力欄は .row の中で縦に積まれ、左の列の入力欄は既定の幅 186px のまま、120px の列からはみ出しました。グリッドに並ぶのは .form の直接の子である .row で、その中の要素ではありません。

包んでいる div に display: contents を付ける

.row に display: contents を足します。

css
.row {
  display: contents;
}

これで、.row の中のラベルと入力欄が、.form の直接の子と同じようにグリッドに並びます。検証環境では、3つのラベルがすべて左の列(幅 120px)に、3つの入力欄がすべて右の列(幅 200px)に入り、1行ごとに 38px(高さ 30px と行の間 8px)下に並びました。

2つの枠を縦に並べた比較。上の「ラッパーの div をそのまま置いた場合」では、点線で囲まれた3つの水色の箱がグリッドのセルに入り、「お名前」と「メール」の箱が横に並び、「電話番号」の箱は次の行に回っている。箱の中ではラベルの下に入力欄があり、左の列の入力欄は箱からはみ出している。下のピンクの枠の「ラッパーの div に display: contents」では、点線の箱がなくなり、左の列にラベル、右の列に入力欄が3行そろって並んでいる
同じ HTML のフォームで、包んでいる div に display: contents を付ける前と後

CSS Display の仕様では、display: contents の要素は自分の箱を作らず、箱を作ってレイアウトするときには、その要素がその中身に置き換わったものとして扱う、とされています。MDN の display のページにも、要素は自身のためのボックスを作らず、疑似ボックスや子ボックスで置き換えられると書かれています。

フレックスボックスでも同じでした。<nav> を display: flex にし、中の <ul> に display: contents を付けると、<li> が <nav> の直接の子のように横に並びました。<ul> が普通のブロックのままだと、3つの <li> は縦に並んだままでした。

なくなるのは箱だけで、要素は残る

display: contents で消えるのは、レイアウト上の箱だけです。要素そのものは DOM に残ります。検証環境で、.row に付けた点線の枠線、padding: 8px、水色の背景は、どれも画面に出なくなりました(上の画像の下側)。.row の getBoundingClientRect() は幅も高さも 0 で、offsetWidth も 0 でした。

一方で、次のものは変わりませんでした。

  • .row > label のようなセレクターは、3つのラベルに当たる
  • .row に付けた文字の色は、中のラベルに継承される
  • 中の input をクリックすると、.row に登録した click のリスナーが呼ばれる

仕様にも、変わるのは箱の構造だけで、セレクターの当たり方、イベントの処理、プロパティの継承のように、文書の木構造をもとにしたものは影響を受けない、と書かれています。そのため、文字の色のような継承されるプロパティは包んでいる要素に書いても効きますが、枠線、背景、余白は、中の要素に付け直す必要があります。

包んでいる要素の直下に文字を直接書くと、その文字はそれだけで1つの項目として並びます。display: flex; gap: 16px の親の中で、display: contents の div に「まんなかの文字」と <span>右</span> を入れると、「まんなかの文字」と「右」の間にも 16px の間隔が空き、別々の項目として並びました。

img や input に付けると、要素ごと表示されなくなる

display: contents は、どの要素にも同じように効くわけではありません。CSS Display の仕様では、置換要素など、表示が CSS だけで決まらない要素では、display: contents は display: none として計算される、と定められています。当たる要素として、仕様の付録 B には img、input、textarea、select、video、iframe などが挙げられています。

このうち img、input、select、textarea に、検証環境で直接 display: contents を付けると、getComputedStyle() で読んだ display は none になり、画面から消えました。

要素 計算された display 表示
img none 消える
input none 消える
select none 消える
textarea none 消える
button contents 自分の箱がなくなり、文字だけが残る
fieldset contents 自分の箱がなくなる

包む要素を外すつもりで、セレクターが入力欄そのものにも当たってしまうと、入力欄が消えます。display: contents は、.row のようにクラスで指定した、包むための要素だけに付けます。

Chromium では、ボタンに付けると Tab キーで移動できなくなる

button は付録 B で特別な扱いがない要素とされ、display: contents を付けると、自分の箱だけがなくなります。検証環境でも、枠線と余白を付けた button に display: contents を付けると、箱の大きさは 0 になり、文字だけが残りました。「送信する」と書いたボタンの文字をクリックすると、ボタンの onclick は実行されました。

ただし、キーボードでは操作できなくなりました。ボタンの前の入力欄から Tab キーを押すと、ボタンを飛ばして、後ろの入力欄にフォーカスが移りました。tabIndex は 0 のままでしたが、JavaScript でボタンの focus() を呼んでも、フォーカスは移りませんでした。

アクセシビリティツリーには、ボタンは残っていました。Playwright の ariaSnapshot() では button "送信する" と出て、getByRole('button', { name: '送信する' }) でも見つかりました。<ul> に display: contents を付けたときも、list と3つの listitem が残りました。

注意

フォーカスできないボタンは、キーボードからは押せません。button のような、キーボードで操作する要素そのものには display: contents を付けず、包むための div や span だけに付けます。

MDN の display のページには、display: contents の要素をアクセシビリティツリーから取り除いてしまうブラウザーがあり、そうなると、その要素自身はスクリーンリーダーで読み上げられなくなる、と書かれています。仕様でも、執筆時点では主要なブラウザーで正しく実装されていないため、アクセシビリティツールが要素の意味を読み取れなくなることがあり、注意して使うように、と書かれています。検証環境の Chromium 153 では、ボタンもリストもアクセシビリティツリーに残りましたが、<ul> のように意味を持つ要素に付けるときは、使うブラウザーとスクリーンリーダーで確かめてからにします。

​Posted by 86