Μετάβαση στην πλοήγηση

Παράδειγμα Μέθοδοι

Ελέγξτε ένα στιγμιότυπο γραφικού στοιχείου που δημιουργήθηκε μετά το TradingWidget.create().

Προβολή ως Markdown

Περίληψη Μεθόδου

ΜέθοδοςΣκοπός
καταστρέφω()Καταργήστε τα iframe και απελευθερώστε τα προγράμματα ακρόασης συμβάντων.
getState()Διαβάστε την τρέχουσα κατάσταση του κύκλου ζωής SDK.
whenReady()Περιμένετε μέχρι να ολοκληρωθεί η προετοιμασία του iframe.
setSymbol(σύμβολο)Αλλάξτε το ζεύγος συναλλαγών μέσα στο iframe.
setTheme(θέμα)Ενημερώστε την παράμετρο θέματος iframe.
setLocale(τοπική τοποθεσία)Αλλάξτε τη γλώσσα iframe.
setSize(πλάτος, ύψος)Ενημέρωση διαστάσεων iframe.
γεμίζω πάλι()Επαναφόρτωση του τρέχοντος iframe.
refreshAuth(λόγος)Ενεργοποιήστε τη ροή ανανέωσης ελέγχου ταυτότητας γραφικού στοιχείου.
setTokenProvider(πάροχος)Αντικαταστήστε τον πάροχο που χρησιμοποιείται από τη λειτουργία διακριτικού συνεργάτη.
on (γεγονός, χειριστής)Εγγραφείτε σε συμβάντα χρόνου εκτέλεσης και λάβετε μια λειτουργία κατάργησης εγγραφής.

καταστρέφω()

Αφαιρέστε το 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 για το νέο εξωτερικό μέγεθος. Οι αριθμητικές τιμές μετατρέπονται σε 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()

Σχετικοί οδηγοί γραφικών στοιχείων

Πρόσθετες μέθοδοι στον τρέχοντα χρόνο εκτέλεσης v1

ΜέθοδοςΣκοπός
whenRendered()Περιμένετε για την ειδοποίηση απόδοσης του iframe. αυτό είναι ξεχωριστό από το έτοιμο.
setPage(page)Ζητήστε μια υποστηριζόμενη σελίδα προϊόντος στην τρέχουσα περίπτωση. Δεν αλλάζει το περιβάλλον των κεφαλαίων.
prepareForRecreate()Ζητήστε από ένα έτοιμο iframe για να προετοιμαστείτε για αντικατάσταση. επιστρέφει μια υπόσχεση και μπορεί να απορρίψει εάν δεν είναι διαθέσιμη, απασχολημένη ή έχει λήξει.
cancelRecreate()Ακυρώστε μια ροή αντικατάστασης σε εκκρεμότητα/έτοιμο.
TradingWidget.validateOptions(options)Επικυρώστε τις επιλογές προετοιμασίας πριν δημιουργήσετε μια παρουσία.

Για αλλαγή περιβάλλοντος χρήστη ή πραγματικού/επίδειξης, καταστρέψτε την παλιά παρουσία και δημιουργήστε μια νέα με τον έλεγχο ταυτότητας και τη λειτουργία προορισμού. Μην χρησιμοποιείτε το setPage ως διακόπτη περιβάλλοντος. Ελέγξτε τις δυνατότητες πριν χρησιμοποιήσετε προαιρετικές μεθόδους.

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