Instanzmethoden

Kontrolliere eine erstellte Widget-Instanz nach TradingWidget.create().

Als Markdown anzeigen

Methodenzusammenfassung

MethodeZweck
destroy()Entferne das iframe und lasse die Event-Listener frei.
getState()Lesen Sie den aktuellen Lebenszykluszustand SDK .
whenReady()Warte, bis der iframe die Initialisierung abgeschlossen hat.
setSymbol(Symbol)Tausche das Handelspaar innerhalb des iframes.
setTheme(Thema)Aktualisiere den iframe-Theme-Parameter.
setLocale(Ort)Wechsel die iframe-Sprache.
setSize(Breite, Höhe)Aktualisiere die iframe-Maße.
Reload()Lade den aktuellen iframe neu.
refreshAuth(Grund)Löse den Widget-Auth-Refresh-Flow aus.
setTokenProvider(Anbieter)Ersetzen Sie den Anbieter, der im Partner-Token-Modus verwendet wird.
on(Event, Handler)Abonnieren Sie Laufzeitereignisse und erhalten Sie eine Abmeldungsfunktion.

destroy()

Entferne das iframe, lösche die Hörer und emittiere einmal deaktiviert für die aktuelle Instanz.

1widget.destroy()

getState()

Lesen Sie den aktuellen Lebenszykluszustand der Widget-Instanz.

1const state = widget.getState()

Rückgabewerte umfassen Laden, Authentifizierung, Bereitschaft, Fehler und Zerstörung.

whenReady()

Warte, bis der iFrame die Initialisierung abgeschlossen hat, bevor du abhängige UI-Logik ausführst.

1await widget.whenReady()

setSymbol(Symbol)

Tausche das Handelspaar innerhalb des iframes. Wenn der iframe noch initialisiert, stellt der SDK den Befehl in die Warteschlange und sendet ihn nach Ready.

1widget.setSymbol('ETHUSDT')

setTheme(Thema)

Aktualisieren Sie den Theme-Parameter, der vom eingebetteten Handels-iframe verwendet wird.

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

setLocale(Ort)

Wechsel die iframe-Sprache. Unterstützte Werte sind en, en-US und zh-CN.

1widget.setLocale('en')
2widget.setLocale('en-US')
3widget.setLocale('zh-CN')

setSize(Breite, Höhe)

Aktualisieren Sie die Größe DOM iframe und informieren Sie den iframe über die neue äußere Größe. Numerische Werte werden in px umgewandelt.

1widget.setSize('100%', 720)

Reload()

Lade den aktuellen iFrame neu und warte, bis er erneut initialisiert.

1widget.reload()

refreshAuth(Grund)

Bitten Sie den iframe, den aktuellen Authentifizierungsfluss zu aktualisieren. Der optionale Begründungswert wird für Logging und Flusskontrolle weitergeleitet.

1widget.refreshAuth('manual')

setTokenProvider(Anbieter)

Ersetzen Sie die tokenProvider im Partner-Token-Modus. Der SDK ruft den Anbieter auf, wenn der iframe ein frisches Einbettungstoken anfordert.

1widget.setTokenProvider(async ({ channelId, symbol, reason }) => {
2 const resp = await fetch('/api/trading/embed-token', {
3 method: 'POST',
4 credentials: 'include',
5 headers: { 'Content-Type': 'application/json' },
6 body: JSON.stringify({ channelId, symbol, reason }),
7 })
8
9 return resp.json()
10})

on(Event, Handler)

Abonnieren Sie ein Runtime-Event. Die zurückgegebene Funktion entfernt den Listener.

1const off = widget.on('order_created', (event) => {
2 console.log(event)
3})
4
5off()