# Concepts de base

- Human documentation: [https://docs.univer.ai/fr-FR/guides/docs/getting-started/quickstart](https://docs.univer.ai/fr-FR/guides/docs/getting-started/quickstart)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/docs/getting-started/quickstart.md](https://docs.univer.ai/fr-FR/guides/docs/getting-started/quickstart.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

- Source: [docs/getting-started/quickstart.fr-FR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/getting-started/quickstart.fr-FR.mdx)

---

Découvrez les plugins, instantanés, commandes et API Facade de Univer Docs. Pour créer un éditeur, consultez [l’installation et l’utilisation de base](https://docs.univer.ai/fr-FR/guides/docs/getting-started/installation.md).

## Concepts de base

Avant d’aller plus loin avec Univer, lisez cette page pour en comprendre les concepts de base. Ils vous aideront à utiliser Univer plus facilement.

Ces concepts sont les suivants :

* Plugin
* Snapshot
* Commande
* Facade API

### Plugins

Toutes les fonctionnalités d’Univer sont fournies par des plugins, qui constituent ses éléments de base. Plusieurs plugins combinés forment une application Univer.

Les plugins ont notamment pour rôle :

1. D’implémenter des fonctionnalités. Par exemple, `@univerjs/docs-hyper-link` fournit le modèle et les commandes de liens hypertextes pour Univer Docs.
2. De fournir des capacités fondamentales. Par exemple, `@univerjs/engine-render` fournit les capacités de rendu.

Vous pouvez combiner les plugins d’Univer afin de personnaliser une application selon vos besoins, sans charger de code inutile. Vous pouvez également étendre les fonctionnalités d’Univer en écrivant vos propres plugins.

#### Liens connexes

1. Consultez [Liens hypertextes](https://docs.univer.ai/fr-FR/guides/docs/features/hyper-link.md) pour découvrir comment ajouter une fonctionnalité Docs en mode preset ou plugin.
2. Consultez [Architecture d’Univer](/blog/univer) pour en savoir plus sur la conception de l’architecture d’Univer.

### Instantané

Univer Docs utilise [`IDocumentData`](https://docs.univer.ai/fr-FR/guides/docs/model/document-data.md#idocumentdata) comme format de snapshot. Il décrit le corps du document, les styles du document, les en-têtes et pieds de page, les dessins, les listes, les tableaux et les ressources des plugins.

Le champ facultatif `resources` stocke les données définies par les plugins.

> [!WARNING: Attention]
> Le snapshot d’Univer sert uniquement à stocker des données. Il ne reflète pas le dernier état du document pendant
> l’exécution ! Pour enregistrer l’état du document sous forme de snapshot, utilisez la méthode d’enregistrement du
> snapshot de la Facade API.

### Commande

Dans Univer Docs, les modifications du contenu et de la mise en forme du document sont effectuées au moyen de commandes. Cette approche permet de suivre les modifications, d’implémenter l’annulation, le rétablissement et l’édition collaborative, et de coordonner les fonctionnalités associées.

La Facade API prépare les paramètres et exécute en arrière-plan les commandes Docs correspondantes.

> [!WARNING: Attention]
> **Ne modifiez pas directement le snapshot !** Vos modifications ne seront pas appliquées et ne déclencheront aucune
> mise à jour des vues ou de l’interface utilisateur. Modifiez les données au moyen de commandes ou de la Facade API.

### Facade API

Les applications bureautiques étant très complexes, l’architecture d’Univer l’est également. Pour faciliter son utilisation par les développeurs, nous proposons la Facade API, une couche d’abstraction autour des plugins officiels d’Univer qui fournit des interfaces plus simples.

La Facade API est activement améliorée. Si vous avez des questions ou des besoins particuliers, ouvrez une issue sur GitHub.

La Facade API est une API de haut niveau qui masque les détails de l’implémentation sous-jacente. Elle simplifie les tâches courantes, mais les fonctionnalités complexes peuvent nécessiter de comprendre l’architecture d’Univer et d’utiliser directement l’API de bas niveau.

#### Liens connexes

1. [Utiliser la Facade API](https://docs.univer.ai/fr-FR/guides/docs/getting-started/facade.md)
2. [API générale](https://docs.univer.ai/fr-FR/guides/docs/features/core/general-api.md)
3. [API Univer Docs](https://docs.univer.ai/fr-FR/guides/docs/features/core/docs-api.md)

## Mode preset et mode plugin

Un preset regroupe des plugins préconfigurés. Les deux modes offrent les mêmes capacités avec les mêmes plugins. Les presets simplifient la configuration ; le mode plugin permet de contrôler leur composition et leur chargement.

> [!WARNING]
> Utilisez des versions cohérentes pour toutes les dépendances Univer. N’enregistrez pas à nouveau un plugin déjà inclus dans un preset.

| Mode plugin                                  | Mode preset                                       |
| -------------------------------------------- | ------------------------------------------------- |
| Importer explicitement les extensions Facade | Extensions Facade incluses                        |
| Contrôler l’ordre d’enregistrement           | Le preset gère ses plugins                        |
| Charger les plugins à la demande             | Charger les presets configurés à l’initialisation |