# デザインの選択

設定タグの `theme` にテーマ名を書くと、表示領域のデザインを default、theme1、theme2 の 3 つから選べます。

| 項目 | 内容 |
| --- | --- |
| 対象者 | タグを設置する方（エンジニア、制作会社） |
| ページの概要 | 表示領域のデザインを 3 つのテーマから選択できます。theme2 では、長い回答を折りたためます |
| 前提条件 | [タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)の手順で、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` も記述してください。書き方は「[固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/#options>)」を参照してください。

## テーマの指定

[タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)で書いた設定タグに `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 項目](<https://docs.geniee-search.net/aisearch/install/tag/#required-parameters>)で説明している値です。

- テーマ名は小文字で書きます。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）](<#collapse>)の表にない項目を書いた | 項目名の綴りを、表と照合して修正します |
| `Invalid value for [項目名] in extraThemeConf for theme: theme2` | 値が項目の決まりに合わない（`contentMaxHeight` に文字列や 0 を書いた、ボタンの固定メッセージに空の文字列 `""` を書いたなど） | 値を表の「設定できる値」に合わせて修正します |

`[テーマ名]` と `[項目名]` には、書いたテーマの名前と項目の名前が入ります。項目名を書き間違えたときの `Unknown parameter` と、`theme` に文字列以外の値や空の文字列（`""`）を書いたときの `Invalid value for theme` は、[タグの設置 › 記述誤り時に表示されるメッセージ](<https://docs.geniee-search.net/aisearch/install/tag/#errors>)にあります。テーマ名の綴りを誤った場合のエラーは、[テーマの指定](<#how-to>)にあります。

## 確認方法

1. 検索結果ページを、検索キーワードを付けて開きます（例: `https://example.com/search?q=[サイトの内容に関わるキーワード]`）
2. 表示領域が[テーマの違い](<#themes>)の表のとおりの見た目になっていることを確かめます
3. ブラウザの開発者ツールで表示領域の要素を選び、class 名に `gn-ais-[テーマ名]`（例: `gn-ais-theme2`）があることを確認します
4. theme2 の場合は、長い回答が生成されるキーワードで検索し、回答が折りたたまれることと、ボタンで開いたり閉じたりできることを確かめます

## 設定上の制限と回避方法

| 制限事項 | 回避方法 |
| --- | --- |
| 3 つ以外のテーマを使う | 近いテーマを選択し、[サイトの CSS による調整](<https://docs.geniee-search.net/aisearch/install/appearance/css/index.md>)の方法で見た目を変更します |
| default と theme1 で、長い回答を折りたたむ | theme2 を選びます |
| テーマの CSS を読み込まないようにする | 見た目をサイトの CSS で一から作る場合は、背景や枠の指定がない default を選び、[サイトの CSS による調整](<https://docs.geniee-search.net/aisearch/install/appearance/css/index.md>)の方法で上書きします |

## 関連ページ

- [固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/index.md>)
- [サイトの CSS による調整](<https://docs.geniee-search.net/aisearch/install/appearance/css/index.md>)
- [タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)
- [表示の確認](<https://docs.geniee-search.net/aisearch/install/verify/index.md>)
- [パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)
- [表示されない場合・表示に異常がある場合](<https://docs.geniee-search.net/aisearch/troubleshooting/display/index.md>)
