# Univer PDFs API

> Créez, trouvez, enregistrez, ouvrez et déchargez des unités PDF avec PDF Facade API.

- Human documentation: [https://docs.univer.ai/fr-FR/guides/pdfs/features/core/pdfs-api](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/pdfs-api)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/pdfs/features/core/pdfs-api.md](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/pdfs-api.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

- Source: [pdfs/features/core/pdfs-api.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/features/core/pdfs-api.fr-FR.mdx)

---

PDF Facade ajoute à `FUniver` les unités PDF et les points d'entrée des pages. Importez son point d'entrée à effet de bord avant de créer l'objet API.

## Activer PDF Facade

```ts
import { FUniver } from '@univerjs/core/facade'

import '@univerjs-pro/pdfs/facade'

const univerAPI = FUniver.newAPI(univer)
```

Enregistrez `UniverPdfsPlugin` dans l'instance Univer afin que l'application puisse héberger des unités PDF.

## Créer, trouver et enregistrer des unités PDF

Lorsque `document` est omis, `createPdf()` crée une unité avec une page A4 vierge. Transmettez un instantané précédemment renvoyé par `save()` pour restaurer une unité.

```ts
const pdf = univerAPI.createPdf({
  id: 'project-brief',
  name: 'Project brief',
})

const activePdf = univerAPI.getActivePdf()
const samePdf = univerAPI.getPdf(pdf.getId())
const snapshot = pdf.save()
```

Utilisez les méthodes Facade ou les commandes pour mettre à jour un PDF en cours d'exécution. Traitez l'instantané enregistré comme des données de persistance détachées.

## Entrer dans une page

`FPdfPage` est le point d'entrée commun pour les superpositions modifiables et le texte natif importé d'une page :

```ts
const firstPage = pdf.getPageByIndex(0) ?? pdf.insertPage()
const elements = firstPage.getElements()
const nativeText = firstPage.getTextSpans()
```

Continuez avec [Pages et éléments](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/pages-and-elements.md), [Texte et listes](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/text-and-lists.md), [Tableaux](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/tables.md), [Images et séparateurs](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/images-and-dividers.md) ou [Annotations et texte natif](https://docs.univer.ai/fr-FR/guides/pdfs/features/core/annotations-and-native-text.md) pour les opérations détaillées.

## Décharger une unité PDF

Déchargez une unité PDF par son identifiant lorsqu'elle n'est plus nécessaire. Détruisez l'instance racine `univer` uniquement lorsque toute l'application est fermée.

```ts
const pdf = univerAPI.getActivePdf()

if (pdf) {
  univerAPI.disposeUnit(pdf.getId())
}
```

Pour les signatures et types de retour exacts, consultez la [référence PDF Facade](https://docs.univer.ai/fr-FR/reference/facade/pdf.md).