Structure des données d’un Board

IBoardData

IBoardData est le format d'instantané utilisé par les cartes Univer. Il décrit une unité de la carte, y compris l'ordre des pages, les données de la page, les ressources, les thèmes, la page active, le ratio de zoom et les paramètres de la carte.

Propriétés

PropriétéTypeDescription
idstringIdentifiant unique de l’unité Board.
rev?numberValeur de révision optionnelle utilisée par la couche de persistance ou de collaboration.
namestringNom du Board.
appVersionstringVersion du package ayant créé l’instantané.
locale?stringParamètres régionaux du Board.
defaultPageSizeIBoardPageSizeTaille par défaut des pages de la carte.
pageOrderstring[]Liste ordonnée des identifiants de page du Board.
pagesRecord\<string, IBoardPage\>Snapshots de page, cliqués par id de page.
activePageId?stringId de la page active.
theme?IBoardThemeDataThème actuel du Board.
themes?Record\<string, IBoardThemeData\>Autres thèmes nommés.
zoomRatio?numberNiveau de zoom actuel.
resources?IResourcesRessources externes utilisées par les images, le texte enrichi, les tableaux et les autres éléments.
custom?`Record<string, unknown>null`
boardSettings?IBoardSettingsParamètres d’interface et d’interaction du Board.

Données des pages

IBoardPage stocke des éléments dans une carte clé par id, et elementOrder définit l'ordre dans lequel ils sont rendus. Conservez les deux structures en synchronisation lorsque vous construisez vous-même un instantané.

TypeScript
const boardData = {  id: 'board-1',  name: 'Planning board',  appVersion: '1.0.0',  defaultPageSize: { width: 1920, height: 1080 },  pageOrder: ['page-1'],  pages: {    'page-1': {      id: 'page-1',      pageType: 'page',      name: 'Page 1',      elementOrder: ['text-1'],      elements: {        'text-1': {          id: 'text-1',          type: 'text',          transform: { left: 120, top: 96, width: 240, height: 80 },          text: 'Kickoff',        },      },    },  },  activePageId: 'page-1',}

Utilisation

Les principales utilisations de IBoardData sont les suivantes:

  1. Création d'une unité UniverInstanceType.UNIVER_BOARD.
  2. Persistance et restauration des documents de la Commission.
  3. Préparation des données pour le traitement de l'importation, de l'exportation ou du côté serveur.
  4. Seeding a Board avec des pages, des éléments et des paramètres avant le premier rendu.

Les objets Snapshot sont des données de persistance. Une fois qu'un forum est en cours d'exécution, utilisez les API Facade au lieu de muter l'objet snapshot directement.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.