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. Een kiezer voor het registratietype naast het waardeveld, vooraf geselecteerd op basis van het land van de koper.
Mount binnen <Payments>, dat de afschrijving en het bevestigingstoken beheert. <Payments> zelf wordt gemount binnen <WhopElements>. Een kiezer voor het registratietype naast een waarde-invoer, zodat een koper die een btw- of CUIT-nummer invoert eerst het juiste soort kiest.

Voorbeeldgegevens. Open de Playground.

Props

boolean
Schakelt beide velden uit terwijl de host de laatst bevestigde registratie opslaat. Standaard false.
string
ISO 3166-1 alpha-2-land van de koper, gebruikt om het type vooraf te selecteren. AR selecteert ar_cuit, LI selecteert li_uid. EU-landen en niet-toegewezen of lege waarden selecteren eu_vat. Andere toegewezen landen selecteren hun eigen eerste type. Een handmatige selectie blijft behouden wanneer het land verandert. Standaard "".
object
Initiële type en value uit een hervatte sessie. Een niet-ondersteund type valt terug op de standaard van het land.
string
API-validatiefout die onder de waarde-invoer wordt getoond. Leeg (standaard) toont niets. Standaard "".

Events

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

onChange

Wordt geactiveerd bij blur of Enter wanneer de waarde niet leeg is, of wanneer het type verandert terwijl er een waarde is. Identieke opeenvolgende waarden worden één keer geactiveerd. Het wissen van de waarde activeert niets. De host moet opgeslagen registraties zelf wissen.
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<TaxIdElementProps>
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<WhopTaxID?>?
Ontvangt elke bevestigde registratie.
String?
ISO 3166-1 alpha-2-land van de koper, gebruikt om het type vooraf te selecteren.
WhopTaxID?
Een initieel paar uit een hervatte sessie. Een niet-ondersteund type valt terug.
Bool
Schakelt beide velden uit terwijl je de laatst bevestigde registratie opslaat. Standaard false.
String?
Een API-validatiefout, getoond onder de waarde-invoer.

WhopTaxID

Wat een selectie teruggeeft:
  • type: WhopTaxIDType: het registratietype, eu_vat, ar_cuit, …
  • value: String: de registratie zelf

Statussen

Wordt direct weergegeven. Een waarde die niet overeenkomt met het formaat van het geselecteerde type toont de bijbehorende fout. error toont een mislukte API-validatie onder het waardeveld.

Goed om te weten

  • AR selecteert vooraf ar_cuit; EU-lidstaten en alles wat niet is toegewezen selecteren vooraf eu_vat. Een handmatige keuze blijft behouden wanneer het land verandert.
  • Geef het land van het adreselement door, zodat de twee gelijk blijven lopen.
  • De binding wordt geactiveerd bij elke bevestigde registratie, niet bij elke toetsaanslag.

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
ISO 3166-1 alpha-2-land van de koper, gebruikt om het type vooraf te selecteren. AR selecteert ar_cuit; EU-landen en niet-toegewezen waarden selecteren eu_vat.
{ type: string; value: string }
Initieel paar uit een hervatte sessie. Een niet-ondersteund type valt terug.
boolean
Schakelt beide velden uit, voor terwijl je de laatst bevestigde registratie opslaat.
string
Een validatiemelding van je API, getoond onder de waarde-invoer.
(payload: TaxIdChangePayload) => void
Wordt geactiveerd bij elke wijziging van type of waarde.
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.

TaxIdChangePayload

Wat onChange teruggeeft:
  • taxId: { type: TaxIdType; value: string }: het geselecteerde registratietype en wat de koper heeft getypt

Statussen

Wordt direct weergegeven. Het type wordt vooraf geselecteerd op basis van country en de waarde-invoer valideert tegen het formaat van dat type. onChange wordt geactiveerd met het huidige paar.

Goed om te weten

  • country selecteert alleen vooraf. Een koper die handmatig een type kiest, houdt dat wanneer het land verandert.
  • Geef error mee om een melding uit je eigen API-validatie onder de waarde-invoer te tonen.
  • Het element rapporteert het paar. Het versturen ervan is aan jou: koppel het aan je eigen bestelling of klantrecord.
Wikkel je app eenmaal in <WhopElements getToken={…}> en mount daarna <Payments> rond de elementen. Zie Aan de slag en Appearance.