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 Payments. Transmettez les props et les callbacks via les options de création ou les props React.
Obligatoire. Les autres éléments d’un handle Payments, à l’exception de AddressElement, EmailElement et TaxIdElement, restent dans leur état de chargement tant que BrandingElement n’est pas monté — montez-le à côté d’eux.
Se monte à l’intérieur d’un scope WhopPayments. La ligne de marchand officiel que chaque interface de paiement doit afficher, avec le logotype Whop dessiné sous forme de tracé.
Montez-le à l’intérieur de <Payments>, qui gère le débit et le jeton de confirmation. <Payments> se monte lui-même à l’intérieur de <WhopElements>. Obligatoire sur chaque formulaire de collecte : createConfirmationToken refuse tant qu’aucun n’est monté, et il adopte le thème du reste de votre formulaire.

Données d’exemple. Ouvrir le Playground.

Props

Cet élément n’accepte aucune prop.

Événements

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

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<BrandingElementProps>
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.

États

S’affiche immédiatement. Il ne récupère rien et n’a pas d’état d’échec.

Bon à savoir

  • createConfirmationToken refuse tant qu’il n’est pas monté. Whop est le marchand officiel de ces ventes, l’acheteur doit donc en être informé sur l’écran où il paie.
  • Le logotype est un tracé vectoriel, pas un fichier, donc le framework n’embarque aucun bundle d’images.

Installation

Montez-le à l’intérieur d’un scope WhopPayments(accountID:charge:), qui crée le contrôleur et le transmet à son contenu. payments.buyer est l’acheteur connecté dès qu’une connexion par e-mail en a authentifié un. WhopBrandingElement doit aussi être à l’écran, car Whop est le marchand officiel (merchant of record) de ces ventes et createConfirmationToken refuse sans lui. Stylisez avec .whopElementsAppearance(_:). Le module est Elements, et non WhopElements du SDK wallet. Consultez Premiers pas et Apparence.

Props

StyleProp<ViewStyle>
Appliqué à la View externe de l’élément. Pour la personnalisation du thème, préférez appearance.parts sur le provider, qui couvre tous les éléments de cette interface. Notez que les noms de parties React Native forment aujourd’hui leur propre ensemble, distinct des noms de classes whop-* du web : un objet appearance web ne peut donc pas être repris tel quel.
ReactNode
Affiché à la place du squelette intégré pendant le chargement de l’élément.
() => void
Se déclenche une fois que l’élément est interactif. <Payments> les regroupe, donc c’est généralement son propre onLoadingChange qu’il vous faut.
(error: { message: string; code?: string }) => void
Un échec de chargement ou de configuration pour cet élément. L’élément affiche sa propre vue d’erreur dans tous les cas.

États

S’affiche immédiatement. Il n’a aucune donnée à charger ni d’états propres.

Bon à savoir

  • Obligatoire. createConfirmationToken refuse avec une BrandingRequiredError tant qu’aucun BrandingElement n’est monté, exactement comme les éléments web retardent leur affichage jusqu’à ce que la mention de marque soit attachée.
  • Montez-le une seule fois n’importe où à l’intérieur de <Payments>, généralement sous votre bouton de soumission.
  • Le logotype suit de lui-même l’apparence claire ou sombre du thème résolu.
Enveloppez votre application dans <WhopElements getToken={…}> une seule fois, puis montez <Payments> autour des éléments. Consultez Premiers pas et Apparence.