デザインの選択¶
設定タグの theme にテーマ名を書くと、表示領域のデザインを default、theme1、theme2 の 3 つから選べます。
| 項目 | 内容 |
|---|---|
| 対象者 | タグを設置する方(エンジニア、制作会社) |
| ページの概要 | 表示領域のデザインを 3 つのテーマから選択できます。theme2 では、長い回答を折りたためます |
| 前提条件 | タグの設置の手順で、AI の回答が表示されていること |
テーマの違い¶
| テーマ | 向いている場合 |
|---|---|
| default | サイトの CSS で見た目を最初から作成する場合 |
| theme1 | AI の回答を、検索結果の一覧と区別して強調したい場合 |
| theme2 | 回答が長くなりやすく、検索結果の一覧が下方に押し下げられるのを避けたい場合 |
| 違い | default | theme1 | theme2 |
|---|---|---|---|
| 背景 | なし | 角丸の灰色の背景 | theme1 と同じ |
見出し(headerText) |
中央揃えの文字 | 中央にそろえた、灰色のラベル | theme1 と同じ |
| 回答 | 背景なしで表示 | 白い背景で表示 | theme1 と同じ |
| 回答を作っている間 | loadingBodyText の固定メッセージだけ |
loadingBodyText の固定メッセージの後ろに表示される点が、順に増える |
theme1 と同じ |
注意書き(footerText) |
常に表示 | 回答を表示している間だけ表示 | theme1 と同じ |
| 文字の書体 | サイトの書体 | ヒラギノ角ゴ、メイリオ | theme1 と同じ |
| 長い回答 | すべて表示 | すべて表示 | 指定した高さで折りたたまれ、ボタンで展開する |
theme1 と theme2 では、headerText を記述しないと、見出しのラベルが空の状態で表示されます。theme1 と theme2 を選ぶときは、headerText も記述してください。書き方は「固定メッセージの変更」を参照してください。
テーマの指定¶
タグの設置で書いた設定タグに theme を足し、値にテーマ名を "default"、"theme1"、"theme2" のいずれかで指定します。theme を書かない場合は default になります。
<script>
window.aisConf = window.aisConf || [];
window.aisConf.push({
uid: "[サービスの ID]",
promptId: "[プロンプトの ID]",
insertSelector: "[表示領域を置く要素の CSS セレクタ]",
inputSelector: "[検索ボックスの CSS セレクタ]",
theme: "theme1",
headerText: "[見出しの固定メッセージ]",
});
</script>
[見出しの固定メッセージ] は、表示領域の見出しとして表示する固定メッセージに書き換えます。ほかの [ ] の部分はタグの設置 › 設定タグの必須 4 項目で説明している値です。
- テーマ名は小文字で書きます。3 つ以外の名前(
"Theme1"、"theme3"など)を書くと、ブラウザのコンソールにTypeErrorで始まるエラーが表示され、表示領域は表示されません。Chrome と Edge ではTypeError: Cannot convert undefined or null to objectと表示されます - テーマを選ぶと、AI SEARCH はテーマの CSS(
theme1.cssなど)を読み込みます。読み込まないように設定することはできません
長い回答の折りたたみ(theme2)¶
theme2 では、回答と参照リンクを合わせた表示の高さが contentMaxHeight で指定した高さを超えると、回答を折りたたんで、展開ボタンを表示します。折りたたむ高さとボタンの固定メッセージは、設定タグの extraThemeConf で変えます。
| 項目 | 内容 | 初期値 | 設定できる値 |
|---|---|---|---|
contentMaxHeight |
折りたたんだときの高さ(px) | 120 |
0 より大きい数値。"200px" のような文字列は指定できません |
showMoreButtonText |
折りたたんでいるときのボタンの固定メッセージ | もっと見る |
空でない文字列 |
showLessButtonText |
開いているときのボタンの固定メッセージ | 閉じる |
空でない文字列 |
<script>
window.aisConf = window.aisConf || [];
window.aisConf.push({
uid: "[サービスの ID]",
promptId: "[プロンプトの ID]",
insertSelector: "[表示領域を置く要素の CSS セレクタ]",
inputSelector: "[検索ボックスの CSS セレクタ]",
theme: "theme2",
headerText: "[見出しの固定メッセージ]",
extraThemeConf: {
contentMaxHeight: 200,
showMoreButtonText: "続きを読む",
},
});
</script>
extraThemeConfに記述しなかった項目は、初期値が適用されます。extraThemeConfを書かない場合は、3 項目とも初期値になります- 折りたたみの対象は、回答の表示中と表示完了後です。検索キーワードがないとき、回答を作っている間、回答を取得できなかったとき、サービスを利用できないときの固定メッセージは折りたたみません
- 回答が
contentMaxHeightの高さに収まる場合は、ボタンを表示しません - 折りたたみ中は、回答の下端にぼかし表示を適用します
- ボタンの固定メッセージには HTML を記述できません。記述したタグは、テキストとしてそのまま表示されます
extraThemeConf の記述誤り時に表示されるメッセージ¶
extraThemeConf に書き間違いがあると、ブラウザのコンソールに次のメッセージが出て、表示領域は表示されません。
| メッセージ | 原因 | 直し方 |
|---|---|---|
Invalid extraThemeConf for theme: [テーマ名] |
default または theme1 で extraThemeConf を記述した。theme を書かずに extraThemeConf を書いた場合も出ます |
theme: "theme2" を記述するか、extraThemeConf を削除します |
Unknown property '[項目名]' in extraThemeConf for theme: theme2 |
extraThemeConf に、長い回答の折りたたみ(theme2)の表にない項目を書いた |
項目名の綴りを、表と照合して修正します |
Invalid value for [項目名] in extraThemeConf for theme: theme2 |
値が項目の決まりに合わない(contentMaxHeight に文字列や 0 を書いた、ボタンの固定メッセージに空の文字列 "" を書いたなど) |
値を表の「設定できる値」に合わせて修正します |
[テーマ名] と [項目名] には、書いたテーマの名前と項目の名前が入ります。項目名を書き間違えたときの Unknown parameter と、theme に文字列以外の値や空の文字列("")を書いたときの Invalid value for theme は、タグの設置 › 記述誤り時に表示されるメッセージにあります。テーマ名の綴りを誤った場合のエラーは、テーマの指定にあります。
確認方法¶
- 検索結果ページを、検索キーワードを付けて開きます(例:
https://example.com/search?q=[サイトの内容に関わるキーワード]) - 表示領域がテーマの違いの表のとおりの見た目になっていることを確かめます
- ブラウザの開発者ツールで表示領域の要素を選び、class 名に
gn-ais-[テーマ名](例:gn-ais-theme2)があることを確認します - theme2 の場合は、長い回答が生成されるキーワードで検索し、回答が折りたたまれることと、ボタンで開いたり閉じたりできることを確かめます
設定上の制限と回避方法¶
| 制限事項 | 回避方法 |
|---|---|
| 3 つ以外のテーマを使う | 近いテーマを選択し、サイトの CSS による調整の方法で見た目を変更します |
| default と theme1 で、長い回答を折りたたむ | theme2 を選びます |
| テーマの CSS を読み込まないようにする | 見た目をサイトの CSS で一から作る場合は、背景や枠の指定がない default を選び、サイトの CSS による調整の方法で上書きします |