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 CardFields, dans Payments. Transmettez les props et les callbacks via les options de création ou les props React.
Attend BrandingElement. Cet élément reste dans son état de chargement tant que BrandingElement n’est pas monté dans le même handle Payments.
Se place à l’intérieur d’un builder WhopCardFields. La saisie hébergée du numéro de carte, avec le logo de la marque sur son bord de fin.
Se monte à l’intérieur de CardFields. Le numéro de carte seul, pour que votre mise en page décide de son emplacement.

Données d’exemple. Ouvrir le Playground.

Props

Cet élément n’accepte aucune prop de la part de l’intégrateur.

É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<CardNumberElementProps>
requis

Style

Stylisez ces parties via appearance.classes. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l’élément. Le framework valide chaque déclaration avant de l’injecter.
Avec React, transmettez appearance à <Payments>. Définissez-la globalement avec WhopElements({ appearance }).

États

S’affiche immédiatement. Le logo de la marque apparaît dès que le numéro identifie un réseau. Un numéro invalide affiche son erreur sous le champ.

Bon à savoir

  • En dehors d’un builder WhopCardFields, il n’affiche rien : il lit l’unité de carte que ce builder crée.

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.

États

S’affiche dès que son provider CardFields dispose d’une clé publiable. Son message de validation s’affiche en dessous.

Bon à savoir

  • Les numéros de carte ne passent jamais par votre code. Les champs sont des saisies natives isolées PCI, et le SDK transmet un jeton à Whop : votre application reste donc hors du périmètre PCI.
  • Lisez l’état de complétude depuis le onChange du provider CardFields plutôt que champ par champ.
Enveloppez votre application dans <WhopElements getToken={…}> une seule fois, puis montez <Payments> autour des éléments. Consultez Premiers pas et Apparence.