# Contrôles de contenu

- Human documentation: [https://docs.univer.ai/fr-FR/guides/docs/features/content-controls](https://docs.univer.ai/fr-FR/guides/docs/features/content-controls)

- Agent Markdown: [https://docs.univer.ai/fr-FR/guides/docs/features/content-controls.md](https://docs.univer.ai/fr-FR/guides/docs/features/content-controls.md)

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

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

---

Les contrôles de contenu (SDT) prennent en charge texte enrichi ou brut, cases à cocher, dates, listes, images, groupes, sections répétées et blocs de document. Configurez Docs Core et la licence Pro, puis ces plugins avant de créer le document. Fusionnez la locale UI dans `locales` et chargez le CSS. Docs Advanced ne les inclut pas.

#### npm

```bash
npm install @univerjs-pro/docs-sdt @univerjs-pro/docs-sdt-ui
```

#### pnpm

```bash
pnpm add @univerjs-pro/docs-sdt @univerjs-pro/docs-sdt-ui
```

#### yarn

```bash
yarn add @univerjs-pro/docs-sdt @univerjs-pro/docs-sdt-ui
```

#### bun

```bash
bun add @univerjs-pro/docs-sdt @univerjs-pro/docs-sdt-ui
```

```ts
import { UniverDocsSdtPlugin } from '@univerjs-pro/docs-sdt'
import { UniverDocsSdtUIPlugin } from '@univerjs-pro/docs-sdt-ui'
import FeatureLocale from '@univerjs-pro/docs-sdt-ui/locale/fr-FR'
import { LocaleType } from '@univerjs/core'

import '@univerjs-pro/docs-sdt-ui/lib/index.css'

univerAPI.loadLocales(LocaleType.FR_FR, FeatureLocale)

univer.registerPlugin(UniverDocsSdtPlugin)
univer.registerPlugin(UniverDocsSdtUIPlugin)
```

## Insérer à la sélection

La commande utilise la sélection de texte active et entoure le contenu existant lorsque le contrôle le permet. Les éléments répétés sont créés via leur section parente.

```ts
import { InsertSdtCommand } from '@univerjs-pro/docs-sdt-ui'

await univerAPI.executeCommand(InsertSdtCommand.id, { kind: 'checkbox' })
```

## Verrous et persistance

Les contrôles sont des plages `CustomRangeType.SDT` dans `IDocumentBody.customRanges`, avec des métadonnées dans `ISdtCustomRange.properties`. Le verrou de contenu empêche la modification des valeurs ; celui du contrôle empêche de retirer son enveloppe. Une section répétée peut interdire l’ajout et la suppression d’éléments. Utilisez les commandes pour conserver l’annulation et le rétablissement.

Voir les [commandes](https://docs.univer.ai/fr-FR/reference/packages/plugins/univerjs-pro/docs-sdt.md) et l’[API UI](https://docs.univer.ai/fr-FR/reference/packages/plugins/univerjs-pro/docs-sdt-ui.md). La conversion DOCX relève d’[Exchange](https://docs.univer.ai/fr-FR/guides/docs/features/import-export.md) et ne garantit pas la conservation de toutes les propriétés Word ou liaisons XML personnalisées.