轉換 Excel 為 HTML 並在 Java 試算表中渲染隱藏的行與列，使用 GroupDocs.Viewer

您是否在使用 Java 將 Excel 轉換為 HTML 時，苦於無法在試算表中顯示隱藏的行與列？您並不孤單！許多開發人員在嘗試在不同格式之間保持資料可視化完整性時，都會遇到此挑戰。本教學將指導您如何使用 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 頁面，同時保留原始的版面配置、樣式與資料。這讓您能在瀏覽器中直接顯示試算表，而無需 Microsoft Office。

為什麼要渲染隱藏的試算表資料？

顯示隱藏的試算表資料是必要的情況包括：

  • 財務報告：需要完整的稽核軌跡，包括為了呈現而隱藏的行/列。
  • 資料分析：工具需要完整的資料集以進行精確計算。
  • 教育資源：需要每個儲存格皆可見，以便教學公式與資料結構。

前置條件

必要的函式庫與相依性

要實作此功能，請確保在專案中加入 GroupDocs.Viewer for Java 作為相依性。此函式庫對於將文件渲染為 HTML、PDF 以及影像檔等多種格式至關重要。

環境設定需求

  • Java Development Kit (JDK)：版本 8 或更新版本
  • Integrated Development Environment (IDE)：例如 IntelliJ IDEA 或 Eclipse
  • Maven：用於管理專案相依性

知識前提

需要具備 Java 程式設計的基礎知識。此外，熟悉 Maven 對於設定專案也會有所幫助。

設定 GroupDocs.Viewer for Java

要在 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 時，如何確保隱藏的行與列也能顯示。

步驟 1：定義輸出目錄路徑

首先定義渲染檔案的儲存位置：

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

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

步驟 2：設定 HTMLViewOptions

接著，設定 HtmlViewOptions 以將資源直接嵌入產生的 HTML 檔案中：

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);

步驟 3：啟用隱藏列與行的渲染

設定 SpreadsheetOptions 以渲染隱藏的元素：

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

步驟 4：使用文件初始化 Viewer 並渲染

最後，使用文件路徑初始化 GroupDocs.Viewer 並渲染內容：

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());
}

故障排除提示：確保路徑正確設定，且相依性已正確加入您的 pom.xml。

實務應用

以下是此功能的實務應用：

  1. 財務報告：確保所有資料（包括隱藏的財務指標）在轉換時皆可見，以符合合規要求。
  2. 資料分析：透過在報告或簡報中顯示所有行與列，維持資料集的完整性。
  3. 教育工具：使用完整的試算表內容進行教學，避免遺失隱藏資訊。

效能考量

使用 GroupDocs.Viewer 時，為了最佳化效能：

  • 監控記憶體使用情況，尤其是大型文件。
  • 優化檔案路徑與儲存位置，以減少 I/O 操作。
  • 定期更新函式庫，以利用新的效能提升與錯誤修正。

結論

在本教學中，您已學會如何 將 Excel 轉換為 HTML，以及如何設定 GroupDocs.Viewer for Java 以在試算表中渲染隱藏的行與列。依循這些步驟，即可確保跨格式的資料完整可見。接下來，您可以嘗試不同的文件類型，並探索 GroupDocs.Viewer 所提供的其他功能。

準備好深入探索了嗎？試著在您的專案中實作此功能，看看它如何提升應用程式的功能性！

常見問答

Q1: 我可以免費使用 GroupDocs.Viewer 嗎？
A1: 是的，您可以從官方網站下載試用版以探索功能。若需無限制的完整存取，請考慮取得臨時或永久授權。

Q2: GroupDocs.Viewer 支援哪些檔案格式？
A2: 它支援超過 50 種不同的文件格式，包括 PDF、Word、Excel 以及影像檔。

Q3: 如何使用 GroupDocs.Viewer 處理大型文件？
A3: 透過調整 Java 設定來優化記憶體管理，必要時將大型檔案切分為較小的部分。

Q4: 是否可以自訂 HTML 輸出格式？
A4: 可以，您可以使用 HtmlViewOptions 設定各種選項，以調整渲染文件的外觀。

Q5: 解決 GroupDocs.Viewer 問題的最佳方法是什麼？
A5: 查閱官方文件與論壇以尋找解決方案。確保所有相依性在專案設定中正確配置。

常見問題

Q: 啟用 setRenderHiddenColumns(true) 會影響效能嗎？
A: 渲染隱藏列會產生少量額外負擔，但對於一般工作簿影響甚微。對於非常大的工作表，請監控記憶體使用情況。

Q: 我可以將 XLSX 檔案轉換為單一 HTML 頁面，而非多頁嗎？
A: 可以，您可以設定自訂的 HtmlViewOptions 檔名，且不使用 {0} 佔位符，以產生單一 HTML 檔案。

Q: 如何僅對特定工作表顯示隱藏的試算表資料？
A: 在啟用隱藏渲染之前，使用 viewOptions.getSpreadsheetOptions().setWorksheetIndexes(...) 來指定目標工作表。

Q: 轉換後是否有方法隱藏工具列或導覽？
A: GroupDocs.Viewer 產生的 HTML 輸出是靜態的；若自訂模板，您可以手動移除任何導覽元素。

Q: 需要哪個版本的 GroupDocs.Viewer 才能支援隱藏列/行的渲染？
A: 此功能自 22.0 版起提供；建議使用最新的穩定版。

資源

最後更新： 2026-03-27
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs