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 Wallet. accountId en accessToken komen daarvandaan. Geef props en callbacks mee via de create-opties of als React-props. Bewaar de aangemaakte handle, of de React-ref, om refresh() en setDateRange() aan te roepen.
Wordt overal in je viewhiërarchie gemount. Neemt een accountId en laadt zijn eigen gegevens; geef ook een closure mee en je krijgt de rij die de kijker heeft aangetikt.

Voorbeeldgegevens. Open de Playground.

Props

string
Toon alleen activiteit voor deze valuta. Zonder deze waarde wordt activiteit in elke valuta getoond.
string
Een token met scopes voor het lezen. Een account heeft company:balance:read nodig en een gebruiker user:balance:read. Maak het aan op je server met POST /api/v1/access_tokens. Zonder token gebruikt het lezen de eigen sessie van de kijker, die alleen same-origin werkt.
number
Toon maximaal dit aantal rijen en stop met pagineren, voor een voorvertoning van recente activiteit. De lijst krijgt een See all activity-knop die seeAllRequested meldt in plaats van te navigeren.
boolean
Als dit uit staat, worden rijen met kaarttransacties inert weergegeven (geen klik, geen hover) in plaats van activitySelected te activeren. Gebruik dit wanneer je weet dat de kijker die details niet mag zien. Standaard true.
string[]
Activiteitstypen die zijn geselecteerd wanneer het element wordt gemount of het account verandert. De kijker kan ze wijzigen met de ingebouwde filters. Standaard [].
boolean
Verberg de filterchips, voor een compacte lijst die de kijker niet filtert. Standaard false.

Events

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

onActivitySelected

Er is op een rij geklikt. Open er je eigen detailweergave of route voor; het element navigeert nooit.
object

onActivityHovered

De aanwijzer is een rij binnengegaan of heeft er een verlaten (null). Wijs op hetzelfde moment iets van jezelf aan, zoals het markeren van de rij op een saldografiek.
object | null

onSeeAllRequested

De kijker heeft op See all activity gedrukt in een maxItems-lijst. Open je eigen volledige activiteitenscherm; het element navigeert nooit.

onDateRangeChanged

De kijker heeft het datumfilter gewijzigd via de filterchips in plaats van via setDateRange. Wis elke eigen bereikselectie, zoals een grafiekselectie, die niet meer overeenkomt.
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.

refresh

Haalt de activiteit van het account opnieuw op vanaf de eerste pagina. Roep dit aan na een wijziging die elders is gedaan (een storting, een verzending), zodat de lijst die toont zonder te wachten tot de cache verloopt.Retourneert Promise<void>

setDateRange

Stelt het datumfilter in van buiten het element, bijvoorbeeld door een selectie in een grafiek aan de lijst te koppelen. Geef null mee om het te wissen.Parameters
ActivityDateRangeOverride | null
vereist
Retourneert Promise<void>

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

Parameters

String
vereist
Wiens grootboek moet worden weergegeven. Gebruik een account-ID met prefix biz_ of een gebruikers-ID met prefix user_. Beide werken direct, omdat de feed de ID leest zonder eerst een grootboek op te zoeken.
Bool
Toont de ingebouwde kop “Activity”. Standaard true. Zet dit uit wanneer je scherm er al een heeft.
((WalletActivity) -> Void)?
Wordt aangeroepen met de rij die de kijker heeft aangetikt. De view navigeert nooit, dus stuur door naar je eigen detailscherm.

WalletActivity

Wat een selectie teruggeeft:
  • id: String: stabiel per rij
  • title: String / subtitle: String: de twee regels van de rij
  • amount: Decimal: met teken, negatief voor uitgaand geld
  • currencyCode: String
  • postedAt: Date
  • isIncoming: Bool

Statussen

Toont een skeletlijst terwijl de eerste pagina laadt, No activity found wanneer het grootboek geen bewegingen heeft, en de foutmelding met een Try again-knop wanneer het lezen mislukt. Als een latere pagina mislukt, blijven de al geladen rijen op het scherm staan en verschijnt onderaan een Try again.

Goed om te weten

  • Geef het een scrollcontainer. De feed is een LazyVStack en laadt een nieuwe pagina zodra de laatste rij verschijnt, dus buiten een ScrollView wordt pagina één weergegeven en nooit een volgende geladen.
  • Accepteert biz_…- en user_…-tags direct, dus in tegenstelling tot de andere walletviews hoeft het nooit eerst een grootboek op te zoeken.
Roep WhopSDK.configure(tokenProvider:) eenmaal aan bij het opstarten. Views wachten op het token. Zie Aan de slag. Pas een thema toe met .whopTheme(_:).