Style par défaut
Nous proposons deux niveaux de styles par défaut :
- Le style par défaut de la feuille de calcul
- 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.
import { UniverSheetsPlugin } from '@univerjs/sheets'univer.registerPlugin(UniverSheetsPlugin, { isRowStylePrecedeColumnStyle: true,})import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'import { createUniver } from '@univerjs/presets'const { univerAPI } = createUniver({ presets: [ UniverSheetsCorePreset({ sheets: { 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 :
- Au moyen de l’interface
IWorksheetData
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>}- Au moyen de l’API Facade
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.
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.
Hauteur de ligne fixe
Hauteur ajustée
import { UniverSheetsPlugin } from '@univerjs/sheets'univer.registerPlugin(UniverSheetsPlugin, { textLineGap: 6 })import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'import { createUniver } from '@univerjs/presets'const { univerAPI } = createUniver({ presets: [UniverSheetsCorePreset({ sheets: { 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 ?