# Filigrane

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

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

- Requested language: `fr-FR`

- Content language: `fr-FR`

- Documentation version: `1.2.0`

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

---

#### Package metadata

```json
{
  "plugins": [
    {
      "client": "@univerjs/watermark",
      "facade": "@univerjs/watermark/facade"
    }
  ],
  "server": false
}
```

La fonctionnalité de filigrane offre une solution souple et sécurisée pour les pages web et les applications. Elle permet aux développeurs de générer dynamiquement des filigranes textuels ou graphiques sur la page afin d’empêcher toute utilisation ou diffusion non autorisée du contenu. Elle prend également en charge diverses options de configuration.

> [!INFO]
> Utilisez le [Générateur de filigranes](/tools/watermark-generator) pour prévisualiser les styles de filigrane et télécharger la configuration du plugin au format JSON.

> Interactive example: [Open the playground](/playground/docs/watermark)

## Mode plugin

### Installation

#### npm

```bash
npm install @univerjs/watermark
```

#### pnpm

```bash
pnpm add @univerjs/watermark
```

#### yarn

```bash
yarn add @univerjs/watermark
```

#### bun

```bash
bun add @univerjs/watermark
```

### Utilisation

```typescript
import { UniverWatermarkPlugin } from '@univerjs/watermark' // [!code ++]

import '@univerjs/watermark/facade' // [!code ++]

const univer = new Univer({
  // ...
})

univer.registerPlugin(UniverWatermarkPlugin, { // [!code ++]
  textWatermarkSettings: { // [!code ++]
    content: 'Hello, Univer!', // [!code ++]
    fontSize: 36, // [!code ++]
  }, // [!code ++]
}) // [!code ++]
```

### Plugins et configuration

#### @univerjs/watermark

Ce plugin fournit l’implémentation principale de la fonctionnalité de filigrane. Il permet aux développeurs d’ajouter des filigranes textuels ou graphiques aux applications et propose diverses options de configuration pour personnaliser leur apparence et leur comportement. Il fournit le plugin `UniverWatermarkPlugin`.

Référence : [@univerjs/watermark](https://docs.univer.ai/fr-FR/reference/packages/plugins/univerjs/watermark.md)

## Mode prédéfini

Le filigrane ne fournit aucun préréglage, mais son plugin peut être combiné à des préréglages.

### Installation

#### npm

```bash
npm install @univerjs/watermark
```

#### pnpm

```bash
pnpm add @univerjs/watermark
```

#### yarn

```bash
yarn add @univerjs/watermark
```

#### bun

```bash
bun add @univerjs/watermark
```

### Utilisation

```typescript
import { UniverWatermarkPlugin } from '@univerjs/watermark' // [!code ++]

import '@univerjs/watermark/facade' // [!code ++]

const { univerAPI } = createUniver({
  // ...
  presets: [
    UniverDocsCorePreset(),
  ],
  plugins: [
    [UniverWatermarkPlugin, { // [!code ++]
      textWatermarkSettings: { // [!code ++]
        content: 'Hello, Univer!', // [!code ++]
        fontSize: 36, // [!code ++]
      }, // [!code ++]
    }], // [!code ++]
  ],
})
```

## API Facade

### Importation

> [!INFO: Remarque sur le mode plugin]
> Seul le mode plugin nécessite d’importer manuellement le package Facade. Le mode prédéfini inclut déjà le package Facade correspondant ; aucune importation supplémentaire n’est donc nécessaire.

```typescript
import '@univerjs/watermark/facade'
```

### Ajouter un filigrane

```typescript
univerAPI.addWatermark('text', { content: 'hello', repeat: true })
```

### Supprimer le filigrane

```typescript
univerAPI.deleteWatermark()
```