> ## 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.

# TableElement

> Les campagnes, groupes d'annonces et annonces d'un compte publicitaire dans un seul tableau, avec les onglets permettant de passer de l'un à l'autre : sélectionnez des lignes pour filtrer le niveau inférieur, recherchez, triez, ventilez les chiffres, choisissez vos colonnes, et mettez en pause, reprenez, dupliquez ou supprimez directement depuis une ligne. La période couverte et les lignes filtrées sont conservées sur le handle, de sorte qu'un graphique monté à côté porte exactement sur les mêmes données.

> [!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 [`Reporting`](https://docs.whop.com/fr/elements/latest/ads/reporting), dans [`Ads`](https://docs.whop.com/fr/elements/latest/ads/overview). `accountId` et `accessToken` proviennent de `Ads`. Transmettez les props et les callbacks via les options de création ou les props React.

```tsx React theme={null}
import { WhopElements, Ads, Reporting, TableElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <TableElement onTabChanged={(e) => console.log(e)} onFilterChanged={(e) => console.log(e)} onColumnsChanged={(e) => console.log(e)} onCustomMetricsChanged={(e) => console.log(e)} onViewChanged={(e) => console.log(e)} onSourcesChanged={(e) => console.log(e)} onAttributionModelChanged={(e) => console.log(e)} />
        </Reporting>
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  const reporting = ads.create('reporting', { /* options */ });
  reporting.create('table', {
    onTabChanged: (e) => console.log(e),
    onFilterChanged: (e) => console.log(e),
    onColumnsChanged: (e) => console.log(e),
    onCustomMetricsChanged: (e) => console.log(e),
    onViewChanged: (e) => console.log(e),
    onSourcesChanged: (e) => console.log(e),
    onAttributionModelChanged: (e) => console.log(e)
  }).mount('#ads-reporting-table');
</script>
```

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

## Props

**useCampaignCreator** `boolean`

Ce qui se passe lorsqu'un visiteur demande une modification — depuis un menu de ligne, une ligne de brouillon ou Edit ad dans l'overlay de détails. Activé par défaut : le builder de campagnes s'ouvre par-dessus la page, sur la campagne et l'étape demandées, de sorte que la modification fonctionne sans rien configurer. Désactivez-le pour gérer vous-même la modification des campagnes — rien ne s'ouvre, et la demande est renvoyée via `editRequested`. Par défaut : `true`.

**breakdown** `string | null`

N'a plus aucun effet : le tableau affiche toujours des lignes complètes. Accepté pour que les intégrations existantes continuent de fonctionner. Par défaut : `null`.

**columns** `string[] | null`

Les colonnes affichées, par nom — des colonnes standard comme `impressions` et `roas`, ainsi que les événements de pixel ajoutés par le visiteur. Si la valeur n'est pas définie, le tableau s'ouvre avec ses propres valeurs par défaut. Renvoyé en entier via `columnsChanged` ; stockez la liste et transmettez-la ici pour conserver la disposition. Par défaut : `null`.

**customMetrics** `CustomMetricDefinition[]`

Des colonnes calculées à partir des chiffres déjà présents dans le tableau — une formule que vous nommez et formatez. Le tableau peut les modifier, et chaque modification est renvoyée via `customMetricsChanged` sous forme de nouvelle liste complète ; conservez-la et transmettez-la ici pour qu'elle persiste. Par défaut : `[]`.

**propriétés**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

**sourcesDrill** `string | null`

Le niveau de détail affiché dans l'onglet All, sous forme de chemin de source : `null` pour les racines, `ext:*` pour une liste de plateformes, `ext:<platform>:*` pour les campagnes de cette plateforme. Renvoyé via `viewChanged`. Par défaut : `null`.

**query** `string`

Le filtre appliqué dans le champ de recherche de l'onglet Ads. Par défaut : `""`.

**showPausedCampaigns** `boolean`

Indique si les campagnes en pause sont listées. Par défaut : `true`.

**showPausedAdGroups** `boolean`

Indique si les groupes d'annonces en pause sont listés. Par défaut : `true`.

**showPausedAds** `boolean`

Indique si les annonces en pause sont listées. Par défaut : `true`.

## Événements

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

### `onTabChanged`

L'onglet ouvert a changé. Reproduisez-le dans votre propre URL si vous voulez qu'il survive à un rechargement.

**payload** `object`

**propriétés**

**tab** `"ads" | "all" | "businesses" | "campaigns" | "ad-groups"` *required*

### `onFilterChanged`

Le visiteur a restreint la vue — en cochant des lignes, ou en cliquant sur une campagne pour accéder à ses groupes d'annonces. Chaque surface du même handle a déjà suivi ce changement.

**payload** `object`

**propriétés**

**campaignIds** `string[]` *required*

**adGroupIds** `string[]` *required*

**adIds** `string[]` *required*

### `onColumnsChanged`

Le visiteur a affiché ou masqué une colonne. Contient toutes les colonnes désormais affichées, standard comme événements de pixel — stockez la liste et renvoyez-la telle quelle comme `columns`, sinon la disposition est réinitialisée au prochain montage.

**payload** `object`

**propriétés**

**columns** `string[]` *required*

### `onCustomMetricsChanged`

Le visiteur a ajouté, modifié ou supprimé une colonne calculée. Contient dans tous les cas la liste complète — stockez-la telle quelle et renvoyez-la comme `customMetrics`, sinon elles disparaissent au prochain montage.

**payload** `object`

**propriétés**

**customMetrics** `CustomMetricDefinition[]` *required*

**propriétés**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

### `onViewChanged`

Le visiteur a modifié l'un des contrôles propres au tableau — le niveau de détail de l'onglet All, le champ de recherche, le bouton d'affichage des éléments en pause sur l'un des trois onglets. Contient tous ces contrôles, quel que soit celui qui a changé ; stockez-les et renvoyez-les comme props, sinon ils sont réinitialisés au prochain montage.

**payload** `object`

**propriétés**

**sourcesDrill** `string | null` *required*

**breakdown** `null` *required*

**query** `string` *required*

**showPausedCampaigns** `boolean` *required*

**showPausedAdGroups** `boolean` *required*

**showPausedAds** `boolean` *required*

### `onSourcesChanged`

Ce qu'affiche désormais l'onglet All, sous forme de chemins de source prêts à être transmis à un graphique : `null` en dehors de l'onglet All (publicité Whop uniquement), `[]` pour toutes les sources, sinon les lignes cochées ou le groupe détaillé. Chaque surface du même handle a déjà suivi ce changement.

**payload** `object`

**propriétés**

**sources** `string[] | null` *required*

### `onAttributionModelChanged`

Le visiteur a changé le point de contact qui reçoit l'attribution, depuis le sélecteur de l'onglet All. Chaque surface du même handle a déjà recalculé l'attribution ; conservez la valeur et renvoyez-la comme `attributionModel`, sinon elle revient au dernier point de contact au prochain montage.

**payload** `object`

**propriétés**

**attributionModel** `"last_touch" | "first_touch"` *required*

### `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\<TableElementProps\>` *required*

## Style

Cet élément n'expose pas de noms de classes pour le style. Utilisez `appearance` (thème, couleur d'accent, variables) pour modifier son apparence.


## Related topics

- [Reporting](https://docs.whop.com/fr/elements/latest/ads/reporting.md)
- [PaymentsTableElement](https://docs.whop.com/fr/elements/latest/dashboard/paymentsTable.md)
- [VerificationElement](https://docs.whop.com/fr/elements/latest/dashboard/verification.md)
