XLSX
合并、列宽与行高
合并单元格、列宽和行高
合并单元格
通过指定左上角和右下角来合并单元格区域（行和列索引从 1 开始）：
{
"worksheets": [
{
"name": "Sheet1",
"mergeCells": [{ "from": { "row": 1, "col": 1 }, "to": { "row": 1, "col": 4 } }],
"children": [
{ "cells": [{ "value": "Merged header across 4 columns" }] },
{ "cells": [{ "value": "Row 2" }, { "value": "Data" }] }
]
}
]
}
{
name: "Sheet1",
mergeCells: [
{ from: { row: 1, col: 1 }, to: { row: 1, col: 4 } }, // 合并 A1:D1
],
children: [
{ cells: [{ value: "Merged header across 4 columns" }] },
{ cells: [{ value: "Row 2" }, { value: "Data" }] },
],
}
多个合并区域：
{
"worksheets": [
{
"name": "Sheet1",
"mergeCells": [
{ "from": { "row": 1, "col": 1 }, "to": { "row": 1, "col": 4 } },
{ "from": { "row": 3, "col": 1 }, "to": { "row": 5, "col": 1 } }
],
"children": [
{ "cells": [{ "value": "Wide header" }] },
{ "cells": [{ "value": "A" }, { "value": "B" }] },
{ "cells": [{ "value": "Tall cell" }, { "value": "R3" }] },
{ "cells": [{ "value": null }, { "value": "R4" }] },
{ "cells": [{ "value": null }, { "value": "R5" }] }
]
}
]
}
mergeCells: [
{ from: { row: 1, col: 1 }, to: { row: 1, col: 4 } }, // A1:D1
{ from: { row: 3, col: 1 }, to: { row: 5, col: 1 } }, // A3:A5
],
列宽
使用 min 和 max 指定列范围来定义自定义列宽：
{
"worksheets": [
{
"name": "Sheet1",
"columns": [
{ "min": 1, "max": 1, "width": 20 },
{ "min": 2, "max": 4, "width": 12 },
{ "min": 5, "max": 5, "width": 30 }
],
"children": [
{
"cells": [
{ "value": "Wide" },
{ "value": "Med" },
{ "value": "Med" },
{ "value": "Med" },
{ "value": "Extra" }
]
}
]
}
]
}
columns: [
{ min: 1, max: 1, width: 20 }, // A 列
{ min: 2, max: 4, width: 12 }, // B-D 列
{ min: 5, max: 5, width: 30 }, // E 列
],
隐藏列和行
{
"worksheets": [
{
"name": "Sheet1",
"columns": [
{ "min": 1, "max": 1, "width": 15 },
{ "min": 2, "max": 2, "width": 15, "hidden": true }
],
"children": [
{ "cells": [{ "value": "Visible" }, { "value": "Hidden col" }] },
{ "cells": [{ "value": "Row 2" }, { "value": "Hidden col" }], "hidden": true }
]
}
]
}
columns: [
{ min: 1, max: 1, width: 15 },
{ min: 2, max: 2, width: 15, hidden: true }, // B 列被隐藏
],
children: [
{ cells: [{ value: "Visible" }, { value: "Hidden col" }] },
{ cells: [{ value: "Row 2" }, { value: "Hidden col" }], hidden: true }, // 第 2 行被隐藏
],
合并单元格选项参考
| 选项 | 类型 | 说明 |
|---|---|---|
from | { row: number, col: number } | 左上角 |
to | { row: number, col: number } | 右下角 |
列选项参考
| 选项 | 类型 | 说明 |
|---|---|---|
min | number | 范围内第一列（从 1 开始） |
max | number | 范围内最后一列（从 1 开始） |
width | number | 宽度（字符单位） |
hidden | boolean | 隐藏列 |
customWidth | boolean | 标记为自定义宽度（自动设置） |