Trading Widget

Méthodes d’instance

Contrôlez une instance de widget créée après TradingWidget.create().

Afficher en Markdown

Résumé de la méthode

MéthodeObjectif
détruire()Retirez l’iframe et libérez les auditeurs de l’événement.
getState()Lisez l’état actuel du cycle de vie SDK .
whenReady()Attendez que l’iframe termine son initialisation.
setSymbol(symbole)Inversez la paire de trading à l’intérieur de l’iframe.
setTheme(thème)Mettez à jour le paramètre thème de l’iframe.
setLocale(localisation)Changez le langage de l’iframe.
setSize(largeur, hauteur)Mettez à jour les dimensions de l’iframe.
recharge()Rechargez l’iframe actuel.
refreshAuth(raison)Déclenche le flux de rafraîchissement de l’authentification du widget.
setTokenProvider(fournisseur)Remplacez le fournisseur utilisé par le mode partner-token.
On (événement, manipulateur)Abonnez-vous aux événements d’exécution et recevez une fonction de désabonnement.

détruire()

Retirez l’iframe, nettoyez les auditeurs, et envoyez détruit une fois pour l’instance actuelle.

1widget.destroy()

getState()

Lisez l’état actuel du cycle de vie de l’instance du widget.

1const state = widget.getState()

Les valeurs de retour incluent chargement, authentification, prêt, erreur et destruction.

whenReady()

Attends que l’iframe termine son initialisation avant d’exécuter la logique d’interface dépendante.

1await widget.whenReady()

setSymbol(symbole)

Inversez la paire d’échanges à l’intérieur de l’iframe. Si l’iframe est encore en train d’initialiser, le SDK met la commande en file d’attente et l’envoie après ready.

1widget.setSymbol('ETHUSDT')

setTheme(thème)

Mettez à jour le paramètre thème utilisé par l’iframe de trading intégré.

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

setLocale(localisation)

Changez le langage de l’iframe. Les valeurs prises en charge sont en, en-US et zh-CN.

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

setSize(largeur, hauteur)

Mettez à jour la taille DOM l’iframe et informez l’iframe de la nouvelle taille extérieure. Les valeurs numériques sont converties en px.

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

recharge()

Rechargez l’iframe actuel et attendez qu’il s’initialise à nouveau.

1widget.reload()

refreshAuth(raison)

Demandez à l’iframe de rafraîchir le flux d’authentification actuel. La valeur de raison optionnelle est transmise pour la journalisation et le contrôle du flux.

1widget.refreshAuth('manual')

setTokenProvider(fournisseur)

Remplacez le tokenProvider utilisé par le mode partner-token. Le SDK appelle le fournisseur lorsque l’iframe demande un nouvel ajout.

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 (événement, manipulateur)

Abonnez-vous à un événement d’exécution. La fonction retournée supprime l’écouteur.

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