Cette page documente
@whop/elements@1.10.0 et @whop/elements-react@1.10.0.v1.0.0.
Se monte à l’intérieur de Tracking. accountId et accessToken en proviennent. Transmettez les props et les callbacks via les options de création ou les props React.
Données d’exemple. Ouvrir le Playground.
Props
Fixe la période sur un instant ISO 8601 exact au lieu du
period du handle — c’est ainsi qu’un deep link reproduit précisément les lignes derrière une métrique. Définissez à la fois from et to, ou aucun des deux. Par défaut : "".Limite aux événements attribués à une source de trafic, sous forme de chemin de source —
whop:adcamp_…:* pour l’une des campagnes du compte, ext:*, referrer:*, direct. Par défaut : "".Limite au parcours d’une seule personne — un ID de personne, un e-mail ou un cookie visiteur. Lorsqu’il est défini, la liste ignore la période et affiche tout son historique. Le champ de recherche modifie cette valeur. Par défaut :
"".Filtre par nom d’événement —
payment.completed, pixel.lead, pixel.page, ou pixel.custom:<name> pour un événement personnalisé. C’est la même valeur que celle utilisée par les liens des compteurs de résultats du tableau des annonces. Par défaut : "".Événements
Transmettez les callbacks dans les options de création ou dans les props React.onPeriodChanged
L’utilisateur a modifié la période depuis le sélecteur de période. Chaque surface du même handle a déjà suivi ce changement ; conservez-la et renvoyez-la comme period/customRange sur le handle, sinon la période est réinitialisée au prochain montage.
onAttributionModelChanged
L’utilisateur a changé le point de contact qui reçoit l’attribution, depuis le menu Attribution de la ligne de filtres. Chaque surface du même handle a déjà recalculé l’attribution ; conservez la valeur et renvoyez-la comme attributionModel sur le handle, sinon elle est rétablie au prochain montage.
onFiltersChanged
L’utilisateur a modifié un filtre ou la recherche par identifiant. Transporte l’état complet des filtres, quel que soit celui qui a changé — reflétez-le dans votre propre URL et renvoyez-le sous forme de props pour rendre la vue reproductible.
onPersonOpened
L’utilisateur a cliqué sur une cellule de personne et le handle n’a aucun links.person à suivre. Présentez l’élément person avec cette valeur, par ex. createOverlay("person", { identifier: payload.personId }) (personId est la clé stable propre à chaque personne ; identifier est la plus parlante dont dispose la surface), ou transmettez plutôt links.person sur le handle pour transformer les cellules en véritables liens.
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.
Méthodes
Appelez-les sur le handle renvoyé parcreate, 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
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
Style
Cet élément n’expose pas de noms de classes pour le style. Utilisezappearance (thème, couleur d’accent, variables) pour modifier son apparence.
