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
workbenchobjectOptions de mise en page de Workbench.contentbooleanValeur par défaut:trueAffiche la zone de contenu principale.headerbooleanValeur par défaut:falseAffiche l'en-tête.headerMenubooleanValeur par défaut:falseAffiche le menu de l’en-tête.toolbarbooleanValeur par défaut:falseAffiche la barre d'outils.
interactionobjectOptions de zoom et de déplacement du canevas.minZoomRationumberValeur par défaut:0.02Définit le facteur de zoom minimal.maxZoomRationumberValeur par défaut:4Définit le facteur de zoom maximal.wheelZoomWithModifierbooleanValeur par défaut:trueActive le zoom à la molette avec une touche de modification.trackpadPanEnabledbooleanValeur par défaut:trueActive 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.gridVisiblebooleanValeur par défaut:falseAffiche la grille de toile.gridobjectCouleurs et espacement de la grille.gridSizenumberValeur par défaut:32Espacement des lignes secondaires en unités du canevas.lineColorstringValeur par défaut:'rgba(100, 116, 139, 0.48)'Couleur des lignes secondaires.majorGridSizenumberValeur par défaut:160Espacement des lignes principales en unités du canevas.majorLineColorstringValeur par défaut:'rgba(100, 116, 139, 0.72)'Couleur des lignes principales.
quickAddEnabledbooleanValeur par défaut:trueMontre les commandes à ajouter rapidement.preciseSelectionbooleanValeur par défaut:falseNécessite des hits plus précis pour sélectionner des éléments.showDimensionsbooleanValeur par défaut:falseAffiche les indicateurs de dimension.showToolbarbooleanValeur par défaut:trueAffiche la barre d'outils de la toile.modeSwitcherVisiblebooleanValeur par défaut:trueAffiche le commutateur en mode interaction.collaboratorCursorsVisiblebooleanValeur par défaut:trueAffiche les curseurs d'autres collaborateurs.viewportBarobjectParamètres des barres de défilement de la zone visible.enabledbooleanValeur par défaut:trueActive les barres de défilement du port de vue.horizontalbooleanValeur par défaut:trueAffiche la barre de défilement horizontale.verticalbooleanValeur par défaut:trueAffiche la barre de défilement verticale.paddingnumber | objectValeur par défaut:300Marge autour du canevas, en unités du canevas. Une valeur commune ou une valeur par côté.topnumberValeur par défaut:300Marge en haut.rightnumberValeur par défaut:300Marge à droite.bottomnumberValeur par défaut:300Marge en bas.leftnumberValeur par défaut:300Marge à gauche.
insertobjectValeurs par défaut des nouveaux éléments.chartobjectTaille du graphique.widthnumberValeur par défaut:480Largeur.heightnumberValeur par défaut:270Hauteur.
imageobjectTaille et position de l’image.fallbackWidthnumberValeur par défaut:320Largeur utilisée lorsque les dimensions de l'image sont inconnues.fallbackHeightnumberValeur par défaut:180Hauteur utilisée lorsque les dimensions de l'image sont inconnues.fitRationumberValeur par défaut:0.56Part de la zone visible utilisée pour ajuster l’image.minEdgenumberValeur par défaut:80Longueur minimale d’un côté après ajustement.minPositionOffsetnumberValeur par défaut:24Décalage minimal depuis l’origine de la zone visible.
tableobjectDimensions du tableau.columnsnumberValeur par défaut:4Nombre de colonnes.rowsnumberValeur par défaut:3Nombre de lignes.cellWidthnumberValeur par défaut:120Largeur d’une colonne.cellHeightnumberValeur par défaut:48Hauteur d’une ligne.minWidthnumberValeur par défaut:240Largeur minimale calculée à partir des colonnes.minHeightnumberValeur par défaut:96Hauteur minimale calculée à partir des lignes.widthnumberLargeur.heightnumberHauteur.
shapeobjectSélecteur de formes.commonCountnumberNombre de formes courantes à afficher.presetsreadonly IBoardShapePreset[]Définitions des formes du sélecteur.
stickyobjectOptions des pense-bêtes.colorsreadonly string[]Couleurs proposées.
renderAdaptersreadonly IBoardElementRenderAdapter[]Remplace les adaptateurs de rendu par défaut.additionalRenderAdaptersreadonly IBoardElementRenderAdapter[]Ajoute des adaptateurs de rendu à la liste configurée.
UniverLicensePlugin
licensestringContenu du fichier de licence client.
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.
Configuration des menus et barre d’outils du canevas
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 ?