Методи екземплярів

Короткий виклад методу

Знищити()

Видаліть iframe, очистите слухачі і випустіть знищений один раз для поточного інстансу.

1
widget.destroy()

getState()

Прочитайте поточний життєвий цикл екземпляра віджета.

1
const state = widget.getState()

Повернені значення включають завантаження, автентифікацію, готовність, помилку та знищення.

whenReady()

Зачекайте, поки iframe завершить ініціалізацію, перш ніж запускати логіку залежного інтерфейсу.

1
await widget.whenReady()

setSymbol(символ)

Поміняйте торгову пару всередині iframe. Якщо iframe ще ініціалізується, SDK ставить команду в чергу і надсилає її після готовності.

1
widget.setSymbol('ETHUSDT')

setTheme(тема)

Оновіть параметр теми, який використовується вбудованим торговим iframe.

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

setLocale(локація)

Поміняй мову iframe. Підтримувані значення — en, en-US та zh-CN.

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

setSize(ширина, висота)

Оновіть розмір iframe DOM та повідомте iframe про новий зовнішній розмір. Числові значення конвертуються у px.

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

reload()

Перезавантажте поточний iframe і чекайте, поки він знову ініціалізується.

1
widget.reload()

refreshAuth(причина)

Попросіть iframe оновити поточний потік автентифікації. Опціональне значення причини пересилається для логування та керування потоком.

1
widget.refreshAuth('manual')

setTokenProvider(постачальник)

Замініть tokenProvider в режимі партнера-токена. SDK викликає провайдера, коли iframe запитує свіжий токен embed.

1
widget.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 (подія, куратор)

Підпишіться на подію під час виконання. Повернена функція видаляє слухача.

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

Пов’язані посібники з віджетів

• Trading Widget Швидкий старт
• Опції та події
• Автентифікація
• Усунення несправностей