Trading Widget

Métodos de Instância

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

Ver como Markdown

Resumo do Método

MétodoFinalidade
destruir()Remova o iframe e liberte os ouvintes do evento.
getState()Leia o estado atual do ciclo de vida SDK .
whenReady()Espere até o iframe terminar a inicialização.
setSymbol(símbolo)Troca o par de negociação dentro do iframe.
setTheme(tema)Atualize o parâmetro do tema do iframe.
setLocale(local)Muda a linguagem do iframe.
setSize(largura, altura)Atualizar as dimensões do iframe.
reload()Recarregue o iframe atual.
refreshAuth(razão)Ativar o fluxo de atualização da autenticação do widget.
setTokenProvider(fornecedor)Substitua o fornecedor usado pelo modo partner-token.
ligado (evento, handler)Subscreva eventos em tempo de execução e receba uma função de cancelar subscrição.

destruir()

Remove o iframe, limpa os ouvintes e emite destruído uma vez para a instância atual.

widget.destroy()

getState()

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

const state = widget.getState()

Os valores de retorno incluem carregar, autenticar, preparar, erro e destruir.

whenReady()

Espera que o iframe termine a inicialização antes de executar a lógica dependente da interface.

await widget.whenReady()

setSymbol(símbolo)

Troca o par de negociação dentro do iframe. Se o iframe ainda estiver a inicializar, o SDK coloca o comando em fila e envia-o depois de ready.

widget.setSymbol('ETHUSDT')

setTheme(tema)

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

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

setLocale(local)

Muda a linguagem do iframe. Os valores suportados são en, en-US e zh-CN.

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

setSize(largura, altura)

Atualiza o iframe DOM tamanho e notifica o iframe sobre o novo tamanho exterior. Os valores numéricos são convertidos para px.

widget.setSize('100%', 720)

reload()

Recarrego o iframe atual e espera que ele se inicialize novamente.

widget.reload()

refreshAuth(razão)

Pede ao iframe para atualizar o fluxo de autenticação atual. O valor opcional da razão é encaminhado para registo e controlo de fluxo.

widget.refreshAuth('manual')

setTokenProvider(fornecedor)

Substitua a tokenProvider usada pelo modo partner-token. O SDK liga ao fornecedor quando o iframe solicita um token de embed novo.

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

ligado (evento, handler)

Subscreva um evento em tempo real. A função devolvida remove o ouvinte.

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