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 Balances, in Wallet. accountId en openHoldingOnSelect komen van Wallet. Geef props en callbacks mee via de create-opties of als React-props.
Kan overal in je view-hiërarchie worden gemount. Neemt een accountId en laadt zijn eigen gegevens; geef ook een closure mee en de rijen worden tikbaar. De root is een VStack, dus de grootte past zich aan de inhoud aan en vult de breedte die je het geeft.

Voorbeeldgegevens. Open de Playground.

Props

string
Een scoped token voor het lezen. Een account heeft company:balance:read nodig; de tegoeden of de lijst met eigen accounts van een gebruiker hebben user:balance:read nodig. Maak het aan op je server met POST /api/v1/access_tokens. Zonder token gebruikt het lezen de eigen sessie van de kijker, wat alleen same-origin werkt.
boolean
Toon voor het user_…-account van een gebruiker het persoonlijke saldo, gevolgd door elk eigen account dat de backend retourneert, in plaats van de tegoeden binnen het persoonlijke account. Wordt genegeerd voor een account. Standaard false.
boolean
Toon elke rij in de valuta waarin het tegoed wordt aangehouden (€4.20, 0.00000009 cbBTC) en zet de dollarwaarde eronder. Standaard uitgeschakeld, dus elke rij staat in dollars. Standaard false.
boolean
Behoud de dollarwaarde onder een tegoed dat in zijn eigen valuta wordt getoond. Geldt alleen wanneer showSourceCurrency aan staat. Standaard true.
boolean
Behoud de persoonlijke rij wanneer includeOwnedAccounts aan staat. Schakel het uit als je app geen persoonlijk account heeft om te openen. Standaard true.
number
Toon maximaal dit aantal tegoedrijen, de grootste eerst. Als er meer zijn, krijgt de lijst een bedieningselement Show all balances dat de rest ter plekke uitklapt. Zonder deze prop wordt elk tegoed getoond.

Events

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

onBalanceSelected

Er is op een tegoedrij geklikt, met includeOwnedAccounts uitgeschakeld. holding is usd voor de gecombineerde dollarrij, en anders het symbool van het tegoed (cbBTC, EUR), en kind vertelt je welke van de drie het is, zodat je kunt routeren zonder zelf symbolen te classificeren. Het element navigeert nooit.
object

onAccountSelected

Er is op een accountrij geklikt, met includeOwnedAccounts ingeschakeld. accountId is de persoonlijke user_…-tag of een eigen biz_…-tag, en met kind kun je routeren zonder die te inspecteren. Het element navigeert nooit.
object

onCreditsSelected

Er is op de rij met Whop-credits geklikt. Credits zijn alleen op Whop te besteden en nooit op te nemen, dus ze staan buiten elke tegoedrij; de host opent zijn eigen creditsscherm. Het element navigeert nooit.

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<ListElementProps>
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 door aan <Wallet>. Stel het globaal in met WhopElements({ appearance }).

Parameters

String
vereist
Het account waarvan de view het geld leest. Gebruik een account-ID met het voorvoegsel biz_. Een gebruikers-ID met het voorvoegsel user_ leest het eigen saldo van de kijker en vereist kijkerauthenticatie (WhopSDK.configureWithOAuth), geen accounttoken.
((WalletBalance) -> Void)?
Wordt aangeroepen met de rij waarop de kijker heeft getikt. Laat je het weg, dan worden de rijen zonder chevrons weergegeven en doet tikken niets.

WalletBalance

Wat een selectie teruggeeft:
  • id: String: stabiel per rij
  • symbol: String: USD, BTC, …
  • displayName: String: de naam die op de rij wordt getoond
  • amountUsd: Decimal: de waarde van de rij in dollars
  • isCrypto: Bool: een cryptotegoed in plaats van fiat

Statussen

Toont twee placeholderrijen terwijl de saldi laden. Een account-ID dat niet kan worden opgelost, toont Couldn't load this account. Als het lezen van het saldo zelf mislukt, wordt de lijst leeg weergegeven in plaats van een fout te tonen.

Goed om te weten

  • Het scrolt niet zelfstandig, dus plaats het in een ScrollView wanneer het een scherm deelt met andere inhoud.
  • Werkt samen met BalanceElement, dat het totaal van hetzelfde account toont en hoe het is veranderd.
Roep WhopSDK.configure(tokenProvider:) eenmaal aan bij het opstarten. Views wachten op het token. Zie Aan de slag. Pas een thema toe met .whopTheme(_:).