API générale

L’API Facade disponible dans Univer dépend du type d’unité actif et des plugins enregistrés. Cette page présente les API communes à une application Univer Docs.

Importation

import { FUniver } from '@univerjs/core/facade'const univerAPI = FUniver.newAPI(univer)

Commandes

La plupart des opérations Univer sont enregistrées dans le système de commandes. Ce chemin d’exécution unifié permet notamment l’annulation, le rétablissement et la collaboration.

Écoute des commandes

Utilisez Event.BeforeCommandExecute pour exécuter une logique avant une commande et Event.CommandExecuted pour l’exécuter une fois la commande terminée.

const beforeDisposable = univerAPI.addEvent(univerAPI.Event.BeforeCommandExecute, ({ id, params }) => {  console.log('Avant la commande :', id, params)})const afterDisposable = univerAPI.addEvent(univerAPI.Event.CommandExecuted, ({ id, params }) => {  console.log('Commande exécutée :', id, params)})

Pour empêcher l’exécution d’une commande, définissez event.cancel sur true dans un écouteur BeforeCommandExecute.

const disposable = univerAPI.addEvent(univerAPI.Event.BeforeCommandExecute, (event) => {  if (event.id === 'doc.command.set-name') {    event.cancel = true  }})

Les écouteurs renvoient un objet IDisposable. Supprimez-les lorsqu’ils ne sont plus nécessaires.

beforeDisposable.dispose()afterDisposable.dispose()disposable.dispose()

Exécution de commandes

Si vous connaissez l’identifiant et les paramètres d’une commande, exécutez-la avec FUniver.executeCommand. Par exemple, cette commande Docs renomme le document actif :

const document = univerAPI.getActiveDocument()if (document) {  await univerAPI.executeCommand('doc.command.set-name', {    unitId: document.getId(),    name: 'Notes du projet',  })}

API des événements

Les événements exposés par univerAPI.Event proviennent du noyau Univer et des plugins enregistrés dans l’application. Le noyau fournit les événements de commande et du cycle de vie des documents ; les plugins Docs peuvent enrichir cette surface. Avant d’utiliser un événement, vérifiez qu’il appartient à un plugin enregistré.

Consultez la référence des événements Facade pour connaître les noms et les types de paramètres disponibles dans la version actuelle.

Utilisez addEvent pour vous abonner, puis supprimez l’objet renvoyé pour vous désabonner :

const disposable = univerAPI.addEvent(univerAPI.Event.CommandExecuted, ({ id }) => {  if (id === 'doc.command.set-name') {    console.log('Le nom du document a changé')  }})// Supprimez l’écouteur lorsqu’il n’est plus nécessairedisposable.dispose()

Annulation et rétablissement

await univerAPI.undo()await univerAPI.redo()

Presse-papiers système

Après l’enregistrement du plugin d’interface Docs, copy et paste agissent sur la sélection et la position du curseur actuelles dans le document.

await univerAPI.copy()await univerAPI.paste()

Interface utilisateur

Consultez Composants de l’interface Docs pour étendre les menus, la barre d’outils et les autres zones de l’interface Docs.

WebSocket

Les installations avec prédéfinis exposent univerAPI.createSocket(url). En mode plugin, installez @univerjs/network, enregistrez UniverNetworkPlugin, puis importez son extension Facade.

import { UniverNetworkPlugin } from '@univerjs/network'import '@univerjs/network/facade'univer.registerPlugin(UniverNetworkPlugin)

Vous pouvez ensuite vous abonner aux événements du socket, envoyer des messages et fermer la connexion :

const socket = univerAPI.createSocket('wss://example.com/docs')socket.open$.subscribe(() => {  socket.send('hello')})socket.message$.subscribe((message) => {  console.log('Message WebSocket :', message.data)})socket.error$.subscribe((error) => {  console.error('Erreur WebSocket :', error)})socket.close()

API des énumérations

Facade expose des énumérations communes par l’intermédiaire de univerAPI.Enum :

console.log(univerAPI.Enum.UniverInstanceType.UNIVER_DOC)console.log(univerAPI.Enum.LifecycleStages.Rendered)

API des méthodes utilitaires

Facade expose les utilitaires partagés par l’intermédiaire de univerAPI.Util :

console.log(univerAPI.Util.tools.isString('Univer Docs')) // true