将 Excel 转换为 HTML 并在 Java 电子表格中使用 GroupDocs.Viewer 渲染隐藏的行和列

您是否在使用 Java 将 Excel 转换为 HTML 时，难以可视化电子表格中的隐藏行和列？您并不孤单！许多开发者在尝试在不同格式之间保持数据可视化完整性时都会遇到此挑战。本教程将指导您如何使用 GroupDocs.Viewer for Java 有效地在电子表格中渲染隐藏的行和列，确保在转换过程中不会丢失任何关键信息。

使用 GroupDocs.Viewer for Java 渲染隐藏的行和列

使用 GroupDocs.Viewer for Java 渲染隐藏的行和列

快速答案

  • GroupDocs.Viewer 能将 Excel 转换为 HTML 吗？ 是的，它提供开箱即用的支持，可将 XLSX 文件转换为 HTML。
  • 隐藏的行和列会在 HTML 输出中可见吗？ 当您启用相应选项时，隐藏的数据会像可见单元格一样渲染。
  • 需要哪个 Maven 构件？ com.groupdocs:groupdocs-viewer (建议使用最新版本)。
  • 生产使用需要许可证吗？ 生产环境需要永久许可证；可使用免费试用版或临时许可证进行评估。
  • 此方法兼容 Java 8 及更高版本吗？ 完全兼容——它支持 JDK 8 及以上版本。

什么是“将 Excel 转换为 HTML”？

将 Excel 转换为 HTML 会将 .xlsx 工作簿转换为可在网页上显示的 HTML 页面，同时保留原始布局、单元格样式、公式和数据。生成的 HTML 可在任何现代浏览器中显示，无需安装 Microsoft Office，非常适合用于 Web 门户、报告仪表板和协作平台。

为什么要渲染隐藏的电子表格数据？

渲染隐藏的行和列可确保工作簿中存储的每一条信息在 HTML 输出中可见，这对于审计、数据分析和教学场景至关重要。通过暴露隐藏的单元格，您可以避免意外的数据丢失，并确保下游使用者看到的完整数据集与源文件完全一致。

前置条件

必需的库和依赖项

要实现此功能，您需要将 GroupDocs.Viewer for Java 作为 Maven 依赖项。该库负责将文档渲染为 HTML、PDF 和图像格式。

环境设置要求

  • Java Development Kit (JDK)：版本 8 或更高
  • Integrated Development Environment (IDE)：IntelliJ IDEA、Eclipse 或任何兼容 Java 的 IDE
  • Maven：用于依赖管理

知识前提

扎实的 Java 基础知识和基本的 Maven 使用经验将帮助您顺利完成以下步骤。

为 Java 设置 GroupDocs.Viewer

要在 Java 应用程序中开始使用 GroupDocs.Viewer，您需要通过 Maven 添加该库。

Maven
将以下配置添加到您的 pom.xml 文件中：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

获取许可证的步骤

  • 免费试用 – 下载试用版以评估所有功能。
  • 临时许可证 – 在开发期间请求限时许可证以获得完整功能访问。
  • 购买 – 获取永久许可证，以在生产环境中无限制使用。

在设置好 Maven 并获取许可证后，您可以开始初始化 GroupDocs.Viewer。以下是具体步骤：

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        // Initialize the viewer with your license file if available.
        try (Viewer viewer = new Viewer("path/to/your/document.xlsx")) {
            // Your code here...
        }
    }
}

如何在保留隐藏数据的情况下将 Excel 转换为 HTML

要将 Excel 工作簿转换为 HTML 并确保隐藏的行和列可见，您需要使用 GroupDocs.Viewer 加载文件，配置 SpreadsheetOptions 以渲染隐藏元素，设置 HtmlViewOptions 以获得所需的输出格式，然后调用 viewer 生成 HTML 文件。请按照以下步骤操作。

步骤 1：定义输出目录路径

指定生成的 HTML 文件将保存的文件夹：

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderHiddenRowsAndColumns");

步骤 2：配置 HTML 视图选项

HtmlViewOptions 控制 HTML 文件的生成方式，包括资源是嵌入还是保存为独立文件。
HtmlViewOptions 类是 GroupDocs.Viewer 中进行 HTML 渲染的核心配置对象。

步骤 3：启用隐藏列和行的渲染

SpreadsheetOptions 允许您在转换期间切换隐藏行和列的可见性。
SpreadsheetOptions 是设置容器，决定如何处理电子表格特定功能——如隐藏单元格、网格线和工作表选择。

