Skip to main content
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.0.0.
Wordt gemount binnen Payments. Geef props en callbacks mee via de create-opties of als React-props.
Wordt gemount binnen een WhopPayments-scope. Verzamelt het e-mailadres van de koper, dat elk bevestigingstoken vereist, en de controller leest het voor het aanmaken van het token, of je het nu bindt of niet.
Mount binnen <Payments>, dat de afschrijving en het bevestigingstoken beheert. <Payments> zelf wordt gemount binnen <WhopElements>. Het verzamelt het e-mailadres van de koper en publiceert het naar de provider, zodat createConfirmationToken het meestuurt zonder dat je iets hoeft mee te geven.

Voorbeeldgegevens. Open de Playground.

Props

boolean
Toont het gelokaliseerde label. Stel in op false als je een eigen label gebruikt. De invoer behoudt een gelokaliseerd aria-label. Standaard true.
string
Placeholdertekst voor de e-mailinvoer. Leeg (standaard) geeft you@example.com weer. Met zwevende labels is de labeltekst in plaats daarvan de placeholder. Standaard "".
"above" | "floating"
above (standaard) toont het label boven de invoer. floating gebruikt de labeltekst als placeholder en toont daarna een klein label boven de getypte tekst zodra de invoer een waarde heeft. Wordt genegeerd wanneer label false is. Standaard "above". Sinds v1.5.0.
string
Beginwaarde die eenmaal bij het mounten wordt toegepast. Standaard "".

Events

Geef callbacks mee in de create-opties of als React-props.

onChange

Wordt geactiveerd wanneer het e-mailadres verandert. complete is true wanneer het aannemelijk is. Een inlog activeert het met het ingelogde e-mailadres, dat ook naar createConfirmationToken() gaat.
object

onLoaderStart

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór onReady.

onReady

Wordt uitgevoerd na de eerste volledige weergave van het element.

onError

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik code voor programmatische afhandeling. sourceKey identificeert een mislukte host-state-bron.
object

Methoden

Roep deze aan op de handle die create retourneert, of via een React-ref.

mount

Mount het element in target en begint met laden. React-componenten mounten zichzelf.Parameters
string | HTMLElement
vereist

destroy

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

update

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.Parameters
Partial<EmailElementProps>
vereist

Styling

Style deze onderdelen via appearance.classes. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.
Geef in React appearance mee aan <Payments>. Stel het globaal in met WhopElements({ appearance }).

Parameters

Binding<String>?
Leest de waarde terug. De controller verzamelt die in beide gevallen.
Bool
Stel in op false als je een eigen label gebruikt; de invoer behoudt zijn toegankelijkheidslabel. Standaard true.
String?
Leeg geeft you@example.com weer.

Statussen

Wordt direct weergegeven. Een onaannemelijk adres toont de fout zodra het veld de focus verliest, daarna live.

Goed om te weten

  • Zonder dit element geef je zelf billingDetails.email mee aan createConfirmationToken. Het aanmaken weigert een token zonder e-mailadres.
  • Een expliciet billingDetails.email op het moment van aanmaken heeft voorrang op wat dit element heeft verzameld.
  • Een aannemelijk adres wordt opgezocht in de accountdirectory, met debounce en opnieuw bij blur. Een herkend adres biedt een inlog aan, en het element toont zelf het sheet voor de zescijferige code.
  • Een geverifieerde inlog ontgrendelt de opgeslagen betaalmethoden van de koper in WhopPaymentElement. Lees payments.buyer om te zien wie het is, en gebruik payments.signOut() om de koper te vergeten.
  • Het afgebakende token is een uur geldig en wordt niet vernieuwd. Wanneer het verloopt, komt de route voor opgeslagen methoden leeg terug en betaalt de koper met een nieuwe methode, hetzelfde pad als een gast.

Installatie

Mount het binnen een WhopPayments(accountID:charge:)-scope, die de controller aanmaakt en aan de inhoud doorgeeft. payments.buyer is de ingelogde koper zodra een inlog via e-mail er een heeft bevestigd. WhopBrandingElement moet ook op het scherm staan, omdat Whop merchant of record is bij deze verkopen en createConfirmationToken zonder dit element weigert. Style met .whopElementsAppearance(_:). De module is Elements, niet WhopElements van de wallet-SDK. Zie Aan de slag en Appearance.

Props

string
Beginwaarde die eenmaal bij het mounten wordt toegepast.
boolean
Toont het gelokaliseerde label. Standaard true.
string
Leeg geeft you@example.com weer.
(payload: EmailChangePayload) => void
Wordt bij elke wijziging geactiveerd.
StyleProp<ViewStyle>
Toegepast op de buitenste View van het element. Gebruik voor thema’s bij voorkeur appearance.parts op de provider, dat elk element op dit oppervlak dekt. Let op: de namen van React Native-onderdelen vormen momenteel een eigen set, niet de whop-*-klassenamen van het web, dus een appearance-object voor het web is niet ongewijzigd over te zetten.
ReactNode
Wordt weergegeven in plaats van het ingebouwde skelet terwijl het element laadt.
() => void
Wordt eenmaal geactiveerd zodra het element interactief is. <Payments> groepeert deze, dus de eigen onLoadingChange daarvan is meestal wat je nodig hebt.
(error: { message: string; code?: string }) => void
Een laad- of configuratiefout voor dit element. Het element geeft in beide gevallen zijn eigen foutscherm weer.

EmailChangePayload

Wat onChange teruggeeft:
  • email: string: de huidige waarde
  • complete: boolean: het adres kan worden geparset

Statussen

Wordt direct weergegeven. onChange meldt complete zodra het adres kan worden geparset, en het element toont zijn eigen validatiemelding bij blur.

Goed om te weten

  • Het gepubliceerde e-mailadres is wat het bevestigingstoken meestuurt als billing_details.email. Als je billingDetails.email meegeeft aan createConfirmationToken, wordt dit overschreven.
  • Stel label={false} in wanneer je formulier een eigen label levert. De invoer behoudt in beide gevallen zijn toegankelijkheidslabel.
Wikkel je app eenmaal in <WhopElements getToken={…}> en mount daarna <Payments> rond de elementen. Zie Aan de slag en Appearance.