跳到主要内容
Office Open

XLSX

图片

在工作表中嵌入 PNG 和 JPEG 图片

#基本图片

JSON
{
  "worksheets": [
    {
      "name": "Images",
      "rows": [{ "cells": [{ "value": "Label" }, { "value": "Data" }] }],
      "images": [
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "png",
          "col": 3,
          "row": 1
        }
      ]
    }
  ]
}

#多张图片

JSON
{
  "worksheets": [
    {
      "name": "Gallery",
      "rows": [{ "cells": [{ "value": "Photos" }] }],
      "images": [
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "png",
          "col": 2,
          "row": 2
        },
        {
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
          "type": "jpg",
          "col": 5,
          "row": 2
        }
      ]
    }
  ]
}

#支持的格式

格式type 值
PNG"png"
JPEG"jpg"

已压缩格式(PNG/JPEG/GIF)在 ZIP 归档中以未压缩方式存储(ZIP_STORED),因为它们本身已是压缩格式;矢量/未压缩格式(EMF/WMF/BMP)使用 DEFLATE。

#图片选项参考

选项类型说明
dataDataType图片文件数据(base64 字符串、data URL 或 Uint8Array)
type"png" | "jpg"图片格式
colnumber从 1 开始的列位置
rownumber从 1 开始的行位置
namestringcNvPr 显示名称
descriptionstringcNvPr 描述(无障碍 alt 文本)
titlestringcNvPr 标题
hiddenboolean是否隐藏(默认 false)