默认样式

GitHub在 GitHub 上编辑

Univer 提供了两级默认样式:工作表的默认样式和列或行的默认样式。这两者都可以通过 IWorksheetData 接口或 Facade API 设置。

配置

默认情况下,列样式优先于行样式。您可以在注册时通过设置 isRowStylePrecedeColumnStyle 来更改此行为。

univer.registerPlugin(UniverSheetsPlugin, {
  isRowStylePrecedeColumnStyle: true,
})

设置默认样式

工作表的默认样式可以通过两种方式设置:

  1. 通过 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>
}
  1. 通过 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)