インスタンスメソッド

方法概要

破壊()

iframeを削除し、リスナーをクリアし、現在のインスタンスに対して一度だけ破壊を放出します。

widget.destroy()

getState()

ウィジェットインスタンスの現在のライフサイクル状態を読みます。

const state = widget.getState()

返す値は読み込み、認証、準備済み、エラー、破壊などが含まれます。

whenReady()

iframeの初期化が終わるまで待ってから、依存するUIロジックを実行してください。

await widget.whenReady()

setSymbol(シンボル)

iframe内の取引ペアを切り替えます。iframeがまだ初期化中であれば、 SDK はコマンドをキューに入れて準備完了後に送信します。

widget.setSymbol('ETHUSDT')

setTheme(テーマ)

埋め込みトレーディングiframeで使われているテーマパラメータを更新してください。

widget.setTheme('dark')
widget.setTheme('light')

setLocale(地域)

iframe言語を切り替えてください。対応値はen、en-us、zh-CNです。

widget.setLocale('en')
widget.setLocale('en-US')
widget.setLocale('zh-CN')

setSize(幅、高さ)

iframeの DOM サイズを更新し、新しい外側サイズをiframeに通知します。数値値はpxに変換されます。

widget.setSize('100%', 720)

リロード()

現在のiframeをリロードして、再度初期化されるのを待ちます。

widget.reload()

refreshAuth(理由)

iframeに現在の認証フローを更新するよう依頼します。オプションの理由値はログ記録とフロー制御のために転送されます。

widget.refreshAuth('manual')

setTokenProvider(プロバイダー)

パートナートークンモードで使われていた tokenProvider を置き換えます。 SDK はiframeが新しい埋め込みトークンを要求するとプロバイダーに呼び出します。

widget.setTokenProvider(async ({ channelId, symbol, reason }) => {
  const resp = await fetch('/api/trading/embed-token', {
    method: 'POST',
    credentials: 'include',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ channelId, symbol, reason }),
  })
  return resp.json()
})

on(イベント、ハンドラー)

ランタイムイベントにサブスクライブします。返される関数はリスナーを削除します。

const off = widget.on('order_created', (event) => {
  console.log(event)
})
off()

関連ウィジェットガイド

• Trading Widget クイックスタート
• オプションとイベント
• 認証
• トラブルシューティング