Style par défaut

Nous proposons deux niveaux de styles par défaut :

  1. Le style par défaut de la feuille de calcul
  2. Le style par défaut d’une colonne ou d’une ligne

Tous deux peuvent être définis au moyen de l’interface IWorksheetData ou de l’API Facade.

Priorité des couleurs de fond

B2 reçoit les styles de sa ligne et de sa colonne. Changez la priorité, puis ajoutez un style de cellule.

A1

Feuille

B1

Colonne

C1

Feuille

A2

Ligne

B2

Colonne

C2

Ligne

A3

Feuille

B3

Colonne

C3

Feuille

Style appliqué à B2: Colonne

isRowStylePrecedeColumnStyle: false

Cette illustration compare les fonds ; les autres propriétés sont fusionnées séparément.

Configuration

Par défaut, le style de colonne est prioritaire sur le style de ligne. Vous pouvez modifier ce comportement en définissant isRowStylePrecedeColumnStyle lors de l’enregistrement.

Choisissez votre mode et ajoutez ces options à votre initialisation existante. Conservez les autres plugins et les paramètres de langue, de thème et de conteneur ; ne réenregistrez pas le même plugin.

TypeScript
import { UniverSheetsPlugin } from '@univerjs/sheets'univer.registerPlugin(UniverSheetsPlugin, {  isRowStylePrecedeColumnStyle: true,})

Définir le style par défaut

Il existe deux façons de définir le style par défaut d’une feuille de calcul :

  1. Au moyen de l’interface IWorksheetData
TypeScript
interface IWorksheetData {  // other  /**   * @property {Nullable<IStyleData>} [defaultStyle] - Default style data of Worksheet.   */  defaultStyle?: Nullable<IStyleData>}interface IRowData {  // other  /**   * style data   */  s?: Nullable<IStyleData>}interface IColumnData {  // other  /**   * style data   */  s?: Nullable<IStyleData>}
  1. Au moyen de l’API Facade
TypeScript
const fworkbook = univerAPI.getActiveWorkbook()const fworksheet = fworkbook.getActiveSheet()const defaultStyle = {  bg: {    rgb: 'red',  },}const defaultColumnStyle = {  bg: {    rgb: 'blue',  },}const defaultRowStyle = {  bg: {    rgb: 'green',  },}// set default stylefworksheet.setDefaultStyle(defaultStyle)// set column D default stylefworksheet.setColumnDefaultStyle(3, defaultColumnStyle)// reset column D the default stylefworksheet.setColumnDefaultStyle(3, undefined)// set row default stylefworksheet.setRowDefaultStyle(1, defaultRowStyle)

Réduire le texte pour l’ajuster

Lorsque le texte est plus large que la cellule, utilisez FRange pour réduire la taille de la police. Ce réglage s’applique à toutes les cellules de la plage ; getShrinkToFit() lit l’état de la cellule en haut à gauche.

TypeScript
const range = univerAPI.getActiveWorkbook().getActiveSheet().getRange('A1:C3')range.setShrinkToFit(true)const enabled = range.getShrinkToFit()

La réduction du texte et le renvoi à la ligne sont mutuellement exclusifs. Activer le renvoi désactive la réduction ; activer la réduction supprime le renvoi déjà appliqué aux cellules.

Espacement du texte des cellules

textLineGap ajoute un espacement en pixels entre les lignes du texte des cellules, y compris le texte enrichi et les éditeurs de cellule. Configurez-le à l’initialisation pour tous les classeurs de l’instance Univer. La valeur par défaut est 0 ; elle doit être finie et positive ou nulle.

Espacement supplémentaire0 px

Hauteur de ligne fixe

Feuille Univer
Texte multiligne dans une cellule
Plus d’espace entre les lignes

Hauteur ajustée

Feuille Univer
Texte multiligne dans une cellule
Plus d’espace entre les lignes
Schéma : une hauteur fixe peut couper le texte quand l’espacement augmente.
TypeScript
import { UniverSheetsPlugin } from '@univerjs/sheets'univer.registerPlugin(UniverSheetsPlugin, { textLineGap: 6 })

Augmenter cet espacement ne modifie pas les hauteurs existantes. Recalculez les hauteurs automatiques si nécessaire ; une hauteur fixe peut couper le texte. Ce réglage appartient à l’instance et non au style de paragraphe d’une cellule.

Que pensez-vous de ce guide ?

© 2026 DreamNum Co., Ltd.