npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@file-viewer/renderer-spreadsheet

v3.3.5

Published

Standalone spreadsheet renderer plugin for File Viewer powered by styled-exceljs and e-virt-table.

Readme

@file-viewer/renderer-spreadsheet

English · 简体中文

Flyfish File Viewer 的独立表格 renderer 包。它基于 styled-exceljs 与 e-virt-table 提供 XLSX、XLSM、XLSB、XLS、CSV、TSV、ODS、FODS、Numbers 等表格文件的浏览器端预览,并通过 File Viewer 统一的 asset manifest 解析可选 Worker 路径,适合企业内网和离线部署。

用法

import FileViewer from '@file-viewer/vue3'
import { spreadsheetRenderer } from '@file-viewer/renderer-spreadsheet'

const options = {
  rendererMode: 'replace',
  renderers: spreadsheetRenderer,
}

也可以和其他 renderer 一起组合:

import { pdfRenderer } from '@file-viewer/renderer-pdf'
import { spreadsheetRenderer } from '@file-viewer/renderer-spreadsheet'

const options = {
  rendererMode: 'replace',
  renderers: [pdfRenderer, spreadsheetRenderer],
}

能力边界

  • 支持 .xlsx、.xltx、.xlsm、.xlsb、.xls、.xlt、.xltm、.csv、.tsv、.ods、.fods、.numbers。
  • CSV / TSV 默认自动识别 UTF-8(含 BOM)与 GBK / GB18030;遇到来源编码已知的文件时,可通过 options.spreadsheet.textEncoding 固定为 utf-8、gbk 或 gb18030。
  • 默认 options.spreadsheet.worker: 'auto':小文件走主线程兼容路径,大文件达到 options.spreadsheet.workerAutoThreshold(默认 1MB)后自动尝试静态 Worker。
  • 可以通过 options.spreadsheet.worker: true 强制启用静态 Worker,通过 worker: false 关闭自动启用;静态路径特殊时配置 options.spreadsheet.workerUrl。
  • 支持多 sheet、横向滚动标签栏、合并单元格、列宽/行高、边框、填充、对齐、文本颜色、Office 365 / WPS 单元格内嵌图片、workbook drawing 图片、图片双击大图预览、统一缩放 provider 和可选表头拖拽调整列宽。
  • XLSX drawing 中的 TIFF 图片会按需加载 MIT 许可的 UTIF.js,在浏览器内转换为 PNG;普通表格不会加载 TIFF 解码器。
  • 表格使用虚拟渲染,适合交互预览;完整打印按钮通常由上层能力判断隐藏,避免只打印当前视口。
  • XLSX 保留文件保存的默认列宽、显式列宽和以磅记录的行高;CSV/TSV 继续按内容调整列宽,大文本解析避免重复创建完整 UTF-8 字节数组。
  • 列宽单位以工作簿 Normal 样式为基准。宋体、新宋体的数字宽度先从磅转换为像素,再进行取整;尚未测定的自定义字体沿用标准回退,实际尺寸可能受字体影响。

小内容 Excel 填满视口

options.spreadsheet.fillViewport 默认 true,适用于 Excel、CSV / TSV 等表格格式。按工作表默认行高、列宽补充空白列标题(A / B / …)、行号和网格,让小表或空 Sheet 填满当前预览区域。容器 resize、缩放和切 Sheet 时重新计算,补充部分沿用虚拟画布,不生成整张 Excel 空表,不拉伸已有单元格,也不改变工作簿数据。设为 false 可只显示已用区域。

const options = {
  rendererMode: 'replace',
  renderers: spreadsheetRenderer,
  spreadsheet: { fillViewport: false }, // 可选:只显示已用区域。
}

补充部分只用于显示,不改变工作簿数据、used-range、原文件下载/导出、搜索结果或内容统计。

行号与旧记录序号

左侧编号现在默认使用源表格行号:表头为第 1 行,下一行为第 2 行,与 Sales!A2 等 A1 地址一致。旧版本会猜测首行是否为字段头,并可能不显示首行编号。需要保留旧显示方式时,请显式设置:

const options = {
  spreadsheet: { rowNumberMode: 'legacy-records' },
}

rowNumberMode: 'source' 为默认值。legacy-records 模式的编号栏以 # 标识,显示的是记录序号,不是源单元格地址。它保留原启发式:至少两行、首个加载窗口中没有合并单元格、首行有足够的非空文本单元格且第二行至少有两个值时,首行不编号,后续从 1 开始。普通纯文本数据和负数字符串也可能被误判为字段头;这个显式兼容模式保留旧行为,并不保证正确识别表头。空行与隐藏行不会被压缩重编号;首窗口有合并单元格时不偏移,后续窗口中的合并不会触发重新编号。

两种模式均保留首行及全部数据。搜索标签仍使用源 A1 地址,公开 spreadsheet range 仍使用从零开始的源坐标;窗口加载、切换工作表、视口空白补齐和原文件下载均不改变坐标。该选项只改变左侧编号;需要读取单元格地址时请使用 source。

离线资产

默认可选 Worker 路径为:

  • vendor/xlsx/sheet.worker.js

私有化部署时可以通过 options.spreadsheet.workerUrl 覆盖。官方 Vite 插件和 Demo worker 构建脚本会从本包的 worker 入口生成该文件。

迁移说明

表格预览已经从 @file-viewer/core 中彻底移出,core 只保留资产 manifest、类型和兼容错误提示,不再默认安装 styled-exceljs、e-virt-table 或 tinycolor2。完整表格能力请安装本包并传入 renderers,或直接使用 @file-viewer/preset-all。

未保存计算结果的公式

优先保留文件已保存的公式结果,包括真实的零值。导出器未保存计算结果时,预览可在离线、受限的运算预算内补算本表/跨表引用、区域、算术/比较,以及 IF、ROUND、ROW、SUM,并保留单元格数字格式;主线程和 Worker 使用同一逻辑。

这不是完整的 Excel 计算引擎。循环引用、外部引用、不支持或超出预算的公式,会直接显示原始 =公式 文本,不再伪装成零。不会执行 JavaScript 或请求远程公式资源。