Structure des données d’une feuille de calcul
IWorksheetData
IWorksheetData représente l’instantané d’une feuille de calcul dans Univer Sheet.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | string | Identifiant unique de la feuille de calcul. |
| name | string | Nom de la feuille de calcul. |
| tabColor | string | Couleur de l’onglet de la feuille de calcul. |
| hidden | BooleanNumber | Indique si la feuille est masquée. Valeur par défaut : BooleanNumber.FALSE. |
| freeze | IFreeze | Paramètres de figement des volets. |
| rowCount | number | Nombre total de lignes. |
| columnCount | number | Nombre total de colonnes. |
| defaultColumnWidth | number | Largeur par défaut des colonnes, en px. |
| defaultRowHeight | number | Hauteur par défaut des lignes, en px. |
| mergeData | IRange[] | Tableau des plages de cellules fusionnées. |
| cellData | IObjectMatrixPrimitiveType<ICellData> | Matrice du contenu des cellules. En savoir plus. |
| rowData | IObjectArrayPrimitiveType<Partial<IRowData>> | Tableau des objets de données de ligne. |
| columnData | IObjectArrayPrimitiveType<Partial<IColumnData>> | Tableau des objets de données de colonne. |
| rowHeader | { width: number; hidden?: BooleanNumber; } | Configuration des en-têtes de ligne. |
| columnHeader | { height: number; hidden?: BooleanNumber; } | Configuration des en-têtes de colonne. |
| backgroundImage? | IWorksheetBackgroundImage | Source facultative : { source: string; imageSourceType: ImageSourceType }. Voir les images de fond. |
| showGridlines | BooleanNumber | Indique si le quadrillage est visible. |
| rightToLeft | BooleanNumber | Indique si la feuille de calcul est en mode de droite à gauche. |
| defaultStyle? | Nullable<IStyleData> | Style par défaut de la feuille de calcul. |
Exemple
TypeScript
const worksheetData: IWorksheetData = { id: 'sheet1', name: 'Sheet 1', tabColor: '#FF0000', hidden: BooleanNumber.FALSE, freeze: { xSplit: 1, ySplit: 1, startRow: 1, startColumn: 1 }, rowCount: 1000, columnCount: 26, defaultColumnWidth: 100, defaultRowHeight: 25, mergeData: [], cellData: { 0: { 0: { v: 123, }, }, }, rowData: [], columnData: [], rowHeader: { width: 40 }, columnHeader: { height: 20 }, showGridlines: BooleanNumber.TRUE, rightToLeft: BooleanNumber.FALSE,}Cette structure offre une représentation complète des données d’une feuille de calcul, notamment de sa mise en page, de son contenu et de ses paramètres d’affichage.
Exemple complet
TypeScript
const workbook: IWorkbookData = { id: 'gyI0JO', sheetOrder: [ 'RSfWjJFv4opmE1JaiRj80', ], name: '', appVersion: '0.10.2', locale: 'enUS', styles: {}, sheets: { RSfWjJFv4opmE1JaiRj80: { id: 'RSfWjJFv4opmE1JaiRj80', name: 'Test', tabColor: '', hidden: 0, rowCount: 30, columnCount: 10, zoomRatio: 1, freeze: { startRow: -1, startColumn: -1, ySplit: 0, xSplit: 0, }, scrollTop: 0, scrollLeft: 0, defaultColumnWidth: 73, defaultRowHeight: 23, mergeData: [], cellData: {}, rowData: {}, columnData: { 0: { w: 125, hd: 0, }, 1: { w: 125, hd: 0, }, 2: { w: 125, hd: 0, }, 3: { w: 125, hd: 0, }, 4: { w: 125, hd: 0, }, 5: { w: 125, hd: 0, }, 6: { w: 125, hd: 0, }, 7: { w: 125, hd: 0, }, 8: { w: 125, hd: 0, }, 9: { w: 125, hd: 0, }, }, showGridlines: 1, rowHeader: { width: 46, hidden: 0, }, columnHeader: { height: 20, hidden: 0, }, rightToLeft: 0, }, }, resources: [ { name: 'SHEET_DEFINED_NAME_PLUGIN', data: '', }, ],}Que pensez-vous de ce guide ?