默认样式
Univer 提供了两级默认样式:工作表的默认样式和列或行的默认样式。这两者都可以通过 IWorksheetData
接口或 Facade API 设置。
配置
默认情况下,列样式优先于行样式。您可以在注册时通过设置 isRowStylePrecedeColumnStyle
来更改此行为。
univer.registerPlugin(UniverSheetsPlugin, {
isRowStylePrecedeColumnStyle: true,
})
设置默认样式
工作表的默认样式可以通过两种方式设置:
- 通过
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>
}
- 通过 Facade API 设置
const fworkbook = univerAPI.getActiveWorkbook()
const fworksheet = fworkbook.getActiveSheet()
const defaultStyle = {
bg: {
rgb: 'red',
},
}
const defaultColumnStyle = {
bg: {
rgb: 'blue',
},
}
const defaultRowStyle = {
bg: {
rgb: 'green',
},
}
// 设置默认样式
fworksheet.setDefaultStyle(defaultStyle)
// 设置列 D 的默认样式
fworksheet.setColumnDefaultStyle(3, defaultColumnStyle)
// 重置列 D 的默认样式
fworksheet.setColumnDefaultStyle(3, undefined)
// 设置行默认样式
fworksheet.setRowDefaultStyle(1, defaultRowStyle)