인스턴스 메소드

방법 요약

파괴하다()

iframe을 제거하고, 리스너를 지우고, 현재 인스턴스에 대해 한 번 파괴된 항목을 내보냅니다.

widget.destroy()

getState()

위젯 인스턴스의 현재 수명 주기 상태를 읽습니다.

const state = widget.getState()

반환 값에는 로드, 인증, 준비, 오류 및 삭제가 포함됩니다.

whenReady()

종속 UI 로직을 실행하기 전에 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 빠른 시작
• 옵션 및 이벤트
• 입증
• 문제 해결

현재 v1 런타임의 추가 메서드

사용자 또는 실제/데모 환경 변경의 경우 기존 인스턴스를 삭제하고 대상 인증 및 모드를 사용하여 새 인스턴스를 생성합니다. setPage을 환경 스위치로 사용하지 마십시오. 선택적 방법을 사용하기 전에 기능을 확인하십시오.

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