自社サイトのよくある質問を、クリックで開け閉めできる形にしたい。制作会社に相談すると「detailsタグで作れます」と言われたが、JavaScriptなしで本当に動くのか、検索やAI検索に読まれるのかが分からない。
そういう場面にいる経営者やWeb担当者に向けて、この記事を書いています。結論から言います。
details 要素は、利用者が開け閉めできる追加情報の箱です。箱の見出しは、最初の子に置く summary 要素が担います。
最初から開いておきたいときは open 属性を付けます。同じ name 属性の値を付けた details 同士は、1つだけが開きます。
開閉そのものには、CSSもJavaScriptも要りません。ブラウザが動きを持っているからです。
答えの要点は、summary と、開かなくても見える場所に書きます。補足だけを、閉じた中に入れます。
Googleの文書は、アコーディオンのような開閉の仕組みを、隠しテキストの違反にはならないと書いています。ただし、検索結果からページ内の節へ直接飛べる深いリンクが出る条件には、展開できる区画の背後に隠さないこと、と書いています。
検索結果やAI検索への効果は、公式に記載が見つかりませんでした。OpenAIとAnthropicの文書にも、記載が見つかりませんでした。
この記事の軸は、details は利用者が開け閉めできる追加情報の箱、ということです。要点は見える場所に置き、補足だけを閉じた中に入れます。
先に答え:details要素について、確かめられたこと
先に、この記事の結論を表にまとめます。右端の列は、答えの根拠にした資料です。
| 疑問 | 答え | 根拠にした資料 |
|---|---|---|
| details要素は何を表すか | 利用者が開け閉めして、追加の情報や操作部品を取り出せる開閉部品 | HTMLの仕様(WHATWG)のdetails要素の章 |
| summary要素は必須か | 仕様は、無ければブラウザが見出しを用意するとしている。検査サービスは、無いとエラーにした | HTMLの仕様と、検査サービスでの実測 |
| 最初から開く書き方 | open属性を付ける | HTMLの仕様 |
| 1つだけ開く書き方 | 同じname属性の値を付ける | HTMLの仕様と、ブラウザでの実測 |
| CSSやJavaScriptは要るか | 開閉そのものには要らない | HTMLの仕様 |
| 閉じた中身は、ページ内検索で見つかるか | 見つかる、と仕様が定めている | HTMLの仕様 |
| Googleは、閉じた中身を隠しテキストと扱うか | 扱わない。アコーディオンは違反に当たらないと書かれている | Googleの検索セントラル |
| 検索やAI検索への効果 | 公式に記載なし | Google、OpenAI、Anthropicの公式文書 |
この記事で確かめた資料
この記事の記述は、2026年11月15日に開いた資料だけに基づいています。
| 資料 | 確かめたこと |
|---|---|
| HTMLの仕様(WHATWG)のdetails要素とsummary要素の章、描画の章、ユーザー操作の章 | 定義、open属性とname属性の決まり、ページ内検索との関係。仕様の更新表示は2026年11月14日 |
| ARIA in HTML(W3C勧告、2026年8月11日)とHTML Accessibility API Mappings(W3C作業草案、2026年10月26日版) | details要素とsummary要素に割り当てられる役割と状態 |
| WAI-ARIA Authoring Practices Guideのアコーディオンと開閉のパターン | 開閉部品の定義 |
| CSS Pseudo-Elements Module Level 4とCSS Box Sizing Module Level 4 | 開閉の見た目とアニメーションの書き方(どちらも草案) |
| Googleの検索セントラルのスパムポリシー、モバイルファーストインデックス、スニペット、AI機能とウェブサイトの各文書 | 閉じた中身の扱い |
| OpenAIとAnthropicの、クローラーに関する公式文書 | details要素や閉じた中身への言及の有無 |
| WordPressの開発版のソースコード | 詳細ブロックが出すHTML |
| W3Cの検査サービスでの実測 | 書き方を変えた14通りで出るエラー |
| 自動操作のブラウザでの実測 | name属性の動き、URLの#で飛んだときの動き、操作のしかた |
| 弊社サイトの33ページの実測 | details要素の数と書き方 |
この記事で使う言葉
読み進める前に、3つの言葉の意味をそろえます。
「開閉部品」は、押すと追加の情報が現れ、もう一度押すと隠れる部品のことです。仕様では、この部品を指す専用の呼び名が使われています。
「閉じた中身」は、details 要素が閉じているときに、画面に見えていない部分を指します。summary は含みません。
「検査サービス」は、HTMLの書き方が仕様に合っているかを調べる、W3Cの無料の道具です。この記事では、2026年11月15日に、版番号26.11.14のものを使いました。
知りたいことから読む節を選ぶ
目的ごとに、読む節を表にしました。急ぐ方は、自分の疑問の行だけを読んでください。
| 知りたいこと | 読む節 |
|---|---|
| 書き方の基本を知りたい | 「details要素とは」「summary要素の書き方」 |
| 最初から開く、1つだけ開く | 「open属性」「name属性」 |
| 見た目やアニメーションを変えたい | 「見た目を変える」 |
| 検索やAI検索に読まれるのか | 「ページ内検索」「検索エンジンに読まれるか」「AIとの関係」 |
| よくある質問のページに使いたい | 「FAQに使う書き方」「WordPressの詳細ブロック」 |
Q&Aサイトで見かけた「PCでは開いて、スマホでは閉じたい」という悩み
先日、Q&Aサイトでこのような切実な悩みを拝見しました。
Webの制作を始めたばかりの方からの相談です。details 要素でアコーディオンを作っている。パソコンでは最初から開いた状態で、スマートフォンでは閉じた状態で表示したい。パソコン側は open 属性を使えばよいと分かるが、スマートフォンでの切り替え方が分からない、という質問でした。
回答に書かれていたこと
寄せられた回答は1件でした。
前半は、Webデザイナーとコーダーの職種の違いの説明でした。後半で、「JavaScriptを使う」と答え、details と summary にJavaScriptを足してアコーディオンを作る方法を解説したページを紹介していました。
質問者が知りたかった点への答えは、この「JavaScriptを使う」の一言です。
この悩みへの答え
この答えは、仕様と合っています。
HTMLの仕様の open 属性の章には、画面の幅によって開閉の初期状態を切り替える仕組みが、見つかりませんでした。属性は、HTMLに書くか、スクリプトで付け外すか、利用者が開け閉めするかの、いずれかで変わります。
この記事では、open 属性の決まりを仕様で確かめ、画面の幅で切り替えたいときの考え方を整理します。さらに、閉じた中身が検索エンジンやページ内検索にどう扱われるかを、Googleの文書で確かめます。
details要素とは:仕様が書いている定義
仕様の定義
HTMLの仕様(WHATWG)は、details 要素を、次のように定義しています(英語の原文を和訳)。
「details要素は、利用者が追加の情報や操作部品を取り出せる、開閉部品を表す。」
「追加の情報」が、閉じた中身です。「操作部品」は、入力欄やボタンのことで、開閉の中に隠しておく使い方も仕様の例に載っています。
仕様が details 要素について定めている性質を、表にします。
| 項目 | 仕様の記述 |
|---|---|
| 分類 | 本文の流れに置ける要素で、利用者が操作する要素の仲間 |
| 置ける場所 | 本文の流れに置ける要素が、期待される場所 |
| 中身 | 1つのsummary要素と、そのあとに続く本文の流れの要素 |
| 開始タグと終了タグ | どちらも省略できない |
| 使える属性 | 全要素共通の属性と、name属性、open属性 |
向いていない使い方:タブ、メニュー、脚注
仕様は、details 要素の章で、使い方の誤りも書いています(英語の原文を和訳)。
「タブ部品やメニュー部品は開閉部品ではない。これらの型を実装するために details 要素を流用するのは、正しくない。」
脚注についても、details 要素は適さない、と書かれています。脚注の書き方は、仕様の別の節に載っている、という案内です。
この一文から、画面上部のタブの切り替えを details で作るのは、仕様の趣旨に合わないと読めます。
サイトのメニューを details で作ってよいかは、この一文だけでは決められませんでした。仕様は「メニュー部品」を挙げていますが、どこまでを指すのかは、この箇所には書かれていないからです。
よくあるFAQの開閉や、補足説明の開閉は、仕様の例に近い使い方です。仕様の例には、進捗の詳細を隠す場面と、入力欄を隠す場面が載っています。
仕様の例が示す使い方
仕様の details 要素の章には、使い方を示す例が載っています。どの場面で使う想定なのかが分かるので、主な4つを表にします。
| 仕様の例 | 隠している中身 |
|---|---|
| ファイルのコピーの進捗 | 転送の速さ、ファイル名、所要時間などの技術的な詳細 |
| 入力欄を含む設定 | ファイル名の入力欄と、拡張子を隠すチェック欄 |
| 額縁の説明 | 材質、大きさ、色。name属性で、1つだけ開く形にしている |
| 状態表示 | 速度や方角。開閉に応じて、見出しの色を変える |
共通しているのは、見出しの1行だけで全体が分かり、詳細は必要な人だけが開く、という作りです。仕様の例は、見出しの1行に要点を書き、詳細を閉じた中に入れています。
進捗の例では、見出しの1行に、コピー中であることと、進み具合の25%が書かれています。詳細を開かなくても、いまの状況が分かります。
仕様は、入力欄の2つの例について、見出しは変えられる内容を要約しているだけで、実際の値までは示していない、と書いています。「理想的とは言えない」という評価です(英語の原文を和訳)。開かなくても値が分かる見出しのほうが望ましい、と読めます。
入れ子にしたいとき
仕様が入れ子について書いているのは、1点だけです。同じnameグループに入っている details 同士が、祖先と子孫の関係になってはならない、という決まりです。
name属性を使わない details を、別の details の中に置くことは、この決まりの対象外です。ただし、開閉が二重になるので、利用者がどこまで開いたのかを見失いやすくなります。入れ子にするのは、中身が階層になっている場合に絞ります。
置ける場所と、置けない場所
検査サービスに、置き場所を変えた書き方を4通り渡して、結果を測りました。
| 書き方 | 結果 |
|---|---|
| 本文の直下や、section要素の中に置く | エラーなし |
| 表のセルの中に置く | エラーなし |
| p要素(段落)の中に置く | エラー。段落が途中で閉じられ、後ろの終了タグが余る |
| 表の行の直下に置く | エラー。検査はそこで打ち切られた |
表の行を開閉したい、という相談は、Q&Aサイトの検索結果にも2件ありました。表の行の直下には置けないので、開閉したい内容をセルの中に入れ、そのセルの中に details を置く形になります。
p要素の中に置けないのは、p要素が、文字や文中の要素だけを入れる決まりだからです。details は、段落と同じ並びに置きます。
summary要素の書き方
summaryは最初の子に1つだけ
仕様は、details 要素の中身を「1つのsummary要素と、そのあとに続く本文の流れの要素」と定めています。見出しの役を担うのは、最初に現れる summary の子です。
書き方の基本形は、次のとおりです。
<details>
<summary>返品はできますか</summary>
<p>未開封の商品は、到着後にご連絡いただければ承ります。</p>
</details>
summary は、details の直下の最初の子に、1つだけ置きます。検査サービスで、2つ置く書き方と、段落のあとに置く書き方を測ると、どちらもエラーになりました。
押す場所は、summary の部分です。仕様は、summary を押したときの動きを、親の details に open 属性が付いていれば外し、無ければ付ける、と定めています。
summaryを省くとどうなるか
summary を書かなかった場合を、仕様と検査サービスで比べます。
| 見るもの | 結果 |
|---|---|
| HTMLの仕様 | summaryの子が無ければ、ブラウザが自分で見出しを用意するべき。例として「Details」が挙がっている |
| HTML Accessibility API Mappings | summaryが無ければ、ブラウザは「details」にあたる、その言語の文字を持つ見出しを用意するべき |
| 検査サービス | エラー。「details要素に、必須の子要素summaryが無い」 |
ブラウザが用意する見出しの文字は、ブラウザや言語の設定で変わります。サイトの運営者が、何と表示されるかを決められません。
検査サービスがエラーにする点も合わせると、summary は、実際には必ず書くものです。
summaryの中に入れてよいもの
仕様は、summary の中身を、文中の要素(文字、強調、リンクなど)と定めています。見出し要素を混ぜてもよい、とも書かれています。
検査サービスでは、summary の中にh3を入れても、リンクを入れても、エラーは出ませんでした。よくある質問のページで、質問を見出しとして、目次や見出しの構造に出したい場合は、見出し要素を入れる形になります。
summary に role="button" を付ける書き方は、避けるべき例として、ARIA in HTMLに載っています(英語の原文を和訳)。
「これは不要であり、環境をまたいだ問題を起こしうる。たとえば、要素が状態を正しく伝えるのを妨げる。」
検査サービスも、この書き方をエラーにしました。「親のdetailsの見出しになっているsummaryには、role属性を使ってはならない」という内容です。
summaryの中にリンクを入れた場合
リンクの文字を押すか、それ以外の部分を押すかで、動きが分かれます。自動操作のブラウザ2種(Chromium 145.0.7632.6とWebKit 26.0)で測りました。
| 押した場所 | 結果(2種のブラウザで同じ) |
|---|---|
| summaryの中のリンクの文字 | リンク先へ移動した。開閉は起きなかった |
| summaryの、リンク以外の部分 | 開閉した |
1つの見出しの中に、開閉の操作と、移動の操作が同居します。使う場合は、どちらを押すと何が起きるかが、利用者に伝わる文面にします。
ここまでの書き方を図にする
details を書く順番を、図にまとめます。
open属性:最初から開いておく書き方
付けたときと付けないとき
仕様は、open 属性を、値を持たない属性(真偽属性)と定めています。付いていれば、見出しと追加の情報の両方が見えます。付いていなければ、見出しだけが見えます。
要素が作られた時点で付いていれば、最初から開いた状態になります。あとから属性が外されれば隠れ、付けられれば現れます。
書き方は、details の開始タグに、open と書き足す形です。検査サービスで、open と open="open" の両方を測ると、どちらもエラーは出ませんでした。
| 書き方 | 初期の状態 | 検査サービス |
|---|---|---|
| open属性なし | 見出しだけが見える | エラーなし |
| open属性あり | 見出しと中身が見える | エラーなし |
| open=”open” | 見出しと中身が見える | エラーなし |
開閉でopen属性が付け外しされる
利用者が見出しを押すと、ブラウザが open 属性を付けたり外したりします。仕様は、開くときは空の値で付け、閉じるときは外す、と定めています。
つまり、open 属性は、いまの状態を映す印になります。この性質があるので、CSSで開いているときだけ見た目を変える書き方や、スクリプトで開閉を読み取る書き方が成り立ちます。
開閉が起きると、toggle という出来事が発生します。仕様は、短い間に何度も開閉された場合は、出来事を1つにまとめる、と定めています。
自動操作のブラウザ2種で、見出しを押して測ると、どちらも新しい状態が「open」の出来事が1回発生しました。
画面の幅で切り替えたいとき
冒頭のQ&Aの相談に戻ります。パソコンでは開き、スマートフォンでは閉じたい場合です。
仕様の open 属性の章には、画面の幅の条件で初期状態を切り替える記述が見つかりませんでした。一方で、仕様は、属性の付け外しがそのまま開閉に反映される、と定めています。
そのため、画面の幅が条件に合うかを調べるスクリプトで、読み込み時に open 属性を付け外しする作りになります。回答の「JavaScriptを使う」と、同じ結論です。
選び方を表にします。
| やりたいこと | 書き方 | 根拠 |
|---|---|---|
| 全部の画面で最初から開く | open属性を付ける | HTMLの仕様 |
| 全部の画面で最初は閉じる | open属性を付けない | HTMLの仕様 |
| 画面の幅で切り替える | スクリプトで、読み込み時にopen属性を付け外しする | HTMLの仕様の、属性の付け外しが反映されるという決まり |
| 全部の項目を一括で開く、閉じる | スクリプトで、すべてのdetailsのopen属性を付け外しする | 同上 |
画面の幅で切り替えるときは、Googleの文書も確認しておく点があります。スマートフォン用の表示で内容を開閉の中に入れてもよいが、パソコン用の表示と内容をそろえること、という趣旨です。詳しくは、あとの「閉じた中身は検索エンジンに読まれるか」で見ます。
name属性:同じ名前の中で1つだけ開く
書き方
複数の details に、同じ値の name 属性を付けると、そのうちの1つだけが開く形になります。仕様はこれを「排他的なアコーディオン」と呼んでいます。
<section>
<h2>配送について</h2>
<details name="faq">
<summary>送料はかかりますか</summary>
<p>ご注文の内容によって変わります。</p>
</details>
<details name="faq">
<summary>お届けまでの日数は</summary>
<p>在庫のある商品は、翌営業日に発送します。</p>
</details>
</section>
1つ開くと、同じ名前のほかの details が閉じます。仕様は、この排他の動きを、ブラウザが担うものとして定めています。
守るべき決まり
仕様が、書き手に課している決まりを表にします。
| 決まり | 内容 |
|---|---|
| 値は空にしない | name属性を書くなら、空の値は不可 |
| openは1つまで | 同じ名前の中で、open属性が付いたdetailsは1つまで |
| スクリプトでも守る | スクリプトで追加して、openが2つ以上になる状態を作らない |
| 入れ子にしない | 同じ名前のdetailsが、別の同じ名前のdetailsの中に入らない |
| 近くにまとめる | 関連するdetailsは、section要素やarticle要素のような包む要素にまとめる。見出しで導入するのがよい |
最後の行にも、理由が書かれています。仕様は、関連する要素が離れた場所に散らばると、利用者が関係に気づきにくくなる、と説明しています(英語の原文を和訳)。
検査サービスとブラウザで測った結果
書き方を変えて、検査サービスとブラウザで測りました。
| 測ったこと | 結果 |
|---|---|
| name付きのdetailsを2つ並べる(検査サービス) | エラーなし |
| name属性の値を空にする(検査サービス) | エラー。「空にしてはならない」という内容 |
| 同じ名前で、openを2つ付ける(検査サービス) | エラーは出なかった。仕様は禁止している |
| 同じ名前で、openを2つ付けて読み込む(ブラウザ2種) | 先に書いた1つだけが開いた状態になった |
| 同じ名前の1つを押す(ブラウザ2種) | 開いていた別の1つが閉じた |
| 開いている1つをもう一度押す(ブラウザ2種) | 閉じて、全部が閉じた状態になった |
検査サービスは、openが2つの書き方を見逃しました。仕様が禁止していても、検査サービスが警告するとは限らないので、書き手が自分で気をつけます。
同じ検査ソフトを動かしている別の公開サーバーでは、name属性そのものが「ここには使えない」とエラーになりました。検査の道具の側で、仕様への対応に差があります。
ブラウザは、Chromium 145.0.7632.6とWebKit 26.0で測りました。どちらも、name属性に対応していました。この2種以外のブラウザは測っていません。対応の状況は、ブラウザによります。
使うべきか
仕様は、name属性を使う前に、考えるべきことを書いています(英語の原文を和訳)。
「排他的なアコーディオンは、内容が占める面積の最大値を減らせる。一方で、探しているものを見つけるために多くの項目を開く必要がある利用者や、複数の項目の内容を同時に見たい利用者を、いらだたせることもある。」
弊社の考えを足します。1つの質問ずつ読んでいく使い方なら、name属性は向いています。複数の項目を見比べる使い方には向きません。
見比べたい項目は、name属性を付けずに並べます。利用者が、必要な数だけ開けます。
CSSとJavaScriptを使わずにアコーディオンが作れるか
仕様が決めている動き
作れます。開閉の動きは、ブラウザが標準で持っているからです。
仕様は、summary を押したときの動きを定めています。さらに、仕様は、親の details の見出しになっている summary を、キーボードで順に移動したときに止まる要素に含めています。
自動操作のブラウザ2種で、見出しに移動して、キーボードで測りました。
| 操作 | 結果(2種のブラウザで同じ) |
|---|---|
| 見出しに移動して、Enterを押す | 開いた |
| 続けて、スペースを押す | 閉じた |
| 見出しを押す(マウスやタッチの代わり) | 開閉した |
アコーディオンの定義との関係
アコーディオンの定義は、WAI-ARIA Authoring Practices Guideに載っています(英語の原文を和訳)。
「アコーディオンは、縦に積まれた、操作できる見出しの集まりである。各見出しは、内容の区画を表す題名、抜粋、またはサムネイルを含む。」
この文書のアコーディオンと開閉の2つのパターンは、ボタンと、状態を伝える属性を、スクリプトで組み合わせる作り方を説明しています。details 要素への言及は、2つの文書に見つかりませんでした。
details は、同じ動きの土台を、ブラウザの側が持っている部品、と位置づけられます。
JavaScriptが要る場面
開閉そのものには要りません。次の場面では、スクリプトを足すことになります。
| やりたいこと | スクリプト |
|---|---|
| 開く、閉じる | 要らない |
| 最初から開いておく | 要らない(open属性) |
| 1つだけ開く | 要らない(name属性。ブラウザの対応による) |
| 画面の幅で、初期状態を切り替える | 要る |
| 全部を一括で開く、閉じる | 要る |
| 開閉の出来事に合わせて、別の処理をする | 要る(toggleの出来事) |
見た目を変える:三角の印とアニメーション
三角の印の正体
見出しの左に出る三角の印は、リストの印と同じ仕組みで描かれます。
HTMLの仕様の描画の章は、見出しの既定の見た目を、次のように定めています。見出しを「リストの項目」として表示し、印の種類を、閉じているときは「閉じた開閉部品の印」、開いているときは「開いた開閉部品の印」にします。
そのため、印を変えたり消したりしたいときは、リストの印を変えるCSSの書き方で上書きする形になります。
| 変えたいこと | 手掛かり |
|---|---|
| 印の形を変える | 見出しの、リストの印の種類を指定する |
| 開いたときだけ見た目を変える | details[open] という書き方で、開いている状態を選ぶ |
| 見出しを押せると分かる見た目にする | 弊社トップページは、見出しに別の飾りを足している(次の節) |
仕様の例にも、開閉に応じて見出しの色を変える書き方があります。open 属性が付け外しされることを、CSSで使っています。
開閉のアニメーション
閉じた中身は、仕様の描画の章によると、「描画を省く」という指定で隠されます。表示そのものを消す指定とは別のものです。仕様は、この選び方によって、画面の配置を調べる各種の命令の結果が変わる、と書いています。
開閉の中身の部分には、名前が付いています。CSSの草案(CSS Pseudo-Elements Module Level 4、W3Cの作業草案、2025年6月27日版)が、::details-content という名前で定義しています。
草案には、中身の透明度を動かす例が載っています。
details::details-content {
opacity: 0;
transition: content-visibility 300ms allow-discrete, opacity 300ms;
}
details[open]::details-content {
opacity: 1;
}
高さを滑らかに変えたい場合は、別の草案の出番です。CSS Box Sizing Module Level 4(編集者草案、2026年10月27日版)は、高さの「自動」と数値の間を、滑らかに変化させるための設定を定義しています。
この草案の冒頭には、実装するなら第3版を参照するように、という注意が書かれています。仕様として固まっていない部分なので、将来、書き方が変わる可能性があります。
ブラウザの対応は、自動操作のブラウザ2種で、2026年11月15日に測りました。
| 調べたこと | Chromium 145.0.7632.6 | WebKit 26.0 |
|---|---|---|
| 開閉の中身を指す書き方 | 対応 | 対応 |
| 描画を省く指定 | 対応 | 対応 |
| 離散的な値の変化を動かす設定 | 対応 | 対応 |
| 高さの「自動」を滑らかに変える設定 | 対応 | 対応していない |
この2種以外のブラウザは測っていません。アニメーションは、ブラウザによります。
CSSが解釈されないブラウザでも、開閉の動きそのものは、ブラウザの標準のままです。アニメーションを足しても、開閉が壊れる心配は小さいと読めます。ただし、この点は、今回の測定の範囲外です。
弊社トップページのCSS
弊社のトップページのよくある質問は、details 要素で作ってあります。ページのCSSを読むと、開閉の印に関わる書き方が3つありました。
| 書いてあること | 役割 |
|---|---|
| 見出しの標準の三角を消す書き方 | ブラウザ固有の名前で、標準の印を非表示にしている |
| 見出しのうしろに、別の記号を描く書き方 | 独自の開閉の印を出している |
| 開いたときに、その記号を回転させる書き方 | open 属性が付いている間だけ、向きを変えている |
標準の印を消す書き方の名前は、仕様の描画の章には出てきませんでした。ブラウザ固有の名前だと読めます。仕様に載っている書き方は、リストの印を変える形です。
ページ内検索で、閉じた中身は見つかるか
仕様の記述
HTMLの仕様のユーザー操作の章には、「ページ内検索」の節があります。閉じた details の中身について、次のように書かれています(英語の原文を和訳)。
「ページ内検索が一致する語を探し始めるとき、ページ内のopen属性が付いていないすべてのdetails要素は、open属性を変更せずに、中身が検索できる状態になるべきである。」
検索が終われば、中身は元の隠れた状態に戻ります。この一連の処理は、同期的に行われ、利用者にも、ページのスクリプトにも見えないものと書かれています。
つまり、閉じていても、中身の文字は検索の対象になります。
見つけたあとの動き
一致する語が見つかり、その1つが選ばれると、ブラウザは、その語を含む details を開きます。仕様は、選ばれた一致の祖先をたどって、閉じた details の open 属性を付ける手順を定めています。
仕様には、安全面の注意も書かれています。ページ内検索で自動的に開くと、toggle の出来事が発生します。ページ側が、この出来事から、利用者が検索窓に打っている文字を推測できてしまう、という指摘です。
この指摘は、ページ内検索で閉じた中身が自動的に開く、という動きが、仕様に書かれていることの裏づけにもなっています。
URLの#で飛んだときの動き
閉じた details の中にある見出しや段落に、URLの末尾の「#」で飛ぶ場合を、ブラウザ2種で測りました。
| 測ったこと | 結果(2種のブラウザで同じ) |
|---|---|
| 閉じたdetailsの中の段落のidに、#で移動する | 移動した先のdetailsが、開いた |
| 別の閉じたdetailsの中の段落のidに、#で移動する | その中身のdetailsが、開いた |
FAQの個別の質問に、#付きのURLでリンクを張る場合に関わります。質問が閉じた状態でも、リンクを開くと、その質問が開いた状態で表示されます。
ページ内検索の画面そのものは、今回、ブラウザでは測っていません。確かめたのは、仕様の記述までです。ブラウザの実際の挙動は、ブラウザによります。
閉じた中身は検索エンジンに読まれるか
Googleの文書が書いていること
Googleの検索セントラルの3つの文書に、閉じた中身に関する記述がありました。
| 文書(日本語版) | 書かれていること |
|---|---|
| Google ウェブ検索のスパムに関するポリシー(2026年9月2日更新) | アコーディオンやタブは、ポリシーに違反していない |
| モバイルファースト インデックスに関するおすすめの方法(2026年2月20日更新) | アコーディオンやタブに内容を移してよい。ただし、パソコン用と内容をそろえる |
| スニペットの管理・メタ ディスクリプションについて(2026年11月10日更新) | 深いリンクを出すには、展開できる区画の背後に隠さない |
スパムポリシーは、次のように書いています。
「追加コンテンツの表示 / 非表示を切り替えるアコーディオンやタブ形式のコンテンツ」は、Google のポリシーに違反していません。
モバイルファーストインデックスの文書は、モバイル用の表示で場所を空けたいときについて、内容を取り除く代わりに、次の方法を挙げています。
「アコーディオンやタブに移動することでスペースを確保することをご検討ください。」
そのうえで、「サイトのインデックス登録はモバイルサイト経由であるため、コンテンツはパソコンサイトと同等にします」とも書いています。
スニペットの文書は、検索結果に、ページ内の節への深いリンク(スニペットの中のリンク)が出る可能性を高めるおすすめの方法として、次のように書いています。
「コンテンツがページにすぐに表示される状態であることを確認できるようにします(たとえば、展開可能なセクションやタブ付きインターフェースの背後に隠れていないことを確認します)。」
文書に書かれていないこと
この3つの文書のどれにも、details 要素という名前は出てきません。書かれているのは、「アコーディオン」「タブ」「展開可能なセクション」という、見た目の呼び名です。
また、閉じた中身が必ずインデックスに登録されるのか、検索順位にどう影響するのかは、書かれていません。AI機能の文書も、インデックス登録と配信は保証されているものではない、と書いています。
したがって、確かめられたことは、閉じた中身を持つ作りが、スパムの規則の対象外とされていること。それから、深いリンクの対象にしたい内容は、閉じた中に入れないほうがよいこと、の2点です。
隠し文字との違い
スパムポリシーは、隠しテキストの不正使用を、次のように定義しています。
「検索エンジンを操作することのみを目的としてページにコンテンツを配置し、人間のユーザーには見えにくくする行為」
例として挙げられているのは、白い背景に白い文字、画像の背後に置いた文字、画面の外に配置した文字、大きさや透明度を0にした文字です。
閉じた details の中身は、利用者が見出しを押せば読めます。ページ内検索でも自動的に開きます。この点が、例に挙がった隠し方と違います。
AI向けの隠し文字や指示文については、既存の記事AI向けの隠し文字や指示文はLLMO対策になるのか|研究とGoogleの規則で確かめましたで、研究とGoogleの規則を確かめています。
モバイルとパソコンで中身をそろえる点は、【Google検索セントラル解説】モバイルファーストインデックスの公式ガイド|スマホ版とパソコン版でそろえる項目と確認手順が詳しいです。
FAQに使う書き方
要点は見える場所に、補足は閉じた中に
よくある質問のページで details を使うとき、迷うのは、答えをどこまで閉じた中に入れるかです。
この記事の軸は、次のとおりです。答えの要点は、summary と、開かなくても見える場所に書きます。補足だけを、閉じた中に入れます。
根拠は3つあります。仕様の進捗の例は、見出しの1行に進み具合を書いています。Googleの深いリンクの条件は、内容が閉じた区画の背後に隠れていないことです。仕様は、排他的なアコーディオンで、利用者が多くの項目を開かされる点を、いらだちの原因に挙げています。
置く内容と場所の対応を、表にします。
| 内容 | 置く場所 | 理由 |
|---|---|---|
| 質問 | summaryの1行 | 開く前に、何の質問かが分かる |
| 結論の1〜2文 | 開かなくても見える場所 | 開かない利用者にも、答えが届く。深いリンクの条件にも合う |
| 例外、手順、用語の説明 | 閉じた中 | 必要な人だけが開けばよい補足 |
| 誤解されると困る注意 | 開閉の外 | 開かなかった人が、知らないまま進むのを防ぐ(弊社の考え) |
| 問い合わせの案内 | 見える場所 | 質問をすべて閉じていても、行き先が見える |
弊社トップページの場合
弊社のトップページのよくある質問は、20個の details で作っています。質問を summary に書き、答え全体を閉じた中に置く形です。
20個すべてが、閉じた状態で配信されています。open 属性も name 属性も付いていません。
この記事の軸に当てはめると、答えの最初の1文を、開閉の外に出す余地があります。自社の作りにも、見直す点がある、という確認です。
FAQページの作り方は別の記事へ
質問の集め方、回答の書き方、ひな形といった、FAQページそのものの作り方は、別の記事に書いています。この記事は、details という部品の決まりに絞っています。
作り方は、BtoB中小企業のFAQページの作り方と育て方 質問の集め方・回答の書き方・ひな形つき【2026年10月版】をご覧ください。
読み上げでの扱い
ARIA in HTMLの定め
ARIA in HTML(W3C勧告、2026年8月11日)は、details 要素と summary 要素に、付けてよい役割を定めています。
| 要素 | 付けてよい役割 |
|---|---|
| details | groupだけ。ただし、付けることは勧められていない |
| summary(親のdetailsの見出しになっているもの) | 役割は付けない |
ARIA in HTMLは、summary 要素について、支援技術に伝わる役割が、ブラウザと支援技術によって変わりうる、と注記しています(英語の原文を和訳)。
役割と状態の割り当て
HTML Accessibility API Mappings(W3C作業草案、2026年10月26日版)が、ブラウザが支援技術に伝える役割を、環境ごとに定めています。
| 対象 | 割り当て |
|---|---|
| details | groupの役割 |
| 最初のsummary | 環境ごとのボタンに近い役割。開閉の操作を持つボタンや、開閉の三角として伝わる |
| openの有無 | summaryに、開いている、閉じている、という状態が付く |
| summaryの名前 | aria-labelなどの指定が先。なければ、summaryの中の文字。それもなければ、title属性 |
| summaryが無い場合 | ブラウザが「details」にあたる語の見出しを用意する |
つまり、summary の中の文字が、支援技術にとっての、部品の名前になります。「詳細」「こちら」のような曖昧な見出しは、名前としても曖昧になります。
実際の読まれ方は測っていない
読み上げソフトが、実際にどう読み上げるかは、ソフトとブラウザの組み合わせで変わります。この記事では、仕様の割り当てを確かめたところまでで、読み上げソフトでの実測はしていません。
書き手にできることは、summary の文字を、中身が分かる具体的な言葉にすることと、role 属性を足さないことです。
dialogやbuttonとの違い
仕様は、dialog 要素を、次のように定義しています(英語の原文を和訳)。
「dialog要素は、アプリケーションの一時的な部分を表す。小さな窓(ダイアログボックス)の形をとり、利用者が作業をしたり、情報を集めたりするためにやり取りする。」
details と並べると、使いどころが分かれます。
| 部品 | 仕様の説明 | 使いどころ |
|---|---|---|
| details | 追加情報の開閉部品 | ページの流れの中で、補足を開閉する |
| dialog | 一時的な小窓 | 作業や確認のために、別の小窓を出す |
| タブ、メニュー | 開閉部品ではない(仕様の記述) | details で作らない |
button 要素は、開閉の仕組みをスクリプトで自作するときの部品です。WAI-ARIA Authoring Practices Guideのアコーディオンのパターンは、ボタンと状態の属性を組み合わせています。ボタンの書き方は、buttonタグとは type属性とaタグの使い分けまで仕様で確かめるで、仕様を確かめています。
WordPressの詳細ブロックと弊社サイト
WordPressの詳細ブロック
WordPressには、標準の「詳細」ブロックがあります。開発版のソースコード(2026年11月15日に確認)で、出力するHTMLを確かめました。
ブロックの説明は、「追加の内容を隠したり表示したりする」という趣旨の1文です(英語の原文を和訳)。
| ブロックの設定 | 出力されるHTML |
|---|---|
| 最初から開く(設定の名前はshowContent) | open属性 |
| 名前(グループ化) | name属性 |
| 概要の文字 | summary要素の中身。空のままだと「Details」という英語の文字 |
| 中身 | summaryの後ろに、内側のブロックが並ぶ |
| クラス | wp-block-details |
概要を空のまま保存すると、summary に、英語の「Details」が入る作りです。日本語のサイトでは、概要を必ず書きます。
スタイルは、ブロック全体の寸法の数え方と、見出しの指の形の設定の、2つだけでした。
弊社サイトの実測
弊社サイトの33ページのHTMLを、2026年11月15日に取得して数えました。トップページ、2本の記事、30本の記事です。
| 測ったこと | 結果 |
|---|---|
| details要素を使っているページ | 1ページ(トップページ) |
| トップページのdetails要素の数 | 20個 |
| summary要素の数(33ページの合計) | 20個 |
| WordPressの詳細ブロックのクラスが付いたもの | 0個 |
| name属性、open属性が付いたもの | 0個 |
| FAQPageの構造化データ | 0ページ |
トップページの20個には、詳細ブロックのクラスが付いていません。ページ専用の書き方で作られています。
確かめられなかったこと
2点あります。1点目は、開発版のソースコードが、公開されているWordPressの何版から入っているかです。確かめられなかったので、お使いのWordPressで、ブロックを置いて、ページのソースで確かめてください。
2点目は、お使いのテーマが、詳細ブロックの見た目を上書きしているかです。テーマによって、三角の印や枠が変わります。
AIとの関係:公式に記載なし
Googleの文書
Googleの検索セントラルの「AI 機能とウェブサイト」は、AIによる概要とAIモードについて、次のように書いています。
「AI による概要や AI モードにコンテンツが表示されるための追加の要件はなく、別途特別な最適化を行う必要もありません。」
技術要件は、ページがインデックスに登録されていること、検索でスニペットが表示されることなどです。この文書に、アコーディオンや details 要素、閉じた中身への言及は、見つかりませんでした。
OpenAIとAnthropicの文書
OpenAIのクローラーの概要と、Anthropicのクローラーに関するヘルプにも、details 要素や、閉じた中身の扱いについての記載は、見つかりませんでした。
書けること、書けないこと
| 区分 | 内容 |
|---|---|
| 書けること | 閉じた中身の文字は、HTMLの中に文字として入っている。弊社トップページで、HTMLを取得して確かめた |
| 書けないこと | AIのクローラーが、閉じた中身を読むか。引用に使うか。公式に記載なし |
| 言えないこと | details を使えば、AIに引用される、ということ |
details を使う理由は、利用者が見やすい形で、補足を整理することに置いてください。AIに引用される、という約束には、置けません。
よくある質問
Q1. detailsタグを使うと、検索順位は下がりますか
下がる、という公式の記述は、見つかりませんでした。Googleのスパムポリシーは、アコーディオンやタブを、違反に当たらないと書いています。
ただし、深いリンクの条件には、閉じた区画の背後に隠さないこと、とあります。
Q2. スマートフォンだけ閉じる設定は、HTMLだけでできますか
仕様には、画面の幅で初期状態を切り替える記述が見つかりませんでした。スクリプトで、open 属性を付け外しする形になります。
Q3. nameを付けると、どのブラウザでも1つだけ開きますか
測った2種のブラウザ(Chromium 145.0.7632.6とWebKit 26.0)では、1つだけ開きました。この2種以外のブラウザは測っていません。対応は、ブラウザによります。
Q4. 閉じた中身は、ページ内検索で見つかりますか
仕様は、見つかる状態になるべきだと定めています。ブラウザの画面での確認は、していません。URLの#で飛ぶ場合は、測った2種のブラウザで、閉じた中身が開きました。
Q5. summaryを省いてもよいですか
仕様は、省いた場合に、ブラウザが見出しを用意するとしています。ただし、検査サービスはエラーにします。見出しの文字を、ブラウザ任せにすることにもなるので、書きます。
まとめ
details 要素は、利用者が開け閉めできる追加情報の箱です。見出しは、最初の子の summary が担います。
open 属性で最初から開き、同じ name 属性の値で、1つだけ開く形にできます。開閉そのものに、CSSもJavaScriptも要りません。
画面の幅で初期状態を切り替えるには、スクリプトで open 属性を付け外しします。仕様に、条件を書く仕組みは見つかりませんでした。
閉じた中身は、ページ内検索の対象になり、Googleのスパムポリシーでも違反には当たりません。ただし、深いリンクの対象にしたい内容は、閉じた中に入れません。
検索やAI検索への効果は、公式に記載なし、です。要点は見える場所に、補足だけを閉じた中に置いてください。
今日できる点検
次の表の順に、自社のページを1つ開いて確かめてください。
| 点検すること | 確かめ方 | 直し方 |
|---|---|---|
| 答えの要点が、開かなくても見えるか | ページを開き、閉じたままで読む | 要点を、見出しの下に出す |
| summaryが、各detailsの最初の子にあるか | ページのソースで、detailsの直後を見る | 無ければ、書く。2つあれば1つにする |
| summaryの文字が、具体的か | 「詳細」「こちら」だけの見出しを探す | 中身が分かる言葉に直す |
| summaryに、role属性を付けていないか | ソースで、summaryの付近を探す | 付いていれば外す |
| name属性を使うとき、openが1つまでか | ソースで、同じ名前のdetailsを探す | 2つ以上あれば、1つにする |
| 誤解されると困る注意が、閉じた中に入っていないか | 閉じた中の文章を読む | 開閉の外に出す |
| WordPressの詳細ブロックの概要が、空でないか | ページのソースで、「Details」を探す | 日本語の概要を書く |
画面の幅で初期状態を切り替えているページは、パソコン用とスマートフォン用で、内容が同じかも確かめます。
この記事に書いたことを、そのまま御社のページに
生成AIに引用されるページを、お話しいただくだけでお作りします。お時間をいただくのは初回15分のヒアリングだけです。まず1ページ、無料でお作りします。
OKが出るまで、何度でも直します。事実が違う、言い回しが硬い、この話は入れないでほしい。どれも遠慮なくおっしゃってください。何度お直ししても、追加の料金はいただきません。
これまでに127社にご利用いただきました。毎月ご依頼いただいている方の6割以上が、月10ページを選ばれています。料金はページに掲載しています。
ページを増やしても問い合わせが来ないなら、原因はページの外にあります。その場合は、下の入口からご相談ください。
自社のマーケティング課題を根本から解決しませんか?
ウェブサイトから要素を引き算し、訪れた人が迷わず次の一歩に進む形へ組み直す。初回60分のオンラインで御社のサイトを一緒に読み、どこから直すべきかをお伝えします。手順をまとめた無料の診断と解説動画もご用意しています。
初回は無料・60分・オンライン完結・その場で契約のお願いはいたしません


