Phương thức sơ thẩm

Tóm tắt phương pháp

hủy hoại()

Xóa iframe, xóa trình nghe và phát ra bị hủy một lần cho phiên bản hiện tại.

widget.destroy()

getState()

Đọc trạng thái vòng đời hiện tại của phiên bản widget.

const state = widget.getState()

Các giá trị trả về bao gồm tải, xác thực, sẵn sàng, lỗi và bị hủy.

whenReady()

Đợi iframe hoàn tất quá trình khởi tạo trước khi chạy logic giao diện người dùng phụ thuộc.

await widget.whenReady()

setSymbol(ký hiệu)

Chuyển đổi cặp giao dịch bên trong iframe. Nếu iframe vẫn đang khởi tạo, SDK sẽ xếp hàng lệnh và gửi nó sau khi sẵn sàng.

widget.setSymbol('ETHUSDT')

setTheme(chủ đề)

Cập nhật tham số chủ đề được sử dụng bởi iframe giao dịch được nhúng.

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

setLocale(ngôn ngữ)

Chuyển đổi ngôn ngữ iframe. Các giá trị được hỗ trợ là en, en-US và zh-CN.

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

setSize(chiều rộng, chiều cao)

Cập nhật kích thước iframe DOM và thông báo cho iframe về kích thước bên ngoài mới. Giá trị số được chuyển đổi thành px.

widget.setSize('100%', 720)

tải lại()

Tải lại iframe hiện tại và đợi nó khởi chạy lại.

widget.reload()

refreshAuth(lý do)

Yêu cầu iframe làm mới luồng xác thực hiện tại. Giá trị lý do tùy chọn được chuyển tiếp để ghi nhật ký và kiểm soát luồng.

widget.refreshAuth('manual')

setTokenProvider(nhà cung cấp)

Thay thế tokenProvider được sử dụng bởi chế độ mã thông báo đối tác. SDK gọi nhà cung cấp khi iframe yêu cầu mã thông báo nhúng mới.

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(sự kiện, trình xử lý)

Đăng ký một sự kiện thời gian chạy. Hàm trả về sẽ loại bỏ trình nghe.

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

Hướng dẫn Widget liên quan

• Trading Widget Bắt đầu nhanh
• Tùy chọn & Sự kiện
• Xác thực
• Khắc phục sự cố

Các phương thức bổ sung trong thời gian chạy v1 hiện tại

Để thay đổi môi trường người dùng hoặc môi trường thực/demo, hãy hủy phiên bản cũ và tạo một phiên bản mới với chế độ và xác thực đích. Không sử dụng setPage làm công tắc môi trường. Kiểm tra khả năng trước khi sử dụng các phương pháp tùy chọn.

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