Методы экземпляров

Краткое содержание метода

уничтожить()

Удалите 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)

Перезарядка()

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

1
widget.reload()

refreshAuth(причина)

Попросите iframe обновить текущий поток аутентификации. Необязательное значение причины пересылается для логирования и управления потоком.

1
widget.refreshAuth('manual')

setTokenProvider(провайдер)

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

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 Быстрый старт
• Опции и события
• Аутентификация
• Устранение неполадок