如何在 Java 中使用 GroupDocs.Viewer 從 Excel 產生 HTML

如果您需要快速 從 Excel 產生 HTML，且只顯示工作簿中重要的部分，渲染已定義的列印區域是最佳做法。本教學將帶您建立一個 Java 預覽解決方案，從 Excel 檔案中提取列印區域，並使用 GroupDocs.Viewer for Java 輸出乾淨、獨立的 HTML 頁面。您將了解此方法如何加快載入速度、減少頻寬使用，並保持 UI 整潔——非常適合入口網站、儀表板以及任何基於網頁的文件檢視器。

快速答案

• What does “generate HTML from Excel” mean? 這表示以程式方式將 Excel 工作簿轉換為可在瀏覽器中直接顯示的網頁 HTML 頁面，無需 Excel。
• Why render only the Excel print area? 它僅保留最相關的資料，減少渲染時間與頻寬使用。
• Do I need a license to try this? 可使用免費試用或臨時授權；正式環境需購買完整授權。
• Which Java version is supported? 支援 Java 8 或更新版本（建議使用 Java 11）。
• Can I embed the preview in a web page? 可以——使用 embedded‑resources 選項即可產生獨立的 HTML 頁面。

「generate HTML from Excel」是什麼？

Generate HTML from Excel 意味著將 XLSX 工作簿的視覺佈局轉換為瀏覽器可直接渲染的標準 HTML 標記。此技術讓您在 Web 應用程式中即時預覽試算表資料，無需在客戶端安裝 Microsoft Office。

為什麼只渲染 Excel 列印區域？

只渲染列印區域可產生較小的 HTML 負載，對於一般報表可提升高達 60 % 的載入速度。它同時隱藏可能包含敏感公式的內部工作表，提升安全性。透過聚焦使用者自訂的列印區域，您能提供更乾淨、更具目的性的檢視，符合作者的意圖。

前置條件

• GroupDocs.Viewer for Java v25.2 或更新版本（支援超過 70 種文件格式，且可在不將整個檔案載入記憶體的情況下處理最多 10,000 列的試算表）。
• 在開發機上安裝 Maven。
• JDK 8 或更新版本（建議使用 Java 11）。
• 任一 IDE（IntelliJ IDEA、Eclipse 或 VS Code）。

設定 GroupDocs.Viewer for Java

將 GroupDocs 的儲存庫與相依性加入您的 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>

取得授權

先使用 免費試用 或申請 臨時授權 進行評估。當您準備好投入正式環境時，請購買完整授權以解鎖全部功能並移除試用限制。

基本初始化

Viewer 是負責載入文件並驅動渲染流程的核心類別。以下是使用 GroupDocs.Viewer 開啟試算表所需的最小程式碼：

import com.groupdocs.viewer.Viewer;

// Initialize Viewer object with the path to your spreadsheet
try (Viewer viewer = new Viewer("path/to/your/spreadsheet.xlsx")) {
    // Further configurations will be discussed in upcoming sections.
}

如何使用 GroupDocs.Viewer 將 XLSX 轉換為 HTML

本節說明如何使用 GroupDocs.Viewer 將 XLSX 工作簿轉換為僅顯示已定義列印區域的獨立 HTML 檔案。透過設定檢視選項並呼叫 viewer，您可以產生適合嵌入網頁或入口網站的輕量預覽。

以下為逐步說明，僅 渲染 Excel 列印區域，產生獨立的 HTML 檔案。

步驟 1：定義輸出目錄與檔案路徑格式

首先，告訴 viewer 要將產生的 HTML 頁面寫入哪個位置。

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

// Set the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

// Define a file path format for the rendered pages
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

說明: outputDirectory 為儲存所有預覽檔案的資料夾。pageFilePathFormat 使用佔位符（{0}），viewer 會以頁碼取代該佔位符。

步驟 2：設定 HTML 檢視選項以渲染列印區域

HtmlViewOptions 控制 HTML 的產生方式。forEmbeddedResources 會為每頁建立單一 HTML 檔，內含所有 CSS/JS 內嵌，簡化部署。forRenderingPrintArea() 告訴引擎僅 渲染 Excel 列印區域。

import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

// Configure HTML view options with embedded resources and print area rendering
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintArea());

說明: HtmlViewOptions.forEmbeddedResources 為每頁建立單一 HTML 檔，內含所有 CSS/JS 內嵌，簡化部署。forRenderingPrintArea() 告訴引擎僅 渲染 Excel 列印區域。