步骤 4：使用文档初始化 Viewer 并渲染

Viewer 类是 GroupDocs.Viewer 中用于渲染文档的主要组件。
创建 Viewer 实例，传入 Excel 文件路径，并使用准备好的选项调用 view 方法。
Viewer 类是 GroupDocs.Viewer 的入口点；它读取源文档并生成请求的输出格式。

import com.groupdocs.viewer.options.HtmlViewOptions;

// Create a file path format for rendering each page.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

实际应用

  1. 财务报告 – 确保审计轨迹包含所有隐藏指标，以满足合规要求。
  2. 数据分析 – 在导出到基于 Web 的仪表板时保留完整数据集。
  3. 教育工具 – 为学生提供完整的电子表格内容，以学习公式和数据结构。

性能考虑因素

  • GroupDocs.Viewer 支持转换 50+ 种文档格式，并且可以在不将整个文件加载到内存中的情况下处理数百页的工作簿，从而保持低内存使用。
  • 对于非常大的 Excel 文件，请监控 JVM 堆大小；如有必要，增加 -Xmx 参数。
  • 将输出文件存储在高速 SSD 上以降低 I/O 延迟。
  • 保持库的最新版本；每个发布都包含性能优化和错误修复。

结论

在本教程中，您学习了如何 将 Excel 转换为 HTML 并配置 GroupDocs.Viewer for Java 以在电子表格中渲染隐藏的行和列。通过遵循上述步骤，您可以确保每个单元格——无论可见还是隐藏——都在 HTML 输出中得到呈现，实现跨平台的完整数据可视化。您还可以尝试自定义 CSS 或单页输出等额外选项，以进一步满足应用需求。

准备深入了解了吗？在您的项目中实现此功能，看看它如何提升应用程序的功能！

常见问题解答

Q1：我可以免费使用 GroupDocs.Viewer 吗？
A1：是的，您可以从官方网站下载试用版以体验功能。若需无限制的完整访问，请考虑获取临时或永久许可证。

Q2：GroupDocs.Viewer 支持哪些文件格式？
A2：它支持超过 50 种不同的文档格式，包括 PDF、Word、Excel、PowerPoint 和常见的图像类型。

Q3：如何使用 GroupDocs.Viewer 处理大型文档？
A3：通过调整 Java 堆设置来优化内存管理，如有必要，在渲染前将大型工作簿拆分为更小的块。

Q4：可以自定义 HTML 输出格式吗？
A4：是的，您可以使用 HtmlViewOptions 配置各种选项，以定制外观、嵌入资源或生成单页 HTML 文件。

Q5：排查 GroupDocs.Viewer 问题的最佳方法是什么？
A5：查阅官方文档和社区论坛，确保所有 Maven 依赖与库版本匹配，并启用详细日志以捕获详细错误信息。

常见问答

Q：启用 setRenderHiddenColumns(true) 会影响性能吗？
A：渲染隐藏列会带来少量开销，但对典型工作簿的影响很小。对于非常大的工作表，请监控内存使用并考虑增加 JVM 堆大小。

Q：我可以将 XLSX 文件转换为单个 HTML 页面而不是多个页面吗？
A：可以，在 HtmlViewOptions 中设置不含 {0} 占位符的自定义文件名，即可生成包含所有工作表的单个 HTML 文件。

Q：如何仅对特定工作表显示隐藏的电子表格数据？
A：在启用隐藏渲染之前，使用 viewOptions.getSpreadsheetOptions().setWorksheetIndexes(...) 指定目标工作表。

Q：转换后是否可以隐藏工具栏或导航？
A：GroupDocs.Viewer 生成的 HTML 输出是静态的；您可以通过编辑生成的模板或使用自定义 CSS 手动移除导航元素。

Q：隐藏行/列渲染需要哪个版本的 GroupDocs.Viewer？
A：该功能自 22.0 版本起可用；我们建议使用最新的稳定版本（当前为 25.2）以获得最佳性能和支持。

资源

最后更新： 2026-09-20
测试环境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs

// Enable rendering of hidden columns and rows.
viewOptions.getSpreadsheetOptions().setRenderHiddenColumns(true);
viewOptions.getSpreadsheetOptions().setRenderHiddenRows(true);

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_ROW_AND_COLUMN")) {
    // Render the document to HTML using the specified view options.
    viewer.view(viewOptions);
} catch (Exception e) {
    System.out.println("Error rendering document: " + e.getMessage());
}

相关教程