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

Резюме методу

знищити()

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

widget.destroy()

getState()

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

const state = widget.getState()

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

whenReady()

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

await widget.whenReady()

setSymbol(символ)

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

widget.setSymbol('ETHUSDT')

setTheme(тема)

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

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

setLocale(локаль)

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

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

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

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

widget.setSize('100%', 720)

перезавантажити()

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

widget.reload()

refreshAuth(причина)

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

widget.refreshAuth('manual')

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

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

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

on(подія, обробник)

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

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

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

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

Додаткові методи в поточній версії 1

Для зміни користувацького або реального/демонстраційного середовища знищіть старий екземпляр і створіть новий із цільовою автентифікацією та режимом. Не використовуйте setPage як перемикач середовища. Перевірте можливості перед використанням додаткових методів.

if (TradingWidget.capabilities.methods.includes('whenRendered')) {
  await widget.whenRendered();
}
if (TradingWidget.capabilities.pages.includes('up-down')) {
  widget.setPage('up-down');
}