Métodos de instancia

Controla una instancia de widget creada después de TradingWidget.create().

Ver como Markdown

Resumen del método

MétodoPropósito
destruir()Quita el iframe y libera a los oyentes del evento.
getState()Lee el estado actual del ciclo de vida SDK .
whenReady()Espera hasta que el iframe termine de inicializarse.
setSymbol(símbolo)Cambia el par de trading dentro del iframe.
setTheme(tema)Actualiza el parámetro de tema de iframe.
setLocale(lugar)Cambia el idioma del iframe.
setSize(ancho, alto)Actualizar las dimensiones del iframe.
reload()Recarga el iframe actual.
refreshAuth(razón)Activa el flujo de actualización de autenticación del widget.
setTokenProvider(proveedor)Reemplaza el proveedor usado por el modo partner-token.
encendido (evento, manejador)Suscríbete a eventos de ejecución y recibe una función de cancelación de suscripción.

destruir()

Quita el iframe, limpia los oyentes y emite destruido una vez para la instancia actual.

1widget.destroy()

getState()

Lee el estado actual del ciclo de vida de la instancia del widget.

1const state = widget.getState()

Los valores de retorno incluyen carga, autenticación, listo, error y destruido.

whenReady()

Espera a que el iframe termine de inicializar antes de ejecutar la lógica de la interfaz dependiente.

1await widget.whenReady()

setSymbol(símbolo)

Cambia el par de trading dentro del iframe. Si el iframe sigue inicializándose, el SDK pone el comando en cola y lo envía después de ready.

1widget.setSymbol('ETHUSDT')

setTheme(tema)

Actualiza el parámetro de tema usado por el iframe de trading embebido.

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

setLocale(lugar)

Cambia el idioma del iframe. Los valores soportados son en, en-US y zh-CN.

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

setSize(ancho, alto)

Actualiza el iframe DOM tamaño y notifica al iframe sobre el nuevo tamaño exterior. Los valores numéricos se convierten a px.

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

reload()

Recarga el iframe actual y espera a que se inicialice de nuevo.

1widget.reload()

refreshAuth(razón)

Pide al iframe que actualice el flujo de autenticación actual. El valor de razón opcional se envía para registro y control de flujo.

1widget.refreshAuth('manual')

setTokenProvider(proveedor)

Reemplaza el tokenProvider usado por el modo token-partner. El SDK llama al proveedor cuando el iframe solicita un token de embed nuevo.

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})

encendido (evento, manejador)

Suscríbete a un evento en tiempo real. La función devuelta elimina al oyente.

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