合并、列宽与行高

#合并单元格

通过 A1 区域引用合并单元格区域：

JSON

{
  "worksheets": [
    {
      "name": "Sheet1",
      "mergeCells": [{ "ref": "A1:D1" }],
      "rows": [
        { "cells": [{ "value": "Merged header across 4 columns" }] },
        { "cells": [{ "value": "Row 2" }, { "value": "Data" }] }
      ]
    }
  ]
}

TypeScript

{
  name: "Sheet1",
  mergeCells: [
    { ref: "A1:D1" },
  ],
  rows: [
    { cells: [{ value: "Merged header across 4 columns" }] },
    { cells: [{ value: "Row 2" }, { value: "Data" }] },
  ],
}

多个合并区域：

JSON

{
  "worksheets": [
    {
      "name": "Sheet1",
      "mergeCells": [{ "ref": "A1:D1" }, { "ref": "A3:A5" }],
      "rows": [
        { "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" }] }
      ]
    }
  ]
}

TypeScript

mergeCells: [
  { ref: "A1:D1" },
  { ref: "A3:A5" },
],

#列宽

使用 min 和 max 指定列范围来定义自定义列宽：

JSON

{
  "worksheets": [
    {
      "name": "Sheet1",
      "columns": [
        { "min": 1, "max": 1, "width": 20 },
        { "min": 2, "max": 4, "width": 12 },
        { "min": 5, "max": 5, "width": 30 }
      ],
      "rows": [
        {
          "cells": [
            { "value": "Wide" },
            { "value": "Med" },
            { "value": "Med" },
            { "value": "Med" },
            { "value": "Extra" }
          ]
        }
      ]
    }
  ]
}

TypeScript

columns: [
  { min: 1, max: 1, width: 20 },   // A 列
  { min: 2, max: 4, width: 12 },   // B-D 列
  { min: 5, max: 5, width: 30 },   // E 列
],

#隐藏列和行

JSON

{
  "worksheets": [
    {
      "name": "Sheet1",
      "columns": [
        { "min": 1, "max": 1, "width": 15 },
        { "min": 2, "max": 2, "width": 15, "hidden": true }
      ],
      "rows": [
        { "cells": [{ "value": "Visible" }, { "value": "Hidden col" }] },
        { "cells": [{ "value": "Row 2" }, { "value": "Hidden col" }], "hidden": true }
      ]
    }
  ]
}

TypeScript

columns: [
  { min: 1, max: 1, width: 15 },
  { min: 2, max: 2, width: 15, hidden: true }, // B 列被隐藏
],
rows: [
  { cells: [{ value: "Visible" }, { value: "Hidden col" }] },
  { cells: [{ value: "Row 2" }, { value: "Hidden col" }], hidden: true }, // 第 2 行被隐藏
],

#合并单元格选项参考

选项	类型	说明
`ref`	`string`	合并区域引用，如 `"A1:D1"`

#列选项参考

选项	类型	说明
`min`	`number`	范围内第一列（从 1 开始）
`max`	`number`	范围内最后一列（从 1 开始）
`width`	`number`	宽度（字符单位）
`hidden`	`boolean`	隐藏列
`customWidth`	`boolean`	标记为自定义宽度（自动设置）