2025年04月12日 22:59

h1要素のブラウザーのデフォルトのスタイルが変更へ

ブラウザーは、ネストされたセクション見出しに対するデフォルトのUAスタイルの変更を展開し始めています。開発者は、予期しない結果やLighthouseチェックの失敗を避けるために、特定のケースでUAスタイルに依存していないことを確認する必要があります。この記事では、今後の変更内容、それがページにとって問題かどうかを識別する方法、そして適合したよりよい構造のWebサイトにするためのヒントを紹介します。

変更点

HTML仕様はかつて、<h1>要素に対して、それがどれだけ多くのセクショニング要素（<section>、<aside>、<nav>、<article>）にネストされているかにもとづいて、暗黙的な意味的見出しレベルを与えるアウトラインアルゴリズムを定義していました。

ブラウザーのレンダリングは、section > h1が<h2>と同じフォントサイズとマージンをもっていました。また、section > section > h1は <h3>というように表現されました。デフォルトのレンダリングは、ブラウザーのUAスタイルに実装されていましたが、（スクリーンリーダーが使用する）アクセシビリティツリーにおける見出しレベルには影響しませんでした。Webサイトはセクショニング要素を使い始めましたが、アウトラインアルゴリズムによる自動的な見出しレベルの変化は想定していませんでした。

一般的に、これは開発者がどこで<h1>要素を使えるかについて混乱を生じさせ、ツールはHTMLを異なる方法で処理したため、アウトラインアルゴリズムは問題のあるものとみなされました。アウトラインアルゴリズムは2022年にHTML仕様から削除されましたが、UAスタイルシートのルールは依然として残っています。デフォルトスタイル内のこれらのルールが現在、ブラウザーベンダーによって削除され始めています。

1
/* xは:is(article, aside, nav, section) */
2
x h1 { margin-block: 0.83em; font-size: 1.50em; }
3
x x h1 { margin-block: 1.00em; font-size: 1.17em; }
4
x x x h1 { margin-block: 1.33em; font-size: 1.00em; }
5
x x x x h1 { margin-block: 1.67em; font-size: 0.83em; }
6
x x x x x h1 { margin-block: 2.33em; font-size: 0.67em; }

たとえば、このようなコードがあった場合、

1
<body>
2
  <h1>Level 1</h1>
3
  <section>
4
    <h1>Level 2</h1>
5
    <section>
6
      <h1>Level 3</h1>
7
      <section>
8
        <h1>Level 4</h1>
9
      </section>
10
    </section>
11
  </section>
12
</body>

古いUAスタイルでは次のように表示されます。

新しいUAスタイルではこのような見た目になります。

あなたのブラウザーのデフォルトのスタイルが適用された前述のHTMLの例を次に示します。

Level 1

Level 2

Level 3

Level 4

予想されることとその時期

ブラウザースタイルの変更と並行して、Lighthouseのようなページ監査ツールは、font-sizeが定義されていない<h1>をバッドプラクティスとしてフラグ付けするようになっています。予想されるおもなポイントを次に示します。

<h1>は、<section>、<article>、<nav>、<aside>などの周囲のセクショニング要素にもとづいてスタイルを適用しなくなります。UAスタイルシートは<h1>に対して、<h2>、<h3>などに一致するような暗黙的なスタイルではなく、まったく同一のスタイルを適用するようになります
font-sizeを指定せずに<h1>が使われている場合、Lighthouseは警告を表示します。注目すべきLighthouseの非推奨警告は H1UserAgentFontSizeInSectionです。対応方法については次のセクションで説明します

これらの変更は、次のタイムラインで各ブラウザーに展開されます。

Firefox

2025年3月31日より、Firefoxはデスクトップ版でarticle、aside、nav、sectionにおけるh1のUAスタイルを削除する変更を、Beta 138ユーザーの50%に展開しています。安定版のFirefox 138では5%のユーザーに展開し、50%まで増加させた後、Firefox 140ですべてのプラットフォームに展開する計画です。bug 1885509参照
Firefox 136以降、開発者はarticle、aside、nav、section内で、作者が定義したfont-sizeやマージンがないh1に対してコンソール警告を確認できます。bug 1937568参照
Firefoxで新しい動作をテストするには、about:configでlayout.css.h1-in-section-ua-styles.enabledをfalse に設定してください

Chrome

バージョン136以降、Chromeは4つの要素内の<h1>に対して、デフォルトの小さいフォントサイズを使用している場合に非推奨警告を表示します。Chromiumで非推奨とマークされると、Lighthouseの「ベストプラクティス」スコアが低下します。issue 394111284参照

Safari

Safariにはこれらの変更を追跡するバグはまだありませんが、WebKitが同様のアップデートに追従することが期待されています

Lighthouseの警告を修正する方法

Lighthouseは最近、<h1>要素にfont-sizeが指定されていないサイトに対して、ChromiumのDevTools警告にもとづいたチェックを継承しました。新しいルールはH1UserAgentFontSizeInSectionと呼ばれ、非推奨警告の追加にともなって3月から表示されるようになっています。<h1>警告が表示された場合は、<h1>に明示的にフォントサイズとマージンを適用していることを確認してください。推奨されるスタイルは次のとおりです。

1
h1 {
2
  margin-block: 0.67em;
3
  font-size: 2em;
4
}

<h1>を対象とするほかのスタイルルールを上書きしないようにするには、詳細度がゼロの:where()を使用できます。

1
:where(h1) {
2
  margin-block: 0.67em;
3
  font-size: 2em;
4
}

見出し要素のMDNページには現在、上記のメモが記載されており、開発者がこの情報を確認できるようになっています（訳注：記事公開時点で日本語版のMDNにはまだ反映されていない）。

まとめ

覚えておくべきポイントは次のとおりです。

デフォルトのブラウザースタイルに依存して見出し階層を伝えないでください。2番目のレベルの見出しには<h2>、3番目には<h3>を使用することで、文書の階層を明示的に定義してください
<h1>要素には常に独自のfont-sizeとmarginを定義してください
今回の変更を考慮してCSSリセットの更新を検討してください
LighthouseやブラウザーのDevToolsを使用してサイトを監査し、非推奨の使用法がないか確認してください
MDNのHTMLセクション見出しに関するメモを確認してください

“Default styles for h1 elements are changing | MDN Blog” by Simon Pieters, licensed under CC-BY-SA 2.5 / translated into Japanese by ろぼいん

#CSS #Web開発 #プログラミング #解説

ろぼいん

Twitter Misskey GitHub Qiita

生まれた時から、母国語よりも先にJavaScriptを使っていました。ネットの海のどこにもいなくてどこにでもいます。

Webフロントエンドプログラマーで、テクノロジーに関する話題を追いかけています。動画編集やプログラミングが趣味で、たまにデザインなどもやっています。主にTypeScriptを使用したWebフロントエンド開発を専門とし、便利で実用的なブラウザー拡張機能を作成しています。また、個人ブログを通じて、IT関連のニュースやハウツー、技術的なプログラミング情報を発信しています。