优先级

单元格样式 > 行样式 > 列样式

设置样式

worksheet.getCell('A1').属性 = 值;// 为单元格分配样式
// 将样式应用于工作表列
worksheet.columns = [
  { header: 'Id', key: 'id', width: 10 },
  { header: 'Name', key: 'name', width: 32, style: { font: { name: 'Arial Black' } } },
  { header: 'D.O.B.', key: 'DOB', width: 10, style: { numFmt: 'dd/mm/yyyy' } }
];
worksheet.getColumn(3).属性 = 值; // 将样式应用于工作表列
worksheet.getRow(2).属性 = 值;  // 将样式应用于工作表行

================

数字格式 numFmt

worksheet.getCell('A1').value = 1.6;
worksheet.getCell('A1').numFmt = '# ?/?';// 将值显示为“ 1 3/5”
worksheet.getCell('B1').value = 0.016;
worksheet.getCell('B1').numFmt = '0.00%';// 显示为“ 1.60％”

字体 font

worksheet.getCell('A1').font = {属性 : 值,}

富文本 value

就是一个单元格内，可以同时有多个不同的字体样式。

//方式1
worksheet.getCell('A1').value = {
  'richText': [
    {'font': {'size': 12,'color': {'theme': 0},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': 'This is '},
    {'font': {'italic': true,'size': 12,'color': {'theme': 0},'name': 'Calibri','scheme': 'minor'},'text': 'a'},
    {'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' '},
    {'font': {'size': 12,'color': {'argb': 'FFFF6600'},'name': 'Calibri','scheme': 'minor'},'text': 'colorful'},
    {'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' text '},
    {'font': {'size': 12,'color': {'argb': 'FFCCFFCC'},'name': 'Calibri','scheme': 'minor'},'text': 'with'},
    {'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' in-cell '},
    {'font': {'bold': true,'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': 'format'}
  ]
};
//方式2
expect(worksheet.getCell('A1').text).to.equal('This is a colorful text with in-cell format');
expect(worksheet.getCell('A1').type).to.equal(Excel.ValueType.RichText);

对齐 alignment

worksheet.getCell('A1').alignment = {属性 : 值,}

边框 border

worksheet.getCell('A1').border = {
    top: {style:'double', color: {argb:'FF00FF00'}}, //上边框
  left: {style:'double', color: {argb:'FF00FF00'}},  //左边框
  bottom: {style:'double', color: {argb:'FF00FF00'}}, //下边框
  right: {style:'double', color: {argb:'FF00FF00'}},  //右边框
  diagonal: {up: true, down: true, style:'thick', color: {argb:'FFFF0000'}}, //斜边框
}

边框样式 style
thin 、dotted 、dashDot 、hair 、dashDotDot 、slantDashDot 、mediumDashed、 mediumDashDotDot、 mediumDashDot 、medium 、
double、thick

图案 fill

worksheet.getCell('A1').fill = {
  type: '图案类型值',  //图案类型
  模式类型:'模式类型值',
  模式属性1:'模式属性1的值',
  模式属性2:'模式属性2的值'
};

单元格保护 protection

ws.getCell('A1').protection = {
  locked: true,  //锁定，指定在工作表受保护的情况下是否将单元格锁定。
  hidden: false,   //隐藏，指定如果工作表受保护，则单元格的公式是否可见。
};

================

条件格式 ConditionalFormatting

件格式化允许工作表根据单元格值或任意公式显示特定的样式，图标等。

条件格式设置规则是在工作表级别添加的，通常会覆盖一系列单元格。

可以将多个规则应用于给定的单元格范围，并且每个规则都将应用自己的样式。

如果多个规则影响给定的单元格，则规则优先级值将确定如果竞争样式冲突，则哪个规则胜出，优先级值较低的规则获胜。
如果没有为给定规则指定优先级值，ExcelJS 将按升序分配它们

添加规则

// 根据行和列为偶数或奇数向 A1:E7 添加一个棋盘图案
worksheet.addConditionalFormatting({
  ref: 'A1:E7',   //影响的单元格
  rules: [   //规则
    {
      type: '类型值',
      style: {fill: {type: 'pattern', pattern: 'solid', bgColor: {argb: 'FF00FF00'}}},  //样式
      priority:0, //优先级，可选属性，越小越优先，默认是自动分配
      属性1: 属性值1, 
      属性2: 属性值2, 
      属性3: 属性值3,
    }
  ]
})

类型值 type

type : ‘expression’ 的属性

type : ‘cellIs’ 的属性

type : ‘top10’ 的属性

type : ‘aboveAverage’ 的属性

type : ‘colorScale’ 的属性

type : ‘iconSet’ 的属性

type : ‘dataBar’ 的属性

type : ‘containsText’ 的属性

type : ‘timePeriod’ 的属性

时间段

大纲级别 outlineLevel

类似折叠，有助于规划数据的位置，实际看需求使用。

设置大纲

//方式1：大纲级别可以在列设置中定义
worksheet.columns = [
  { header: 'Id', key: 'id', width: 10 },
  { header: 'Name', key: 'name', width: 32 },
  { header: 'D.O.B.', key: 'DOB', width: 10, outlineLevel: 1 } 
];
//方式2：直接在行或列上设置
worksheet.getColumn(3).outlineLevel = 1;
worksheet.getRow(3).outlineLevel = 1;

设置大纲折叠按钮位置

默认是勾选的，勾选后位置不对，推荐去掉勾选，比较符合我们正常使用的习惯，也就是下面两个属性设置为false

worksheet.properties.outlineProperties = {
  summaryBelow: false,
  summaryRight: false,
};

图片 Image

将图像添加到工作表是一个分为两个步骤的过程。

1、首先，通过 addImage() 函数将图像添加到工作簿中，该函数还将返回 imageId 值。
2、然后，使用 imageId，可以将图像作为浮动图片覆盖单元格区域 或 嵌入单元格 ，添加到工作表中。

1、添加到工作簿

// 通过文件名将图像添加到工作簿
const imageId1 = workbook.addImage({
  filename: 'path/to/image.jpg',
  extension: 'jpeg',
});
// 通过 buffer 将图像添加到工作簿
const imageId2 = workbook.addImage({
  buffer: fs.readFileSync('path/to.image.png'),
  extension: 'png',
});
// 通过 base64  将图像添加到工作簿
const myBase64Image = "data:image/png;base64,iVBORw0KG...";
const imageId2 = workbook.addImage({
  base64: myBase64Image,
  extension: 'png',
});

2、添加到工作表

// 浮动图片
worksheet.addImage(imageId2, 'B2:D6'); // 在 B2:D6 上插入图片
worksheet.addImage(imageId2, { // 在 B2:D6 的一部分上插入图像
  tl: { col: 1.5, row: 1.5 },
  br: { col: 3.5, row: 5.5 },
  editAs: 'oneCell'  //可选，oneCell默认值，表示图像将与单元格一起移动，但大小不变动；
                     //absolute 图像将不会随着单元格移动或调整大小；undefined 它指定使图像将根据单元格移动和调整其大小
});
//嵌入单元格
worksheet.addImage(imageId2, {
  tl: { col: 0, row: 0 },  //嵌入位置
  ext: { width: 500, height: 200 },  //大小，单位像素
  hyperlinks: {  //可选，给图片添加超链接
    hyperlink: 'http://www.somewhere.com',
    tooltip: 'http://www.somewhere.com'
  }
});

工作表保护 protect

通过设置保护，避免其他用户修改表格

设置保护

await worksheet.protect('the-password', options);

移除保护

worksheet.unprotect();

保护的选项 options

只针对锁定的单元格有效，锁定见下方“单独设置单元格是否受保护”

单独设置单元格是否受保护

ws.getCell('A1').protection = {
  locked: true,  //工作表设置保护后，是否将单元格锁定。
  hidden: false,   //工作表设置保护后，则单元格的公式是否可见。
};