Présentation de l’interface utilisateur

@univerjs-pro/bases-ui est l'atelier de navigation de navigateur autorisé pour les bases Univer. Il rend la navigation de table et de vue, la grille, kanban, calendrier, gantt, et les vues de galerie, les éditeurs de champs, le panneau de détails d'enregistrement, les menus et l'état de sélection.

Enregistrer l’espace de travail

Enregistrez la licence et le moteur de la formule avant les plugins Bases. Les champs Formule utilisent @univerjs-pro/engine-formula et ne nécessitent pas d'application Feuilles.

UniverLicensePlugin

  • license
    string
    Contenu du fichier de licence côté client.

UniverUIPlugin

  • container
    string | HTMLElement
    Élément DOM de montage de l’éditeur ou son identifiant.
TypeScript
univer.registerPlugin(UniverLicensePlugin, {  license: process.env.CLIENT_LICENSE_TEXT,})univer.registerPlugin(UniverProFormulaEnginePlugin)univer.registerPlugin(UniverRenderEnginePlugin)univer.registerPlugin(UniverUIPlugin, { container: 'app' })univer.registerPlugin(UniverBasesPlugin)univer.registerPlugin(UniverBasesUIPlugin)

Les importations, les styles et les données locales sont décrits dans Installation et utilisation de base.

Configurer la disposition initiale

IUniverBaseUIConfig contrôle quelles sont les régions de workbench qui apparaissent et quelle table et quelle vue s'ouvrent au démarrage.

UniverBasesUIPlugin

  • disableEdit
    boolean
    Désactive les contrôles d'édition dans le banc de travail.
  • initialState
    object
    Table et vue à ouvrir au démarrage.
    • tableId
      string | null
      Table à afficher en premier.
    • viewId
      string | null
      Affichage à afficher en premier.
  • workbench
    object
    Options de mise en page pour l'atelier.
    • header
      booleanValeur par défaut: true
      Affiche l'en-tête.
    • headerMenu
      booleanValeur par défaut: true
      Affiche le menu d'en-tête.
    • content
      booleanValeur par défaut: true
      Affiche la zone de contenu principale.
    • leftSidebar
      booleanValeur par défaut: true
      Affiche la barre latérale gauche.
    • rightSidebar
      booleanValeur par défaut: false
      Affiche la barre latérale droite.
    • rightPanelMode
      'dock' | 'overlay'Valeur par défaut: 'dock'
      Place le panneau droit dans la mise en page ou le flotte sur l'éditeur.
TypeScript
univer.registerPlugin(UniverBasesUIPlugin, {  workbench: {    header: true,    headerMenu: true,    content: true,    leftSidebar: true,    rightSidebar: false,    rightPanelMode: 'dock',  },  initialState: {    tableId: 'tasks',    viewId: 'kanban',  },})

Définissez disableEdit pour construire un workbench en lecture seule. Passez attachment, personOptions ou groupOptions uniquement lorsque les champs de base correspondants nécessitent des valeurs fournies par l'application hôte.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.