Métodos de Instância

Controle uma instância de widget criada após TradingWidget.create().

Ver como Markdown

Resumo do Método

MétodoPropósito
destruir()Remova o iframe e libere os ouvintes do evento.
getState()Leia o estado atual do ciclo de vida SDK .
whenReady()Espere até o iframe terminar de inicializar.
setSymbol(símbolo)Troque o par de negociação dentro do iframe.
setTheme(tema)Atualize o parâmetro do tema do iframe.
setLocale(localidade)Troque o idioma do iframe.
setSize(largura, altura)Atualize as dimensões do iframe.
reload()Recarregue o iframe atual.
refreshAuth(motivo)Acione o fluxo de atualização de autenticação do widget.
setTokenProvider(provedor)Substitua o provedor usado pelo modo partner-token.
ligado (evento, manipulador)Assine eventos em tempo real e receba uma função de cancelamento da inscrição.

destruir()

Remova o iframe, limpe os ouvintes e emita destruído uma vez para a instância atual.

1widget.destroy()

getState()

Leia o estado atual do ciclo de vida da instância do widget.

1const state = widget.getState()

Valores de retorno incluem carregamento, autenticação, pronto, erro e destruido.

whenReady()

Espere o iframe terminar a inicialização antes de executar a lógica dependente da interface.

1await widget.whenReady()

setSymbol(símbolo)

Troque o par de negociação dentro do iframe. Se o iframe ainda estiver inicializando, o SDK coloca o comando em fila e o envia após ready.

1widget.setSymbol('ETHUSDT')

setTheme(tema)

Atualize o parâmetro de tema usado pelo iframe de negociação embutido.

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

setLocale(localidade)

Troque o idioma do iframe. Os valores suportados são en, en-US e zh-CN.

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

setSize(largura, altura)

Atualize o tamanho do iframe DOM e avise o iframe sobre o novo tamanho externo. Os valores numéricos são convertidos para px.

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

reload()

Recarregue o iframe atual e espere ele inicializar novamente.

1widget.reload()

refreshAuth(motivo)

Peça ao iframe para atualizar o fluxo de autenticação atual. O valor opcional da razão é encaminhado para registro e controle de fluxo.

1widget.refreshAuth('manual')

setTokenProvider(provedor)

Substitua o tokenProvider usado pelo modo partner-token. O SDK chama o provedor quando o iframe solicita um token de embed novo.

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

ligado (evento, manipulador)

Assine um evento em tempo real. A função retornada remove o ouvinte.

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