طرق المثيل

ملخص الطريقة

تدمير ()

قم بإزالة إطار iframe، ومسح المستمعين، ثم قم بتدمير الإصدار مرة واحدة للمثيل الحالي.

widget.destroy()

getState()

اقرأ حالة دورة الحياة الحالية لمثيل عنصر واجهة المستخدم.

const state = widget.getState()

تتضمن قيم الإرجاع التحميل والمصادقة والجاهزية والخطأ والتدمير.

whenReady()

انتظر حتى ينتهي إطار 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 بالحجم الخارجي الجديد. يتم تحويل القيم الرقمية إلى بكسل.

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

على (الحدث، المعالج)

الاشتراك في حدث وقت التشغيل. تقوم الوظيفة التي تم إرجاعها بإزالة المستمع.

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