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()Elimina el iframe y libera a los oyentes del evento.
getState()Lee el estado actual del ciclo de vida SDK .
whenReady()Espera a 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(localidad)Cambia el idioma del iframe.
setSize(ancho, altura)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)Sustituye al proveedor utilizado por el modo partner-token.
En (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 que usa el iframe de trading embebido.

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

setLocale(localidad)

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, altura)

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 el registro y el control de flujo.

1widget.refreshAuth('manual')

setTokenProvider(proveedor)

Sustituye el tokenProvider usado por el modo de token de socio. 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})

En (evento, manejador)

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

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