> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# ListElement

> Les avoirs derrière le solde d'un compte. Chaque devise et chaque jeton a sa propre ligne, avec son nom et sa valeur en dollars, du plus grand au plus petit. Les lignes peuvent signaler celle que le visiteur a touchée, afin que vous puissiez ouvrir votre propre écran pour celle-ci. Lorsque `openHoldingOnSelect` est activé, un clic sur une ligne affiche la page de solde de cet avoir à la place du graphique et de la liste de cette unité.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Balances`](https://docs.whop.com/fr/elements/latest/wallet/balances), dans [`Wallet`](https://docs.whop.com/fr/elements/latest/wallet/overview). `accountId` et `openHoldingOnSelect` proviennent de `Wallet`. Transmettez les props et les callbacks via les options de création ou les props React.

Se monte n'importe où dans votre hiérarchie de vues. Prend un `accountId` et charge ses propres données ; transmettez aussi une closure et les lignes deviennent touchables. La racine est une `VStack` : elle s'adapte à son contenu et remplit la largeur que vous lui donnez.

```tsx React theme={null}
import { WhopElements, Wallet, Balances, ListElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <ListElement onBalanceSelected={(e) => console.log(e)} onAccountSelected={(e) => console.log(e)} onCreditsSelected={(e) => console.log(e)} />
        </Balances>
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
  const balances = wallet.create('balances', { /* options */ });
  balances.create('list', {
    onBalanceSelected: (e) => console.log(e),
    onAccountSelected: (e) => console.log(e),
    onCreditsSelected: (e) => console.log(e)
  }).mount('#wallet-balances-list');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct WalletScreen: View {
    var body: some View {
        ListElement(
            accountId: "biz_xxxx"
        ) { balance in
            print(balance.symbol)
        }
    }
}
```

Données d'exemple. [Ouvrir le Playground](https://docs.whop.com/fr/elements/latest/wallet/overview#playground).

