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

您是否在使用 Java 將 Excel 轉換為 HTML 時，苦於 convert Excel to 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 以上。

什麼是「convert Excel to HTML」？

將 Excel 轉換為 HTML 會把 .xlsx 活頁簿轉換成可在網頁上顯示的 HTML 頁面，同時保留原始的版面配置、儲存格樣式、公式與資料。產生的 HTML 可在任何現代瀏覽器中直接開啟，無需安裝 Microsoft Office，十分適合用於網站入口、報表儀表板與協作平台。

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

渲染隱藏的列與欄位可確保活頁簿中所有資訊皆在 HTML 輸出中可見，這對於稽核、資料分析與教學情境尤為重要。透過顯示隱藏儲存格，可避免意外遺失資料，確保下游使用者看到的資料集與來源檔案完全一致。

前置條件

必要的函式庫與相依性

實作此功能時，您需要將 GroupDocs.Viewer for Java 作為 Maven 相依性加入。此函式庫負責將文件渲染為 HTML、PDF 以及影像格式。

環境設定需求

  • Java Development Kit (JDK)：8 版或更新版本
  • 整合開發環境 (IDE)：IntelliJ IDEA、Eclipse 或任何支援 Java 的 IDE
  • 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，並確保隱藏的列與欄位能被顯示的流程如下：使用 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. 資料分析 – 在導出至網頁儀表板時保留完整資料集。
  3. 教學工具 – 為學生提供完整的試算表內容，便於學習公式與資料結構。

效能考量

  • GroupDocs.Viewer 支援 50+ 種文件格式，且可在不將整個檔案載入記憶體的情況下處理上百頁的活頁簿，保持低記憶體使用率。
  • 對於極大型的 Excel 檔案，請留意 JVM 堆積大小，必要時調整 -Xmx 參數。
  • 將輸出檔案儲存於高速 SSD 上，以降低 I/O 延遲。
  • 保持函式庫為最新版本；每一次發行皆包含效能優化與錯誤修正。

結論

在本教學中，您已學會如何 convert Excel to 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());
}

相關教學