概述
本 Demo 展示了文件上传单元格类型的多种配置方式，包括限制上传文件类型、自定义操作按钮、设置预设文件值以及自定义文件图标。Demo 演示了如何创建不同的文件上传单元格实例，并灵活控制每个单元格的功能特性。
实现思路
初始化工作表布局，设置描述文本和样式
创建多个 FileUpload 单元格类型实例，分别配置不同选项
为不同单元格设置文件类型限制（accept）和操作按钮（预览、下载、清除）
通过 setValue 为单元格设置预设的文件数据
使用 spread.options.builtInFileIcons 自定义文件图标
代码解析
创建文件上传单元格并限制文件类型
这段代码创建了一个文件上传单元格，通过 accept() 方法限制只能上传 .jpg、.png、.gif 格式的图片文件。valuePath(undefined) 表示单元格值接受包含文件信息的对象，例如 { name: 'demo.png', dataUrl: '...' }。
自定义操作按钮
这段代码创建了禁用下载和清除按钮的文件上传单元格，只保留预览功能。适用于只允许用户查看文件但不允许下载或删除的场景。
设置预设文件值
通过 setValue() 方法可以为单元格设置预设的文件数据，demoFiles 对象包含不同类型文件的示例数据（图片、.ssjson、.json、.js、.xlsx 等）。
自定义文件图标
通过设置 spread.options.builtInFileIcons 可以为不同扩展名的文件自定义显示图标。builtInFileIcons 是一个对象，键为文件扩展名，值为 base64 编码的图标数据。
运行效果
左侧区域展示图片文件上传，限制只能上传 .jpg、.png、.gif 格式
右上角的文件单元格禁用了下载和清除按钮，只能预览
右侧区域展示多种非图片格式文件（.ssjson、.json、.js、.xlsx），每个文件显示自定义图标
不同单元格有不同的操作按钮配置：有的支持全部操作（预览、下载、清除），有的只支持部分操作
鼠标悬停在已上传文件的单元格上时，会显示操作蒙层
API 参考
FileUpload 构造函数
创建文件上传单元格类型实例。
accept() 方法
fileTypes: 允许上传的文件类型，格式如 '.jpg,.png,.gif' 或 'image/*'
valuePath() 方法
path: 指定从文件对象中获取单元格值的路径，默认为 'dataUrl'。设置为 undefined 时接受完整的文件信息对象
isPreviewEnabled() 方法
enabled: 是否显示文件预览按钮
isDownloadEnabled() 方法
enabled: 是否显示文件下载按钮
isClearEnabled() 方法
enabled: 是否显示文件清除按钮
builtInFileIcons 选项
键为文件扩展名，值为 base64 编码的图标数据
import { builtInFileIcons, demoFiles } from './utils.js';
var spreadNS = GC.Spread.Sheets;
window.onload = function () {
const spread = new spreadNS.Workbook(document.getElementById("ss"), { sheetCount: 1 });
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
const sheet = spread.getActiveSheet();
initLayout(sheet);
// set cell type
const fileUpload1 = new spreadNS.CellTypes.FileUpload();
fileUpload1.accept('.jpg,.png,.gif');
fileUpload1.valuePath(undefined);
sheet.getCell(1, 0).cellType(fileUpload1);
const fileUpload2 = new spreadNS.CellTypes.FileUpload();
fileUpload2.isDownloadEnabled(false);
fileUpload2.isClearEnabled(false);
fileUpload2.valuePath(undefined);
sheet.getCell(1, 1).cellType(fileUpload2);
const fileUpload3 = new spreadNS.CellTypes.FileUpload();
sheet.getCell(1, 4).cellType(fileUpload3);
fileUpload3.valuePath(undefined);
sheet.getCell(2, 4).cellType(fileUpload3);
const fileUpload4 = new spreadNS.CellTypes.FileUpload();
fileUpload4.isDownloadEnabled(false);
fileUpload4.valuePath(undefined);
sheet.getCell(1, 5).cellType(fileUpload4);
const fileUpload5 = new spreadNS.CellTypes.FileUpload();
fileUpload5.isClearEnabled(false);
fileUpload5.valuePath(undefined);
sheet.getCell(2, 5).cellType(fileUpload5);
// set cell value
sheet.setValue(1, 0, demoFiles.image);
sheet.setValue(1, 1, demoFiles.image);
sheet.setValue(1, 4, demoFiles.ssjson);
sheet.setValue(2, 4, demoFiles.json);
sheet.setValue(1, 5, demoFiles.js);
sheet.setValue(2, 5, demoFiles.xlsx);
// set custom file icons
spread.options.builtInFileIcons = builtInFileIcons;
spread.resumePaint();
};
function initLayout(sheet) {
// Description
sheet.addSpan(0, 0, 1, 3, spreadNS.SheetArea.viewport);
sheet.addSpan(0, 4, 1, 7, spreadNS.SheetArea.viewport);
sheet.setColumnWidth(0, 70);
sheet.setColumnWidth(1, 70);
sheet.setColumnWidth(2, 200);
sheet.setColumnWidth(4, 100);
sheet.setColumnWidth(5, 100);
sheet.setRowHeight(0, 50);
sheet.setRowHeight(1, 70);
sheet.setRowHeight(2, 70);
sheet.setDefaultValue(0, 0, '1. 上传图片文件并自定义文件操作。');
sheet.setDefaultValue(0, 4, '2. 上传其他非图片格式文件并自定义相关文件的图标。');
const style = new spreadNS.Style();
style.font = 'bold Calibri 14px';
style.vAlign = spreadNS.VerticalAlign.center;
sheet.getRange(0, 0, 1, 11).setStyle(style);
const style2 = new spreadNS.Style();
style2.vAlign = spreadNS.VerticalAlign.center;
style2.hAlign = spreadNS.HorizontalAlign.center;
sheet.getRange(1, 4, 2, 2).setStyle(style2);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="spreadjs culture" content="zh-cn" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script>
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script type="module" src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" style="width:100%; height: 100%"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
