ドキュメント

TicketsX をもっと早く使いこなす

セットアップ手順、コマンドの完全リファレンス、Premium 機能、REST API がひとつにまとまっています。

14.3

フレームワーク別のスニペット

ウィジェットは script タグひとつなので、どこにでも入ります。よく聞かれる三つの構成について、そのままの形を載せます。wk_your_key_here はウィジェットカードのキーに置き換えてください。

HTML

<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>

React

import { useEffect } from 'react'

export function TicketsXChat() {
  useEffect(() => {
    const script = document.createElement('script')
    script.src = 'https://api.ticketsx.xyz/widget.js'
    script.dataset.key = 'wk_your_key_here'
    script.defer = true
    document.body.appendChild(script)

    return () => {
      script.remove()
      window.TicketsXChat?.destroy()
    }
  }, [])

  return null
}

このコンポーネントはアプリのルート付近で一度だけレンダーしてください。クリーンアップでスクリプトを外し、アンマウント時にウィジェットを終了します。

Next.js

import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://api.ticketsx.xyz/widget.js"
          data-key="wk_your_key_here"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

こちらは App Router です。Script タグをルートレイアウトに置くと、ページ遷移してもウィジェットが残ります。

どれを使っても、読み込むスクリプトは同じです。ウィジェットは shadow root 内に描画されるので、サイトのスタイルにもバンドルにも触れません。