步驟 3：載入試算表並渲染

最後，將 viewer 指向您的工作簿並呼叫渲染程序。

// Replace with your actual document path
Path documentPath = Paths.get("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_PRINT_AREAS.xlsx");

try (Viewer viewer = new Viewer(documentPath.toString())) {
    // Render to HTML using the configured view options
    viewer.view(viewOptions);
}

說明: view() 方法依照我們設定的選項處理工作簿，輸出僅顯示列印區域的 HTML 檔案。

常見問題與解決方案

• File‑path errors: 請再次確認路徑是絕對路徑或相對於專案工作目錄的正確相對路徑。
• Permission problems: 確認 Java 程序對來源檔案具有讀取權限，且對輸出資料夾具有寫入權限。
• Missing print areas: 確認試算表已定義列印區域（Excel 中的「頁面布局」→「列印區域」）。

實務應用

1. Document management systems: 為最終使用者顯示不需載入整個工作簿的乾淨報告預覽。
2. Financial dashboards: 自動產生標記為列印區域的關鍵財務表格的 HTML 快照。
3. Learning platforms: 為學生提供聚焦於作業資料的檢視。
4. CRM portals: 突顯客戶指標，同時隱藏內部工作表。
5. Data‑science notebooks: 在文件中嵌入簡潔的試算表預覽。

效能技巧

• Memory tuning: 對於非常大的工作簿，請增加 JVM 堆積大小（例如 -Xmx2g 或更高）。
• Lazy loading: 若只需前幾頁，可在達到所需頁數後停止渲染。
• Parallel processing: 使用獨立的 Viewer 實例（每個執行緒）同時渲染多個工作簿。

如何在不使用列印區域的情況下預覽試算表

SpreadsheetOptions 用於設定試算表的渲染行為，包括是否限制輸出為已定義的列印區域。若之後想顯示整個工作簿，只需省略 SpreadsheetOptions.forRenderingPrintArea() 呼叫，改用預設的 SpreadsheetOptions。這樣會渲染每個工作表與儲存格，提供完整的 convert XLSX to HTML 預覽，包含原始檔案中的所有資料、公式與格式。

結論

您現在已學會如何在 Java 中 從 Excel 產生 HTML，同時僅渲染試算表的已定義列印區域。此技術讓預覽更快速、乾淨且更安全——非常適合現代 Web 與企業應用。

後續步驟

• 嘗試使用 PdfViewOptions 或 PngViewOptions 產生其他檢視格式（PDF、PNG）。
• 結合預覽產生與驗證機制，以保護敏感資料。
• 探索完整的 SpreadsheetOptions API，以自訂頁面尺寸、格線等功能。

常見問答

Q: 僅渲染 Excel 列印區域的主要好處是什麼？
A: 它可減少雜訊並加快渲染速度，提供聚焦的預覽，突顯最重要的資料。

Q: 我可以同時渲染非列印工作表嗎？
A: 可以——省略 SpreadsheetOptions.forRenderingPrintArea()，使用預設選項即可渲染整個工作簿。

Q: GroupDocs.Viewer 支援其他試算表格式嗎？
A: 它支援 XLS、XLSX、CSV、ODS 等多種格式。請參閱官方文件取得完整清單。

Q: 如何提升對非常大檔案的渲染速度？
A: 增加 JVM 堆積大小、僅渲染所需頁面，並考慮多執行緒處理。

Q: 我的列印區域未顯示——應該檢查什麼？
A: 確認來源檔案已定義列印區域（Excel → 頁面布局 → 列印區域），且使用最新的 GroupDocs.Viewer 版本。

資源

• Documentation: GroupDocs.Viewer Java Documentation
• API reference: GroupDocs API Reference
• Download: Get GroupDocs.Viewer for Java
• Purchase: Buy a License
• Free trial: Start with a Free Trial
• Temporary license: Request Here
• Support: GroupDocs Forum

最後更新: 2026-09-15
測試環境: GroupDocs.Viewer for Java 25.2
作者: GroupDocs

相關教學

• 如何使用 GroupDocs.Viewer Java 將 Excel 轉換為 HTML、JPG、PNG 與 PDF
• excel to html java：使用 GroupDocs.Viewer 跳過渲染空白列
• 如何使用 GroupDocs.Viewer 在 Java 中將 Excel 轉換為 HTML 並渲染隱藏列與欄