Images

Les images ajoutent du contenu visuel à un document. Elles peuvent illustrer un point, placer une image de référence à côté du texte, ou faire ressortir l'information clé.

Habillage du texte autour d’une image

Changez la disposition et observez le texte à côté et sous l’image.

Univer Docs

Univer Docs réunit texte, images et mise en page dans un document modifiable. Les titres organisent les idées et les images en expliquent les détails. Le style d’habillage détermine le parcours du texte. Choisissez une disposition qui conserve un ordre de lecture clair quand le contenu évolue.

L’habillage carré fait circuler le texte autour du rectangle de l’image.

Mode plugin

Installation

Shell
pnpm add @univerjs/drawing @univerjs/drawing-ui @univerjs/docs-drawing @univerjs/docs-drawing-ui

Utilisation

TypeScript
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { UniverDocsDrawingPlugin } from '@univerjs/docs-drawing'import { UniverDocsDrawingUIPlugin } from '@univerjs/docs-drawing-ui'import DocsDrawingUIEnUS from '@univerjs/docs-drawing-ui/locale/en-US'import { UniverDrawingPlugin } from '@univerjs/drawing'import { UniverDrawingUIPlugin } from '@univerjs/drawing-ui'import DrawingUIEnUS from '@univerjs/drawing-ui/locale/en-US'import '@univerjs/drawing-ui/lib/index.css'import '@univerjs/docs-drawing-ui/lib/index.css'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      DrawingUIEnUS,       DocsDrawingUIEnUS,     ),  },})univer.registerPlugin(UniverDrawingPlugin)univer.registerPlugin(UniverDrawingUIPlugin)univer.registerPlugin(UniverDocsDrawingPlugin)univer.registerPlugin(UniverDocsDrawingUIPlugin)

Si l'application utilise Collaboration, ajoutez la configuration override :

TypeScript
univer.registerPlugin(UniverDrawingPlugin, {  override: [[IImageIoService, null]], })

Configuration des plugins

UniverDrawingPlugin

  • override
    [DependencyIdentifier, Provider | null][]
    Surcharges de dépendances du plugin de dessin.
    • [0]
      DependencyIdentifier
      Identifiant de la dépendance. Pour le stockage des images, utilisez IImageIoService.
    • [1]
      Provider | null
      Fournisseur de remplacement. Passez null pour laisser la collaboration fournir le service.

Prise en charge mobile

Configurez d'abord le éditeur mobile. Dans la configuration en mode plugin sur cette page, remplacez les enregistrements de bureau ci-dessous par les exportations mobiles des mêmes paquets, et faites-le avant d'ouvrir un document . Gardez les plugins modèles, styles, locaux et importations Facade, et ne enregistrez pas les deux variantes.

PaquetInscription de bureauInscription mobile
@univerjs/docs-drawing-uiUniverDocsDrawingUIPluginUniverDocsDrawingMobileUIPlugin
@univerjs/drawing-uiUniverDrawingUIPluginUniverDrawingMobileUIPlugin

Mode prédéfini

Installation

Shell
pnpm add @univerjs/preset-docs-drawing

Utilisation

TypeScript
import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'import UniverPresetDocsCoreEnUS from '@univerjs/preset-docs-core/locales/en-US'import { UniverDocsDrawingPreset } from '@univerjs/preset-docs-drawing'import UniverPresetDocsDrawingEnUS from '@univerjs/preset-docs-drawing/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import '@univerjs/preset-docs-core/lib/index.css'import '@univerjs/preset-docs-drawing/lib/index.css'const { univerAPI } = createUniver({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      UniverPresetDocsCoreEnUS,      UniverPresetDocsDrawingEnUS,     ),  },  presets: [    UniverDocsCorePreset(),    UniverDocsDrawingPreset(),   ],})

Si l'application utilise Collaboration, passez collaboration: true à UniverDocsDrawingPreset:

TypeScript
UniverDocsDrawingPreset({  collaboration: true, })

Configuration des préréglages

UniverDocsDrawingPreset

  • collaboration
    booleanValeur par défaut: false
    Exécutez des E/S image par le biais du service de collaboration, ce qui rend le stockage d'images collaborative.

API Facade

En mode plugin, importez d'abord l'extension Facade :

TypeScript
import '@univerjs/docs-drawing/facade'

FDocument insère, interroge et gère les images de documents :

TypeScript
const document = univerAPI.getActiveDocument()const image = await document?.insertImage({  source: 'https://example.com/image.png',  imageSourceType: univerAPI.Enum.ImageSourceType.URL,  width: 320,  wrappingStyle: univerAPI.Enum.TextWrappingStyle.INLINE,})document?.getImage(image?.getId() ?? '')document?.getImages()

Le FDocumentImage retourné redimensionne, tourne, repositionne, rewraps, recommande ou supprime l'image.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.