[ListElement exécuté sur un simulateur iPhone](https://app.revyl.ai/embed/f128a268-f5e0-47c1-8919-86e4f04d6876?controls=0)

## Props

**accessToken** `string`

Un jeton à portée limitée pour la lecture. Un compte nécessite `company:balance:read` ; les avoirs d'un utilisateur ou la liste de ses comptes possédés nécessitent `user:balance:read`. Générez-le sur votre serveur avec `POST /api/v1/access_tokens`. Sans lui, la lecture utilise la propre session du visiteur, qui ne fonctionne qu'en same-origin.

**includeOwnedAccounts** `boolean`

Pour le compte `user_…` d'un utilisateur, liste son solde personnel suivi de chaque compte possédé renvoyé par le backend, au lieu de lister les avoirs de son compte personnel. Ignoré pour un compte. Par défaut : `false`.

**showSourceCurrency** `boolean`

Affiche chaque ligne dans la devise dans laquelle elle est détenue (€4.20, 0.00000009 cbBTC) et place la valeur en dollars en dessous. Désactivé par défaut, de sorte que chaque ligne est en dollars. Par défaut : `false`.

**showUsdEquivalent** `boolean`

Conserve la valeur en dollars sous un avoir affiché dans sa propre devise. Ne s'applique que lorsque `showSourceCurrency` est activé. Par défaut : `true`.

**showPersonalAccount** `boolean`

Conserve la ligne personnelle lorsque `includeOwnedAccounts` est activé. Désactivez-la si votre application n'a aucun compte personnel à ouvrir. Par défaut : `true`.

**maxItems** `number`

Affiche au maximum ce nombre de lignes d'avoirs, du plus grand au plus petit. S'il y en a davantage, la liste obtient un contrôle Show all balances qui déploie le reste sur place. Sans cette option, tous les avoirs sont listés.

## Événements

Transmettez les callbacks dans les options de création ou dans les props React.

### `onBalanceSelected`

Une ligne d'avoir a été cliquée, avec `includeOwnedAccounts` désactivé. `holding` vaut `usd` pour la ligne en dollars combinée, sinon le symbole de l'avoir (`cbBTC`, `EUR`), et `kind` vous indique lequel des trois il s'agit, afin que vous puissiez router sans classer vous-même les symboles. L'élément ne navigue jamais.

**payload** `object`

**propriétés**

**holding** `string` *required*

**kind** `"usd" | "cash" | "asset"` *required*

### `onAccountSelected`

Une ligne de compte a été cliquée, avec `includeOwnedAccounts` activé. `accountId` est le tag personnel `user_…` ou un tag `biz_…` possédé, et `kind` vous permet de router sans l'inspecter. L'élément ne navigue jamais.

**payload** `object`

**propriétés**

**accountId** `string` *required*

**kind** `"personal" | "business"` *required*

### `onCreditsSelected`

La ligne des crédits Whop a été cliquée. Les crédits ne sont utilisables que sur Whop et ne sont jamais retirables : ils se trouvent donc en dehors de toutes les lignes d'avoirs ; l'hôte ouvre son propre écran de crédits. L'élément ne navigue jamais.

### `onLoaderStart`

S'exécute après le premier affichage du squelette de chargement et avant `onReady`.

### `onReady`

S'exécute après le premier affichage complet de l'élément.

### `onError`

S'exécute lorsque l'élément ne parvient pas à se charger ou plante. L'affichage de repli reste visible. Utilisez `code` pour une gestion programmatique. `sourceKey` identifie une source d'état hôte en échec.

**e** `object`

**propriétés**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Méthodes

Appelez-les sur le handle renvoyé par `create`, ou via une `ref` React.

### `mount`

Monte l'élément dans `target` et démarre le chargement. Les composants React se montent eux-mêmes.

**Paramètres**

**target** `string | HTMLElement` *required*

### `destroy`

Supprime l'élément et libère son frame et ses abonnements. Vous pouvez l'appeler plusieurs fois. React supprime l'élément automatiquement.

### `update`

Fusionne de nouvelles props dans l'élément monté. Avec React, modifiez plutôt les props du composant.

**Paramètres**

**options** `Partial\<ListElementProps\>` *required*

## Style

Stylisez ces parties via `appearance.classes`. Utilisez le camel case ou le kebab case pour les noms de propriétés et incluez les unités. Les feuilles de style de la page ne peuvent pas atteindre le frame de l'élément. Le framework valide chaque déclaration avant de l'injecter.

| Classe | Cible |
| - | - |
| `.whop-ActivityRow` | Une ligne d'activité du registre — son icône, son titre, son horodatage et son montant |
| `.whop-ActivitySurface` | Le flux d'activité — titre, filtres et jusqu'à toutes les lignes récupérées |
| `.whop-BalanceBreakdownSurface` | Le total du solde d'une devise, la barre segmentée et les lignes de montants |
| `.whop-BalanceRow` | Une ligne de solde — son icône, son nom, sa valeur et son chevron |
| `.whop-BalancesSurface` | La liste des soldes — une ligne par avoir ou par compte |
| `.whop-CashBalanceSurface` | La page de solde d'un avoir — retour, titre, montant, répartition, actions et activité |
| `.whop-PlatformCreditsRow` | Les crédits émis par Whop — utilisables uniquement sur Whop, jamais retirables |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-ActivityRow': { borderRadius: '8px', fontWeight: '600' },
      'whop-ActivitySurface': { borderRadius: '8px', fontWeight: '600' },
      'whop-BalanceBreakdownSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 7 classes use this shape
wallet.update({
  appearance: { classes: { 'whop-ActivityRow': { fontWeight: '700' } } }
});
```

Avec React, transmettez `appearance` à `<Wallet>`. Définissez-la globalement avec `WhopElements({ appearance })`.

## Paramètres

**accountId** `String` *required*

Le compte dont la vue lit l'argent. Utilisez un ID de compte préfixé par `biz_`. Un ID d'utilisateur préfixé par `user_` lit le propre solde du visiteur et nécessite une authentification du visiteur (`WhopSDK.configureWithOAuth`), et non un jeton de compte.

**onBalanceSelected** `((WalletBalance) -\> Void)?`

Appelé avec la ligne touchée par le visiteur. Omettez-le et les lignes s'affichent sans chevrons, et le toucher ne fait rien.

## `WalletBalance`

Ce que renvoie une sélection :

* `id: String` : stable pour chaque ligne
* `symbol: String` : `USD`, `BTC`, …
* `displayName: String` : le nom affiché sur la ligne
* `amountUsd: Decimal` : la valeur de la ligne en dollars
* `isCrypto: Bool` : un avoir crypto plutôt que fiat

## États

Affiche deux lignes provisoires pendant le chargement des soldes. Un ID de compte qui ne peut pas être résolu affiche `Couldn't load this account.` Si la lecture du solde elle-même échoue, la liste s'affiche vide plutôt que d'afficher une erreur.

## Bon à savoir

* Elle ne défile pas d'elle-même : placez-la dans une `ScrollView` lorsqu'elle partage un écran avec d'autres contenus.
* Se combine avec [`BalanceElement`](https://docs.whop.com/fr/elements/latest/wallet/balances-balance#swift), qui affiche le total du même compte et son évolution.

> [!NOTE]
>
> Appelez `WhopSDK.configure(tokenProvider:)` une seule fois au lancement. Les vues attendent le jeton. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md). Appliquez un thème avec `.whopTheme(_:)`.


## Related topics

- [Premiers pas avec Elements](https://docs.whop.com/fr/elements/latest/getting-started.md)
- [BalanceElement](https://docs.whop.com/fr/elements/latest/wallet/balances-balance.md)
- [Activer les versements des sous-comptes](https://docs.whop.com/fr/developer/platforms/render-payout-portal.md)
