Metode Instance

Kontrol instance widget yang dibuat setelah TradingWidget.create().

View as Markdown

Ringkasan Metode

MetodeTujuan
hancurkan()Lepaskan pendengar iframe dan rilis event.
getState()Baca status siklus hidup SDK saat ini.
whenReady()Tunggu sampai iframe selesai inisialisasi.
setSymbol(simbol)Tukar pasangan trading di dalam iframe.
setTheme(tema)Perbarui parameter tema iframe.
setLocale(lokasi)Ganti bahasa iframe.
setSize(lebar, tinggi)Perbarui dimensi iframe.
reload()Muat ulang iframe saat ini.
refreshAuth(alasan)Aktifkan alur pembaruan otentikasi widget.
setTokenProvider(penyedia)Ganti penyedia yang digunakan oleh mode token mitra.
on(event, handler)Berlangganan acara runtime dan terima fungsi berhenti berlangganan.

hancurkan()

Lepaskan iframe, hapus listener, dan emit destroyed sekali untuk instance saat ini.

1widget.destroy()

getState()

Baca status siklus hidup saat ini dari instance widget.

1const state = widget.getState()

Nilai pengembalian meliputi loading, authenticating, ready, error, dan destroyed.

whenReady()

Tunggu hingga iframe selesai inisialisasi sebelum menjalankan logika UI yang bergantung.

1await widget.whenReady()

setSymbol(simbol)

Alihkan pasangan trading di dalam iframe. Jika iframe masih dalam inisialisasi, SDK mengantrikan perintah dan mengirimkannya setelah siap.

1widget.setSymbol('ETHUSDT')

setTheme(tema)

Perbarui parameter tema yang digunakan oleh iframe trading tertanam.

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

setLocale(lokasi)

Ganti bahasa iframe. Nilai yang didukung adalah en, en-US, dan zh-CN.

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

setSize(lebar, tinggi)

Perbarui ukuran DOM iframe dan beri tahu iframe tentang ukuran luar baru. Nilai numerik dikonversi ke px.

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

reload()

Muat ulang iframe saat ini dan tunggu hingga diinisialisasi lagi.

1widget.reload()

refreshAuth(alasan)

Minta iframe untuk menyegarkan alur autentikasi saat ini. Nilai alasan opsional diteruskan untuk logging dan kontrol aliran.

1widget.refreshAuth('manual')

setTokenProvider(penyedia)

Ganti tokenProvider yang digunakan oleh mode token mitra. SDK memanggil penyedia saat iframe meminta token embed baru.

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

on(event, handler)

Berlangganan ke acara runtime. Fungsi yang dikembalikan akan menghapus listener.

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