# Graphiques croisés dynamiques

- Human documentation: [https://docs.univer.ai/fr-FR/guides/sheets/features/pivot-chart](https://docs.univer.ai/fr-FR/guides/sheets/features/pivot-chart)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/sheets/features/pivot-chart.md](https://docs.univer.ai/fr-FR/guides/sheets/features/pivot-chart.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

- Source: [sheets/features/pivot-chart.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/sheets/features/pivot-chart.fr-FR.mdx)

---

Enregistrez les dépendances du [tableau croisé dynamique](https://docs.univer.ai/fr-FR/guides/sheets/features/pivot-table.md) et des [graphiques](https://docs.univer.ai/fr-FR/guides/sheets/features/charts.md), puis les deux plugins ci-dessous avant de créer le classeur. Fusionnez la locale UI dans `locales` et chargez le CSS. Une licence Pro est nécessaire.

#### npm

```bash
npm install @univerjs-pro/sheets-pivot-chart @univerjs-pro/sheets-pivot-chart-ui
```

#### pnpm

```bash
pnpm add @univerjs-pro/sheets-pivot-chart @univerjs-pro/sheets-pivot-chart-ui
```

#### yarn

```bash
yarn add @univerjs-pro/sheets-pivot-chart @univerjs-pro/sheets-pivot-chart-ui
```

#### bun

```bash
bun add @univerjs-pro/sheets-pivot-chart @univerjs-pro/sheets-pivot-chart-ui
```

```ts
import { UniverSheetsPivotChartPlugin } from '@univerjs-pro/sheets-pivot-chart'
import { UniverSheetsPivotChartUIPlugin } from '@univerjs-pro/sheets-pivot-chart-ui'
import SheetsPivotChartLocale from '@univerjs-pro/sheets-pivot-chart-ui/locale/fr-FR'
import { LocaleType } from '@univerjs/core'

import '@univerjs-pro/sheets-pivot-chart/facade'
import '@univerjs-pro/sheets-pivot-chart-ui/lib/index.css'

univerAPI.loadLocales(LocaleType.FR_FR, SheetsPivotChartLocale)

univer.registerPlugin(UniverSheetsPivotChartPlugin)
univer.registerPlugin(UniverSheetsPivotChartUIPlugin)
```

Le preset Sheets Advanced contient déjà ces plugins. Utilisez-le avec les presets Core et Drawing et importez explicitement `@univerjs-pro/sheets-pivot-chart/facade` pour ces API.

## Rapport indépendant

Le graphique possède son rapport. Ajoutez un champ de lignes et un champ de valeurs après insertion ; cet exemple utilise les deux premières colonnes.

```ts
const workbook = univerAPI.getActiveWorkbook()
const sheet = workbook?.getActiveSheet()
if (!sheet) throw new Error('No active worksheet')

sheet.getRange('A1:B4').setValues([
  ['Region', 'Sales'], ['East', 100], ['West', 200], ['East', 50],
])
const chart = await sheet.insertPivotChart(
  sheet.newPivotChart(univerAPI.Enum.ChartTypeString.Column)
    .setSource('A1:B4').setPosition('D2').setSize(640, 360).build(),
)
const fields = chart.getSourceFieldsInfo()
await chart.addField(fields[0].id, univerAPI.Enum.PivotTableFiledAreaEnum.Row, 0)
await chart.addField(fields[1].id, univerAPI.Enum.PivotTableFiledAreaEnum.Value, 0)
```

## Lier un tableau croisé dynamique

Les champs, filtres, tris et replis sont partagés avec le tableau référencé et ses autres graphiques liés. Le style et la position restent indépendants. Supprimer le graphique conserve le tableau. Supprimer le tableau rend le graphique indisponible jusqu’à la restauration du même tableau.

```ts
const pivotTable = workbook.getPivotTableById('pivot-table-1')
if (!pivotTable) throw new Error('PivotTable not found')

const linkedChart = await sheet.insertPivotChart(
  pivotTable.newChart(univerAPI.Enum.ChartTypeString.Line).setPosition('D22').build(),
)
linkedChart.setFieldButtonsVisible(true).setExpandCollapseButtonsVisible(true)
```

## Types et Worker

Courbes, colonnes, barres, aires, secteurs, anneaux et graphiques combinés sont pris en charge, avec leurs variantes empilées disponibles. Nuages de points, bulles, radars et cascades ne le sont pas. Les secteurs utilisent la première série de valeurs, les anneaux plusieurs séries. Les sous-totaux et totaux sont exclus des catégories.

Avec un [Worker](https://docs.univer.ai/fr-FR/guides/sheets/getting-started/worker.md), utilisez `UniverSheetsAdvancedPreset({ useWorker: true })` côté principal et `UniverSheetsAdvancedWorkerPreset()` côté Worker. Voir la [configuration](https://docs.univer.ai/fr-FR/reference/packages/plugins/univerjs-pro/sheets-pivot-chart.md#worker-calculation) et [FSheetPivotChart](https://docs.univer.ai/fr-FR/reference/facade/sheet-pivot-chart.md).

## Copier et supprimer des feuilles

Copier une feuille copie aussi ses graphiques croisés avec de nouveaux identifiants. Un rapport indépendant dont la source se trouve sur cette feuille utilise la nouvelle feuille et un cache indépendant. Un graphique lié référence le tableau croisé copié avec la feuille ; les références aux autres feuilles restent inchangées. Supprimer la feuille nettoie ses graphiques et ressources associées ; annuler restaure leurs définitions et données sources.