Skip to main content
Cette page documente @whop/elements@1.10.0 et @whop/elements-react@1.10.0.
Depuis v1.0.0. Se monte à l’intérieur de Reporting, dans Ads. accountId et accessToken proviennent de Ads. Transmettez les props et les callbacks via les options de création ou les props React.

Données d’exemple. Ouvrir le Playground.

Props

boolean
Ce qui se passe lorsqu’un visiteur demande une modification — depuis un menu de ligne, une ligne de brouillon ou Edit ad dans l’overlay de détails. Activé par défaut : le builder de campagnes s’ouvre par-dessus la page, sur la campagne et l’étape demandées, de sorte que la modification fonctionne sans rien configurer. Désactivez-le pour gérer vous-même la modification des campagnes — rien ne s’ouvre, et la demande est renvoyée via editRequested. Par défaut : true.
string | null
N’a plus aucun effet : le tableau affiche toujours des lignes complètes. Accepté pour que les intégrations existantes continuent de fonctionner. Par défaut : null.
string[] | null
Les colonnes affichées, par nom — des colonnes standard comme impressions et roas, ainsi que les événements de pixel ajoutés par le visiteur. Si la valeur n’est pas définie, le tableau s’ouvre avec ses propres valeurs par défaut. Renvoyé en entier via columnsChanged ; stockez la liste et transmettez-la ici pour conserver la disposition. Par défaut : null.
CustomMetricDefinition[]
Des colonnes calculées à partir des chiffres déjà présents dans le tableau — une formule que vous nommez et formatez. Le tableau peut les modifier, et chaque modification est renvoyée via customMetricsChanged sous forme de nouvelle liste complète ; conservez-la et transmettez-la ici pour qu’elle persiste. Par défaut : [].
string | null
Le niveau de détail affiché dans l’onglet All, sous forme de chemin de source : null pour les racines, ext:* pour une liste de plateformes, ext:<platform>:* pour les campagnes de cette plateforme. Renvoyé via viewChanged. Par défaut : null.
string
Le filtre appliqué dans le champ de recherche de l’onglet Ads. Par défaut : "".
boolean
Indique si les campagnes en pause sont listées. Par défaut : true.
boolean
Indique si les groupes d’annonces en pause sont listés. Par défaut : true.
boolean
Indique si les annonces en pause sont listées. Par défaut : true.

Événements

Transmettez les callbacks dans les options de création ou dans les props React.

onTabChanged

L’onglet ouvert a changé. Reproduisez-le dans votre propre URL si vous voulez qu’il survive à un rechargement.
object

onFilterChanged

Le visiteur a restreint la vue — en cochant des lignes, ou en cliquant sur une campagne pour accéder à ses groupes d’annonces. Chaque surface du même handle a déjà suivi ce changement.
object

onColumnsChanged

Le visiteur a affiché ou masqué une colonne. Contient toutes les colonnes désormais affichées, standard comme événements de pixel — stockez la liste et renvoyez-la telle quelle comme columns, sinon la disposition est réinitialisée au prochain montage.
object

onCustomMetricsChanged

Le visiteur a ajouté, modifié ou supprimé une colonne calculée. Contient dans tous les cas la liste complète — stockez-la telle quelle et renvoyez-la comme customMetrics, sinon elles disparaissent au prochain montage.
object

onViewChanged

Le visiteur a modifié l’un des contrôles propres au tableau — le niveau de détail de l’onglet All, le champ de recherche, le bouton d’affichage des éléments en pause sur l’un des trois onglets. Contient tous ces contrôles, quel que soit celui qui a changé ; stockez-les et renvoyez-les comme props, sinon ils sont réinitialisés au prochain montage.
object

onSourcesChanged

Ce qu’affiche désormais l’onglet All, sous forme de chemins de source prêts à être transmis à un graphique : null en dehors de l’onglet All (publicité Whop uniquement), [] pour toutes les sources, sinon les lignes cochées ou le groupe détaillé. Chaque surface du même handle a déjà suivi ce changement.
object

onAttributionModelChanged

Le visiteur a changé le point de contact qui reçoit l’attribution, depuis le sélecteur de l’onglet All. Chaque surface du même handle a déjà recalculé l’attribution ; conservez la valeur et renvoyez-la comme attributionModel, sinon elle revient au dernier point de contact au prochain montage.
object

onLoaderStart

S’exécute après le premier affichage du squelette de chargement et avant onReady.

onReady

S’exécute après le premier affichage complet de l’élément.

onError

S’exécute lorsque l’élément ne parvient pas à se charger ou plante. L’affichage de repli reste visible. Utilisez code pour une gestion programmatique. sourceKey identifie une source d’état hôte en échec.
object

Méthodes

Appelez-les sur le handle renvoyé par create, ou via une ref React.

mount

Monte l’élément dans target et démarre le chargement. Les composants React se montent eux-mêmes. Paramètres
string | HTMLElement
requis

destroy

Supprime l’élément et libère son frame et ses abonnements. Vous pouvez l’appeler plusieurs fois. React supprime l’élément automatiquement.

update

Fusionne de nouvelles props dans l’élément monté. Avec React, modifiez plutôt les props du composant. Paramètres
Partial<TableElementProps>
requis

Style

Cet élément n’expose pas de noms de classes pour le style. Utilisez appearance (thème, couleur d’accent, variables) pour modifier son apparence.