Présentation de l’interface utilisateur

@univerjs-pro/boards-ui est la toile de navigateur sous licence pour les cartes Univer. Elle rend la scène, gère les interactions de sélection et de visualisation, et fournit les barres d'outils, les menus contextuels, l'édition de texte, l'éditage de forme, l'éditeur de connecteurs et l'interface utilisateur pour les types d'éléments de la carte pris en charge.

Enregistrer l’interface Board

Configurez UniverLicensePlugin avant les plugins Board. Docs, Drawing, Ink et Shape Editor sont des dépendances techniques pour le rendu et l'édition; l'utilisation de Boards n'exige pas une connaissance préalable de ces produits.

UniverBoardsUIPlugin

  • workbench
    object
    Options de mise en page de Workbench.
    • content
      booleanValeur par défaut: true
      Affiche la zone de contenu principale.
    • header
      booleanValeur par défaut: false
      Affiche l'en-tête.
    • headerMenu
      booleanValeur par défaut: false
      Affiche le menu de l’en-tête.
    • toolbar
      booleanValeur par défaut: false
      Affiche la barre d'outils.
    • footer
      booleanValeur par défaut: false
      Affiche le pied de page.
  • interaction
    object
    Options de zoom et de déplacement du canevas.
    • minZoomRatio
      numberValeur par défaut: 0.02
      Définit le facteur de zoom minimal.
    • maxZoomRatio
      numberValeur par défaut: 4
      Définit le facteur de zoom maximal.
    • wheelZoomWithModifier
      booleanValeur par défaut: true
      Active le zoom à la molette avec une touche de modification.
    • trackpadPanEnabled
      booleanValeur par défaut: true
      Active le déplacement du canevas au pavé tactile.
  • interactionMode
    'editing' | 'viewing'Valeur par défaut: 'editing'
    Démarre en mode édition ou visualisation. Les permissions de document s'appliquent toujours.
  • gridVisible
    booleanValeur par défaut: false
    Affiche la grille de toile.
  • grid
    object
    Couleurs et espacement de la grille.
    • gridSize
      numberValeur par défaut: 32
      Espacement des lignes secondaires en unités du canevas.
    • lineColor
      stringValeur par défaut: 'rgba(100, 116, 139, 0.48)'
      Couleur des lignes secondaires.
    • majorGridSize
      numberValeur par défaut: 160
      Espacement des lignes principales en unités du canevas.
    • majorLineColor
      stringValeur par défaut: 'rgba(100, 116, 139, 0.72)'
      Couleur des lignes principales.
  • quickAddEnabled
    booleanValeur par défaut: true
    Montre les commandes à ajouter rapidement.
  • preciseSelection
    booleanValeur par défaut: false
    Nécessite des hits plus précis pour sélectionner des éléments.
  • showDimensions
    booleanValeur par défaut: false
    Affiche les indicateurs de dimension.
  • showToolbar
    booleanValeur par défaut: true
    Affiche la barre d'outils de la toile.
  • modeSwitcherVisible
    booleanValeur par défaut: true
    Affiche le commutateur en mode interaction.
  • collaboratorCursorsVisible
    booleanValeur par défaut: true
    Affiche les curseurs d'autres collaborateurs.
  • collaboratorCursorShareInterval
    numberValeur par défaut: 100
    Intervalle d’envoi des positions du curseur, de 16 à 1 000 ms.
  • viewportBar
    object
    Paramètres des barres de défilement de la zone visible.
    • enabled
      booleanValeur par défaut: true
      Active les barres de défilement du port de vue.
    • horizontal
      booleanValeur par défaut: true
      Affiche la barre de défilement horizontale.
    • vertical
      booleanValeur par défaut: true
      Affiche la barre de défilement verticale.
    • padding
      number | objectValeur par défaut: 300
      Marge autour du canevas, en unités du canevas. Une valeur commune ou une valeur par côté.
      • top
        numberValeur par défaut: 300
        Marge en haut.
      • right
        numberValeur par défaut: 300
        Marge à droite.
      • bottom
        numberValeur par défaut: 300
        Marge en bas.
      • left
        numberValeur par défaut: 300
        Marge à gauche.
  • insert
    object
    Valeurs par défaut des nouveaux éléments.
    • chart
      object
      Taille du graphique.
      • width
        numberValeur par défaut: 480
        Largeur.
      • height
        numberValeur par défaut: 270
        Hauteur.
    • image
      object
      Taille et position de l’image.
      • fallbackWidth
        numberValeur par défaut: 320
        Largeur utilisée lorsque les dimensions de l'image sont inconnues.
      • fallbackHeight
        numberValeur par défaut: 180
        Hauteur utilisée lorsque les dimensions de l'image sont inconnues.
      • fitRatio
        numberValeur par défaut: 0.56
        Part de la zone visible utilisée pour ajuster l’image.
      • minEdge
        numberValeur par défaut: 80
        Longueur minimale d’un côté après ajustement.
      • minPositionOffset
        numberValeur par défaut: 24
        Décalage minimal depuis l’origine de la zone visible.
    • table
      object
      Dimensions du tableau.
  • shape
    object
    Sélecteur de formes.
    • commonCount
      number
      Nombre de formes courantes à afficher.
    • presets
      readonly IBoardShapePreset[]
      Définitions des formes du sélecteur.
  • sticky
    object
    Options des pense-bêtes.
    • colors
      readonly string[]
      Couleurs proposées.
  • renderAdapters
    readonly IBoardElementRenderAdapter[]
    Remplace les adaptateurs de rendu par défaut.
  • additionalRenderAdapters
    readonly IBoardElementRenderAdapter[]
    Ajoute des adaptateurs de rendu à la liste configurée.

UniverLicensePlugin

  • license
    string
    Contenu du fichier de licence client.
TypeScript
univer.registerPlugin(UniverLicensePlugin, {  license: process.env.CLIENT_LICENSE_TEXT,})univer.registerPlugin(UniverBoardsPlugin)univer.registerPlugin(UniverBoardsUIPlugin, {  workbench: {    content: true,    header: false,    headerMenu: false,    toolbar: false,    footer: false,  },  interaction: {    minZoomRatio: 0.1,    maxZoomRatio: 4,    wheelZoomWithModifier: true,    trackpadPanEnabled: true,  },})

Pour l'ordre d'inscription complet de la dépendance, du style et de la localisation, voir Installation et utilisation de base.

Options du canevas

IUniverBoardsUIConfig contrôle également l'apparence de la grille, inserts par défaut, formes disponibles et couleurs de notes collantes, outils de barre d'outils, barres de visualisation, adaptateurs de rendu, et des options telles que l'ajout rapide, la sélection précise, les dimensions et les curseurs collaborateurs.

Configurez menus contextuels et outils de toile au démarrage. Pour modifier un menu contextuel existant, utilisez le menu Facade API.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.