表示領域の HTML と class 名¶
AI SEARCH は、insertSelector の要素の中に表示領域の HTML を追加します。表示領域の要素には、gn-ais で始まる class 名が付与されます。
| 項目 | 内容 |
|---|---|
| 対象者 | タグを設置する方(エンジニア、制作会社) |
| ページの概要 | 表示領域の HTML の構造と class 名を確認し、サイトの CSS 調整や表示の確認に使用できます |
| 前提条件 | タグの設置の手順で、AI の回答が表示されていること |
表示領域の HTML¶
default のテーマで、回答の表示が完了した時点の HTML です。<div id="ai-search"> は、insertSelector に記述したセレクタに該当するサイトの要素です。
<div id="ai-search">
<div class="gn-ais gn-ais-v1 gn-ais-default gn-ais-completed">
<div class="gn-ais-header">[headerText の固定メッセージ]</div>
<div class="gn-ais-body">
<div>
[回答の HTML]
<div class="gn-ais-references">
<ul>
<li><a href="https://example.com/price.html" target="_blank">1,3: [ページのタイトル]</a></li>
</ul>
</div>
</div>
</div>
<div class="gn-ais-footer">[footerText の固定メッセージ]</div>
</div>
</div>
表示領域の各部分と class 名の対応は、次の図のとおりです。左が表示、右が HTML で、同じ色の枠が対応します。
図はイメージです。実際の表示は、デザインやサイトのレイアウトによって異なる場合があります。
gn-ais-headerとgn-ais-footerの要素は、headerTextとfooterTextを記述しなかった場合も、中が空の状態で挿入されますgn-ais-bodyの内容は、表示の状態によって変わります。状態ごとの内容は「表示の状態と class 名」を参照してください- テーマによって、見出しと本文の中の HTML が変わります。違いは「テーマごとの HTML の違い」を参照してください
表示の状態と class 名¶
表示領域の全体の要素(gn-ais)には、表示の状態を表す class 名が 1 つ付与されます。状態が変わると、class 名も変更されます。
| class 名 | 表示の状態 | gn-ais-body 内に表示される内容 |
|---|---|---|
gn-ais-no-input |
URL に検索キーワードがない状態で、検索結果ページを開いた場合 | noInputBodyText の固定メッセージ |
gn-ais-loading |
回答を生成している場合 | loadingBodyText の固定メッセージ |
gn-ais-rendering |
回答を表示している途中の場合 | 表示し終えた部分までの回答 |
gn-ais-completed |
回答の表示が完了した場合 | 回答と参照リンク |
gn-ais-exception |
回答を取得できなかった場合 | exceptionBodyText の固定メッセージ |
gn-ais-service-unavailable |
ページを開いたときに、サービスを利用できない場合。showServiceUnavailable: true を記述した場合のみ表示します |
serviceUnavailableBodyText の固定メッセージ |
theme1 の表示領域を状態別に並べると、次のとおりです。各画面の上の gn-ais-no-input などは、その状態で表示領域の全体の要素に付与されている class 名です。

- 画面の回答は、回答できる情報が見つからなかった場合の例です
-
theme1 と theme2 では、注意書き(
footerText)はgn-ais-renderingとgn-ais-completedのときのみ表示されます -
useStreamを記述しない場合、gn-ais-renderingは直ちにgn-ais-completedに変わります。useStream: trueを記述した場合は、回答を少しずつ表示している間、gn-ais-renderingが付きます - ページを開いたときにサービスを利用できない場合、
showServiceUnavailableを書かなければ(初期値のfalse)、表示領域は追加されません。showServiceUnavailable: trueを書くと、表示領域を追加してgn-ais-service-unavailableを付けます - 検索した時点で利用が制限された場合は、
showServiceUnavailable: trueを書いていてもgn-ais-service-unavailableは付与されず、serviceUnavailableBodyTextの固定メッセージも表示されません - 検索したときに、解約やリクエスト数の上限を超えたことなどで利用が制限されている場合は、表示領域の要素が削除されます。この場合、class 名も付与されません
表示の状態を class 名で確認する方法は「表示の確認 › class 名による表示状態の確認」を参照してください。
class 名の一覧¶
| class 名 | 付いている要素 | 付くテーマ |
|---|---|---|
gn-ais |
表示領域の全体 | すべて |
gn-ais-v1 |
表示領域の全体 | すべて |
gn-ais-[テーマ名](gn-ais-default、gn-ais-theme1、gn-ais-theme2) |
表示領域の全体。theme に書いたテーマで変わります |
すべて |
gn-ais-[状態](例: gn-ais-loading、gn-ais-completed) |
表示領域の全体。表示の状態で変わります。一覧は「表示の状態と class 名」を参照してください | すべて |
gn-ais-header |
見出し(headerText) |
すべて |
gn-ais-header-title |
見出しのラベル。gn-ais-header の中にあります |
theme1、theme2 |
gn-ais-body |
本文(回答、参照リンク、状態ごとの固定メッセージ) | すべて |
gn-ais-dots |
回答の生成中に、固定メッセージの後ろで増えていく点 | theme1、theme2 |
gn-ais-references |
参照リンクの一覧 | すべて |
gn-ais-footer |
注意書き(footerText) |
すべて |
gn-ais-content-wrapper |
回答と参照リンク、展開ボタンを囲む要素 | theme2 |
has-fade |
gn-ais-content-wrapper の要素。回答を折りたたんでいる間のみ付与されます |
theme2 |
gn-ais-content-text |
回答と参照リンク。折りたたむ高さは、gn-ais-content-text 要素の style 属性で指定されます |
theme2 |
gn-ais-show-more-btn |
長い回答を展開・折りたたみするボタン | theme2 |
gn-ais-btn-text |
ボタンの固定メッセージ(showMoreButtonText、showLessButtonText) |
theme2 |
gn-ais-btn-arrow |
ボタンの矢印(▼) |
theme2 |
expanded |
gn-ais-content-text の要素と gn-ais-show-more-btn の要素。回答を展開している間のみ付与されます |
theme2 |
class 名を使用して見た目を変更する方法は「サイトの CSS による調整」を参照してください。
テーマごとの HTML の違い¶
default¶
見出しの固定メッセージは、gn-ais-header 要素に直接挿入されます。gn-ais-header-title と gn-ais-dots の要素は挿入されません。回答の表示完了後の HTML は表示領域の HTMLのとおりです。
<div class="gn-ais gn-ais-v1 gn-ais-default gn-ais-loading">
<div class="gn-ais-header">[headerText の固定メッセージ]</div>
<div class="gn-ais-body">
<div>[loadingBodyText の固定メッセージ]</div>
</div>
<div class="gn-ais-footer">[footerText の固定メッセージ]</div>
</div>
default のテーマで回答の生成中の表示は、次のとおりです。画面の上の gn-ais-default は、表示領域の全体の要素に付く class 名です。default には背景と枠線がないため、画面では表示領域の範囲を点線で囲んでいます。

