# サイトの CSS による調整

表示領域の要素には `gn-ais` で始まる class 名が付与されています。サイトの CSS で class 名を指定すると、表示領域の色、文字サイズ、余白などを変更できます。

| 項目 | 内容 |
| --- | --- |
| 対象者 | タグを設置する方（エンジニア、制作会社） |
| ページの概要 | 表示領域の見た目を、サイトのデザインに合わせて変えられます |
| 前提条件 | [デザインの選択](<https://docs.geniee-search.net/aisearch/install/appearance/theme/index.md>)で、テーマを決めていること |

## 調整方法

1. 検索結果ページを、検索キーワードを付けて開きます
2. ブラウザの開発者ツールで、変更したい部分の要素を選択し、class 名と適用されている CSS の指定を確認します
3. サイトの CSS に、`insertSelector` の要素の id から始まるセレクタで指定を記述します。記述方法は「[テーマの CSS を優先させる設定](<#priority>)」を参照してください
4. 検索結果ページを開き直して、見た目が変更されたことを確認します

## テーマの CSS を優先させる設定

サイトの CSS は、セレクタの先頭に `insertSelector` の要素の id（例: `#ai-search`）を付けて記述します。id を含むセレクタはテーマの CSS のセレクタより優先されます。

AI SEARCH は表示領域を表示するときに、テーマの CSS（`default.css`、`theme1.css`、`theme2.css` のどれか）を `head` 要素の末尾に追加します。テーマの CSS は `.gn-ais-theme1 .gn-ais-header .gn-ais-header-title` のように class 名を連結したセレクタで記述されているため、サイトの CSS を class 名だけのセレクタで書くと、テーマの CSS が優先されることがあります。

```
/* 誤: テーマの CSS が優先される場合がある */
.gn-ais-header-title {
  background: #2a579a;
}

/* 正: insertSelector の要素の id から記述すると、サイトの CSS が優先される */
#ai-search .gn-ais-header-title {
  background: #2a579a;
}
```

- 例の `#ai-search` は `insertSelector` の要素の id に置き換えてください。`insertSelector` に class のセレクタ（`.search-area` など）を書いた場合も、class ではなく要素の id を使います。class から記述すると、テーマの CSS が優先される場合があります
- `insertSelector` の要素に id がない場合は、要素に id を付与し、その id から記述します
- 表示領域は `insertSelector` の要素の中に追加されます

## 主な class 名

| class 名 | 付いている要素 | 付くテーマ |
| --- | --- | --- |
| `gn-ais` | 表示領域の全体 | すべて |
| `gn-ais-[テーマ名]`（例: `gn-ais-theme1`） | 表示領域の全体。選んだテーマで変わります | すべて |
| `gn-ais-[状態]`（例: `gn-ais-loading`、`gn-ais-completed`） | 表示領域の全体。表示の状態で変わります | すべて |
| `gn-ais-header` | 見出し（`headerText`） | すべて |
| `gn-ais-header-title` | 見出しのラベル | theme1、theme2 |
| `gn-ais-body` | 本文（回答と、状態ごとの固定メッセージ） | すべて |
| `gn-ais-references` | 参照リンクの一覧 | すべて |
| `gn-ais-footer` | 注意書き（`footerText`） | すべて |
| `gn-ais-show-more-btn` | 長い回答を展開するボタン | theme2 |

- 回答の文章は `gn-ais-body` 内に、見出し（`h1`〜`h6`）、段落（`p`）、箇条書き（`ul`、`ol`）、リンク（`a`）などの要素として表示されます
- 表示の状態の class 名と、そのほかの class 名の一覧は、[表示領域の HTML と class 名](<https://docs.geniee-search.net/aisearch/reference/html/index.md>)にあります

## 設定例

例の `#ai-search` は `insertSelector` の要素の id に置き換えてください。色やサイズの値は、サイトに合わせて書き換えてください。

### 見出しラベルの色の変更（theme1、theme2）

```
#ai-search .gn-ais-header-title {
  background: #2a579a;
  color: #ffffff;
}
```

### 表示領域の背景の色を変える（theme1、theme2）

```
#ai-search .gn-ais {
  background: #f5f7fa;
}
```

### 回答と参照リンクのリンクの色を変える

```
#ai-search .gn-ais-body a {
  color: #2a579a;
}
```

### 本文と参照リンクの文字の大きさを変える

```
#ai-search .gn-ais-body {
  font-size: 15px;
}

#ai-search .gn-ais-references {
  font-size: 12px;
}
```

### 回答の生成中の本文の文字色の変更

```
#ai-search .gn-ais-loading .gn-ais-body {
  color: #888888;
}
```

### 長い回答を展開するボタンの色の変更（theme2）

```
#ai-search .gn-ais-show-more-btn {
  border-color: #2a579a;
  color: #2a579a;
}
```

## 確認方法

1. 検索結果ページを、検索キーワードを付けて開きます（例: `https://example.com/search?q=[サイトの内容に関わるキーワード]`）
2. 変えた部分が意図どおりの見た目になっていることを確かめます
3. 変更が反映されない場合は、ブラウザの開発者ツールで要素を選び、サイトの CSS の指定に取り消し線が引かれていないかを確認します。取り消し線が引かれている場合は、テーマの CSS が優先されています。[テーマの CSS を優先させる設定](<#priority>)のとおりに、セレクタを `insertSelector` の要素の id から書きます

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

| 制限事項 | 回避方法 |
| --- | --- |
| 固定メッセージに `class` や `style` を付与して、固定メッセージごとに見た目を変更すること | 固定メッセージの `class` と `style` は取り除かれます。`gn-ais-header` などの表示領域の class 名を使用して変更します |
| theme2 で折りたたむ高さを CSS で変更すること | 折りたたむ高さは、`extraThemeConf` の `contentMaxHeight` で変更します。書き方は「[デザインの選択 › 長い回答の折りたたみ（theme2）](<https://docs.geniee-search.net/aisearch/install/appearance/theme/#collapse>)」を参照してください |
| テーマの CSS を読み込まないようにする | 背景や枠の指定がない default を選び、サイトの CSS で上書きします |

## 関連ページ

- [デザインの選択](<https://docs.geniee-search.net/aisearch/install/appearance/theme/index.md>)
- [固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/index.md>)
- [表示領域の HTML と class 名](<https://docs.geniee-search.net/aisearch/reference/html/index.md>)
- [表示の確認](<https://docs.geniee-search.net/aisearch/install/verify/index.md>)
- [表示されない場合・表示に異常がある場合](<https://docs.geniee-search.net/aisearch/troubleshooting/display/index.md>)
