Instanzmethoden | 6MM Docs

Zusammenfassung der Methode

Verfahren	Zweck
zerstören()	Entfernen Sie den Iframe und geben Sie Ereignis-Listener frei.
getState()	Lesen Sie den aktuellen Lebenszyklusstatus SDK.
whenReady()	Warten Sie, bis der Iframe die Initialisierung abgeschlossen hat.
setSymbol(Symbol)	Tauschen Sie das Handelspaar innerhalb des Iframes.
setTheme(Thema)	Aktualisieren Sie den Iframe-Designparameter.
setLocale(Gebietsschema)	Wechseln Sie die Iframe-Sprache.
setSize(Breite, Höhe)	Iframe-Abmessungen aktualisieren.
neu laden()	Laden Sie den aktuellen Iframe neu.
refreshAuth(Grund)	Lösen Sie den Aktualisierungsfluss für die Widget-Authentifizierung aus.
setTokenProvider(Anbieter)	Ersetzen Sie den verwendeten Anbieter durch den Partner-Token-Modus.
on(Ereignis, Handler)	Abonnieren Sie Laufzeitereignisse und erhalten Sie eine Abmeldefunktion.

zerstören()

Entfernen Sie den Iframe, löschen Sie die Listener und geben Sie die Funktion „zerstört“ einmal für die aktuelle Instanz aus.

widget.destroy()

getState()

Lesen Sie den aktuellen Lebenszyklusstatus der Widget-Instanz.

const state = widget.getState()

Zu den Rückgabewerten gehören „Laden“, „Authentifizierung“, „Bereit“, „Fehler“ und „Zerstört“.

whenReady()

Warten Sie, bis der Iframe die Initialisierung abgeschlossen hat, bevor Sie die abhängige UI-Logik ausführen.

await widget.whenReady()

setSymbol(Symbol)

Tauschen Sie das Handelspaar innerhalb des Iframes. Wenn der Iframe noch initialisiert wird, stellt SDK den Befehl in die Warteschlange und sendet ihn nach der Fertigstellung.

widget.setSymbol('ETHUSDT')

setTheme(Thema)

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

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

setLocale(Gebietsschema)

Wechseln Sie die Iframe-Sprache. Unterstützte Werte sind en, en-US und zh-CN.

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

setSize(Breite, Höhe)

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

widget.setSize('100%', 720)

neu laden()

Laden Sie den aktuellen Iframe neu und warten Sie, bis er erneut initialisiert wird.

widget.reload()

refreshAuth(Grund)

Bitten Sie den Iframe, den aktuellen Authentifizierungsfluss zu aktualisieren. Der optionale Grundwert wird zur Protokollierung und Flusskontrolle weitergeleitet.

widget.refreshAuth('manual')

setTokenProvider(Anbieter)

Ersetzen Sie das vom Partner-Token-Modus verwendete tokenProvider. Der SDK ruft den Anbieter auf, wenn der Iframe ein neues Einbettungstoken anfordert.

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(Ereignis, Handler)

Abonnieren Sie ein Laufzeitereignis. Die zurückgegebene Funktion entfernt den Listener.

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

Zusätzliche Methoden in der aktuellen v1-Laufzeit

Verfahren	Zweck
`whenRendered()`	Warten Sie auf die gerenderte Benachrichtigung des Iframes. Dies ist von „ready“ zu unterscheiden.
`setPage(page)`	Fordern Sie in der aktuellen Instanz eine unterstützte Produktseite an. Es ändert nichts an der Fondsumgebung.
`prepareForRecreate()`	Bitten Sie einen fertigen Iframe, den Austausch vorzubereiten. gibt ein Versprechen zurück und kann es ablehnen, wenn es nicht verfügbar, ausgelastet oder abgelaufen ist.
`cancelRecreate()`	Brechen Sie einen ausstehenden/vorbereiteten Ersatzfluss ab.
`TradingWidget.validateOptions(options)`	Überprüfen Sie die Initialisierungsoptionen, bevor Sie eine Instanz erstellen.

Bei einer Änderung des Benutzers oder der realen/Demo-Umgebung zerstören Sie die alte Instanz und erstellen Sie eine neue mit der Zielauthentifizierung und dem Zielmodus. Verwenden Sie setPage nicht als Umgebungsschalter. Überprüfen Sie die Fähigkeiten, bevor Sie optionale Methoden verwenden.

if (TradingWidget.capabilities.methods.includes('whenRendered')) {
  await widget.whenRendered();
}
if (TradingWidget.capabilities.pages.includes('up-down')) {
  widget.setPage('up-down');
}