Skip to main content
Denne side dokumenterer @whop/elements@1.10.0 og @whop/elements-react@1.10.0.
Siden v1.0.0.
Monteres inde i Balances, i Wallet. accountId og openHoldingOnSelect kommer fra Wallet. Send props og callbacks via create-indstillingerne eller React-props.
Monteres hvor som helst i dit view-hierarki. Tager et accountId og indlæser sine egne data; send også en closure, så bliver rækkerne trykbare. Roden er en VStack, så den tilpasser sin størrelse til indholdet og fylder den bredde, du giver den.

Eksempeldata. Åbn Playground.

Props

string
Et afgrænset token til læsningen. En konto skal have company:balance:read; en brugers beholdninger eller liste over ejede konti kræver user:balance:read. Udsted det på din server med POST /api/v1/access_tokens. Uden det bruger læsningen seerens egen session, hvilket kun virker på samme origin.
boolean
For en brugers user_…-konto: vis vedkommendes personlige saldo efterfulgt af alle ejede konti, som backenden returnerer, i stedet for at vise beholdningerne i den personlige konto. Ignoreres for en konto. Standard er false.
boolean
Vis hver række i den valuta, den holdes i (€4.20, 0.00000009 cbBTC), og placér dollarværdien nedenunder. Slået fra som standard, så alle rækker er i dollars. Standard er false.
boolean
Behold dollarværdien under en beholdning, der vises i sin egen valuta. Gælder kun, når showSourceCurrency er slået til. Standard er true.
boolean
Behold den personlige række, når includeOwnedAccounts er slået til. Slå den fra, hvis din app ikke har nogen personlig konto at åbne. Standard er true.
number
Vis højst så mange beholdningsrækker, største først. Når der er flere, får listen en Show all balances-kontrol, der udfolder resten på stedet. Uden den vises alle beholdninger.

Hændelser

Send callbacks i create-indstillingerne eller React-props.

onBalanceSelected

Der blev klikket på en beholdningsrække, mens includeOwnedAccounts er slået fra. holding er usd for den samlede dollarrække, ellers beholdningens symbol (cbBTC, EUR), og kind fortæller dig, hvilken af de tre det er, så du kan route uden selv at klassificere symboler. Elementet navigerer aldrig.
object

onAccountSelected

Der blev klikket på en kontorække, mens includeOwnedAccounts er slået til. accountId er det personlige user_…-tag eller et ejet biz_…-tag, og kind lader dig route uden at inspicere det. Elementet navigerer aldrig.
object

onCreditsSelected

Der blev klikket på rækken med Whop-kreditter. Kreditter kan kun bruges på Whop og kan aldrig hæves, så de står uden for alle beholdningsrækker; værten åbner sin egen kreditskærm. Elementet navigerer aldrig.

onLoaderStart

Kører, efter at indlæsningsskelettet tegnes første gang, og før onReady.

onReady

Kører efter elementets første komplette optegning.

onError

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug code til programmatisk håndtering. sourceKey identificerer en host-state-kilde, der fejlede.
object

Metoder

Kald disse på det handle, som create returnerer, eller via en React-ref.

mount

Monterer elementet i target og begynder indlæsningen. React-komponenter monterer sig selv.Parametre
string | HTMLElement
påkrævet

destroy

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

update

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.Parametre
Partial<ListElementProps>
påkrævet

Styling

Style disse dele via appearance.classes. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.
I React sender du appearance til <Wallet>. Sæt det globalt med WhopElements({ appearance }).

Parametre

String
påkrævet
Den konto, hvis penge visningen læser. Brug et konto-ID med præfikset biz_. Et bruger-ID med præfikset user_ læser seerens egen saldo og kræver seergodkendelse (WhopSDK.configureWithOAuth), ikke et kontotoken.
((WalletBalance) -> Void)?
Kaldes med den række, seeren trykkede på. Udelad den, så vises rækkerne uden chevrons, og et tryk gør ingenting.

WalletBalance

Hvad et valg returnerer:
  • id: String: stabil pr. række
  • symbol: String: USD, BTC, …
  • displayName: String: navnet, der vises på rækken
  • amountUsd: Decimal: rækkens værdi i dollars
  • isCrypto: Bool: en kryptobeholdning frem for fiat

Tilstande

Viser to pladsholderrækker, mens saldiene indlæses. Et konto-ID, der ikke kan opløses, viser Couldn't load this account. Hvis selve læsningen af saldoen fejler, vises listen tom i stedet for at vise en fejl.

Godt at vide

  • Den scroller ikke af sig selv, så placér den i en ScrollView, når den deler skærm med andet indhold.
  • Passer sammen med BalanceElement, som viser den samme kontos total og hvordan den har ændret sig.
Kald WhopSDK.configure(tokenProvider:) én gang ved opstart. Visninger venter på tokenet. Se Kom godt i gang. Anvend et tema med .whopTheme(_:).