FAQウィジェット カスタマイズドキュメント

仕組みと読み込み方法

FAQウィジェットは script タグ読み込み後に FAQ 本体を自動挿入します。既存レイアウトのフローに沿って表示されるため、企業サイトにも馴染みやすい構造です。

<script src="https://aifaq.jp/widget.js"></script>

/* 上書きCSSは自社CSSに追加 */
.aifaq-card { max-width: 760px; }

挿入位置の指定

自動挿入モード（デフォルト・初心者向け）

ページ内に .aifaq-card が存在しない場合、script タグの直後に FAQ が自動挿入されます。追加の HTML は不要です。

<!-- script を置いた場所に FAQ が自動表示される -->
<script src="https://aifaq.jp/widget.js"></script>

手動配置モード（上級者向け）

FAQ を特定の場所に表示したい場合は、表示したい位置に <div class="aifaq-card"></div> を配置してください。.aifaq-card が存在する場合、自動生成は行わずその要素に描画します。

<!-- FAQを表示したい場所に配置 -->
<div class="aifaq-card"></div>

<!-- script はどこに置いてもOK（bodyの末尾推奨） -->
<script src="https://aifaq.jp/widget.js"></script>

全体レイアウト

FAQ Widget
    ├─ .aifaq-card（全体の枠）
    │   ├─ .aifaq-item（1つのQAブロック）
    │   │   ├─ .aifaq-question（質問）
    │   │   │   ├─ .aifaq-icon（＋／−）
    │   │   │   └─ .aifaq-qtext（Q1. 質問文）
    │   │   └─ .aifaq-answer（A1. 回答文）
    │   ├─ .aifaq-item（2つ目）
    │   └─ ...

.aifaq-card は FAQ 全体のコンテナです。余白・枠線・横幅を調整するとページ上の存在感を制御できます。

.aifaq-card {
  background: #fff;
  border: 1px solid #e5e7eb;
  border-radius: 8px;
  padding: 32px;
  max-width: 860px;
}

.aifaq-card {
  max-width: 920px;
  padding: 36px;
}

質問のデザイン

.aifaq-question はユーザーが最初に読む要素です。太さ・間隔・ホバー色を設定します。

.aifaq-question {
  font-weight: 600;
  line-height: 1.4;
  padding: 10px 0;
}
.aifaq-question:hover { color: #2563eb; }

.aifaq-question {
  font-size: 18px;
  letter-spacing: 0.01em;
}

回答のデザイン

.aifaq-answer の行間とインデントを調整して、Q/Aの関係を明瞭にします。

.aifaq-answer {
  margin-left: 20px;
  margin-top: 6px;
  line-height: 1.8;
}

.aifaq-answer {
  color: #374151;
  line-height: 1.9;
}

アイコン変更

.aifaq-icon は開閉状態の視認性に影響します。左寄せ固定幅で揃えると見やすくなります。

.aifaq-icon {
  width: 20px;
  display: inline-block;
  text-align: center;
}

.aifaq-icon {
  color: #6b7280;
  font-size: 16px;
}

余白・行間

余白の基準をそろえると一気に見た目が整います。SaaS標準は 24px から 32px が目安です。

.aifaq-card { padding: 32px; }
.aifaq-item + .aifaq-item { margin-top: 28px; }
.aifaq-answer { line-height: 1.8; }

.aifaq-card { padding: 36px; }
.aifaq-item + .aifaq-item { margin-top: 30px; }

カラーテーマ

ブランドカラーに合わせる場合は、ホバー色とカード境界色をセットで変えると統一感が出ます。

.aifaq-question:hover { color: #2563eb; }

.aifaq-question:hover { color: #ff6600; }
.aifaq-card { border-color: #ffd9bf; }

ダークモード

ダークモード対応では背景色・文字色・境界線をまとめて定義します。

@media (prefers-color-scheme: dark) {
  .aifaq-card {
    background: #111827;
    color: #f3f4f6;
    border-color: #374151;
  }
}

@media (prefers-color-scheme: dark) {
  .aifaq-question:hover { color: #93c5fd; }
}

Advanced

完全上書きの方法

.aifaq-card,
.aifaq-item,
.aifaq-question,
.aifaq-answer,
.aifaq-icon {
  /* fully override */
}

CSS変数によるテーマ化

:root {
  --faq-border: #e5e7eb;
  --faq-accent: #2563eb;
}
.aifaq-card { border-color: var(--faq-border); }

独自アニメーションの追加

.aifaq-answer {
  transition: opacity 0.25s ease, transform 0.25s ease;
}
.aifaq-answer.open {
  transform: translateY(0);
}

Examples

ブランドカラー適用例

.aifaq-question:hover { color: #e11d48; }

ミニマルデザイン例

.aifaq-card {
  border: none;
  padding: 0;
}

企業サイト向け例

.aifaq-card { border-radius: 10px; }
.aifaq-question { font-size: 17px; }

Web制作会社向けテンプレ

.aifaq-question:hover { color: var(--brand-color, #2563eb); }
.aifaq-answer { line-height: 1.85; }

POST /api/generate-faq
      Content-Type: application/json

      {
        "domain": "example.com",
        "plan": "standard",
        "must_include_urls": [
          "https://example.com/about",
          "https://example.com/pricing",
          "https://example.com/?tab=contact"
        ]
      }

{
        "question": "料金プランについて詳しく教えてください。",
        "answer": "スタンダードプランは月額〇〇円で…\n詳細はこちら: https://example.com/pricing",
        "sourceUrl": "https://example.com/pricing"
      }