theme1¶
見出しの固定メッセージが gn-ais-header-title の要素に入ります。回答の生成中は、固定メッセージの後ろに gn-ais-dots の要素が入ります。
<div class="gn-ais gn-ais-v1 gn-ais-theme1 gn-ais-loading">
<div class="gn-ais-header">
<div class="gn-ais-header-title">[headerText の固定メッセージ]</div>
</div>
<div class="gn-ais-body">
<div>
<p>[loadingBodyText の固定メッセージ]<span class="gn-ais-dots"></span></p>
</div>
</div>
<div class="gn-ais-footer">[footerText の固定メッセージ]</div>
</div>
theme1 で回答の生成中の表示は、次のとおりです。画面の上の gn-ais-theme1 は、表示領域の全体の要素に付く class 名です。固定メッセージの後ろの点が gn-ais-dots 要素です。注意書きは HTML に含まれていますが、回答が表示されるまで表示されません。

theme2¶
見出しと、回答の生成中の HTML は theme1 と同じです。回答を表示している間と表示が終わった後は、回答と参照リンクが gn-ais-content-text の要素に格納され、高さが contentMaxHeight を超えると展開ボタンが追加されます。
<div class="gn-ais gn-ais-v1 gn-ais-theme2 gn-ais-completed">
<div class="gn-ais-header">
<div class="gn-ais-header-title">[headerText の固定メッセージ]</div>
</div>
<div class="gn-ais-body">
<div class="gn-ais-content-wrapper has-fade">
<div class="gn-ais-content-text" style="max-height: 120px; overflow: hidden;">
[回答の HTML]
<div class="gn-ais-references">...</div>
</div>
<button class="gn-ais-show-more-btn" type="button">
<span class="gn-ais-btn-text">もっと見る</span>
<span class="gn-ais-btn-arrow">▼</span>
</button>
</div>
</div>
<div class="gn-ais-footer">[footerText の固定メッセージ]</div>
</div>
- ボタンで展開すると、
gn-ais-content-wrapperの要素からhas-fadeが削除され、gn-ais-content-textとボタンの要素にexpandedが付与されます。style属性はmax-height: none; overflow: visible;になります - 回答が
contentMaxHeightの高さに収まる場合は、has-fadeとボタンの要素は挿入されません - 検索キーワードがない場合、回答を取得できなかった場合、サービスを利用できない場合は、
gn-ais-body内は<div>[固定メッセージ]</div>のみになります
theme2 で、回答を折りたたんでいる間と、ボタンで展開した後の表示は、次のとおりです。各画面の上の has-fade と expanded は、その時点で付与されている class 名です。has-fade は gn-ais-content-wrapper の要素に、expanded は gn-ais-content-text の要素とボタンの要素に付きます。

回答の展開中は、ボタンの矢印が上向きで表示されます。gn-ais-btn-arrow の要素の文字は ▼ のままです。
回答と参照リンクの HTML¶
| 部分 | HTML |
|---|---|
| 回答 | 見出し(h1〜h6)、段落(p)、箇条書き(ul、ol)、強調(strong)、リンク(a)などの要素で構成されます。回答内のリンクには target="_blank" が付与されます |
| 参照の番号 | 回答の文章内に [1] のような番号がテキストで挿入されます。番号は参照リンクの番号に対応します |
| 参照リンク | gn-ais-references 要素内に、ul と li で構成されます。リンクの文字は「番号: ページのタイトル」で、target="_blank" が付きます |
- 参照リンクには、回答内で番号が示されたページのみが含まれます
- 同じ URL のページを 2 回以上参照した場合は、1 つのリンクに集約し、番号をカンマで区切って表示します(例:
1,3: [ページのタイトル]) - 回答の中の
script、style、iframeの要素は削除されます