인스턴스 메서드

방법 요약

파괴()

iframe을 제거하고, 리스너를 정리한 뒤, 현재 인스턴스에 대해 한 번 파괴된 것을 방출하세요.

1
widget.destroy()

getState()

위젯 인스턴스의 현재 라이프사이클 상태를 읽으세요.

1
const state = widget.getState()

반환 값에는 loading, authenticating, ready, error, destroyed 등이 포함됩니다.

whenReady()

iframe이 초기화를 마칠 때까지 기다린 후 의존형 UI 로직을 실행하세요.

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 를 대체합니다. iframe이 새 임베드 토큰을 요청하면 SDK 제공자에게 호출합니다.

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

온(이벤트, 핸들러)

런타임 이벤트에 구독하세요. 반환된 함수는 리스너를 제거합니다.

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

관련 위젯 가이드

• Trading Widget 퀵 스타트
• 옵션 및 이벤트
• 인증
• 문제 해결