在 Java 中使用 GroupDocs.Viewer 隱藏 Excel 文字溢出

當您在將試算表轉換為 HTML 時 hide text overflow Excel 單元格，結果會顯得乾淨且專業。在本教學中，您將學習如何設定 GroupDocs.Viewer for Java，使任何超出單元格邊界的內容被直接隱藏。此技術非常適合網站入口、報表儀表板以及任何需要整齊版面的情境。

在 Java 中使用 GroupDocs.Viewer 調整 Excel 試算表文字溢出

快速解答

What does “hide text overflow excel” do? 它在 HTML 渲染期間抑制任何超出單元格寬度或高度的內容。
Which library handles this? GroupDocs.Viewer for Java 提供 TextOverflowMode.HIDE_TEXT 選項。
Do I need a license? 可取得臨時授權供評估使用；正式環境需購買完整授權。
Can I also convert Excel to HTML? 可以 — 同一個 viewer 會在套用溢出設定的同時將 Excel 檔案轉換為 HTML。
Is this approach suitable for large workbooks? 絕對適用，只需遵循「Performance considerations」章節中的效能建議。

什麼是 hide text overflow Excel？

Hide text overflow Excel 是一種渲染模式，指示 viewer 在將 Excel 工作表轉換為 HTML 時，截斷任何會超出定義單元格邊界的文字。此方式可保持版面整潔，特別是於瀏覽器中顯示的儀表板或報告。

為何使用 GroupDocs.Viewer 轉換 Excel 為 HTML？

GroupDocs.Viewer 支援 100+ 種文件格式，且能在一般伺服器上於 8 秒內將 500 頁的 Excel 活頁簿渲染為 HTML，且不需 Microsoft Office。其伺服器端引擎提供精細的控制——例如隱藏溢出文字——同時保持記憶體使用量低（大多數大型活頁簿低於 200 MB）。

前置條件

Java Development Kit (JDK) – 版本 8 或更新。
Maven – 用於相依管理。
基本的 Java 知識與 IDE（IntelliJ IDEA、Eclipse 等）。

設定 GroupDocs.Viewer for Java

將 viewer 函式庫加入您的 Maven 專案。

Maven 相依性

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

取得授權

取得臨時授權以解鎖所有功能：

Free trial：從 GroupDocs Releases 下載最新版本。
Temporary license：透過 GroupDocs Temporary License Page 申請。
Purchase：於 GroupDocs Purchase Page 購買完整授權。

如何使用 Java 轉換 Excel 為 HTML

Viewer 是 GroupDocs.Viewer 的主要類別，用於載入文件並渲染為目標格式。
若要使用 GroupDocs.Viewer for Java 將 Excel 活頁簿轉換為 HTML，請建立指向 .xlsx 檔案的 Viewer 實例，使用 HtmlViewOptions 並設定 SpreadsheetOptions.setTextOverflowMode(TextOverflowMode.HIDE_TEXT)，然後呼叫 viewer.view(htmlOptions)。viewer 會為每個工作表產生 HTML 頁面，並自動套用隱藏溢出設定。

步驟 1：定義輸出目錄

指定渲染出的 HTML 檔案儲存位置。

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

說明：Utils.getOutputDirectoryPath 會在專案的輸出資料夾內建立（或重用）名為 YOUR_OUTPUT_DIRECTORY 的資料夾。

步驟 2：設定頁面檔案路徑

為每個產生的 HTML 頁面建立命名模式。

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

說明：{0} 為占位符，viewer 會以頁碼取代，產生如 page_1.html、page_2.html 等檔案。

步驟 3：設定 HtmlViewOptions

HtmlViewOptions 為設定類別，定義 viewer 如何將文件渲染為 HTML，包含資源處理與樣式選項。
指示 viewer 嵌入資源並隱藏溢出的單元格文字。

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT);

說明：TextOverflowMode.HIDE_TEXT 是關鍵設定，可在 render excel as html 過程中 prevent overflow in excel 單元格。

步驟 4：渲染文件

使用已設定的選項執行 viewer。

Definition anchor：Viewer 為 GroupDocs.Viewer 的核心類別，負責讀取來源文件並產生目標格式的輸出。

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_XLSX_WITH_TEXT_OVERFLOW)) {
    viewer.view(viewOptions);
}

說明：view 方法會讀取範例活頁簿，套用溢出規則，並將 HTML 檔案寫入先前定義的資料夾。

如何防止 Excel 文字溢出

HtmlViewOptions 是控制 viewer HTML 渲染設定的配置物件。
必須在呼叫 viewer.view(...) 之前執行 viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT)，以確保每個工作表遵守隱藏溢出規則。若需要工作表層級的控制，也可以在個別的 SpreadsheetOptions 物件上設定此旗標。同一個 TextOverflowMode.HIDE_TEXT 旗標在工作表層級同樣有效，提供精確的控制。

如何將 Excel 渲染為 HTML

HtmlViewOptions 為設定類別，定義 viewer 如何將文件渲染為 HTML，包含資源處理與樣式選項。
使用 HtmlViewOptions 指定資源是嵌入還是外部，透過 setCustomCss 設定自訂 CSS 字串，並使用 setImageResolution 調整影像解析度。將這些設定與 TextOverflowMode.HIDE_TEXT 結合，即可產生符合品牌指南且在各頁面保持一致樣式的精緻 HTML 輸出。

如何在大型活頁簿中隱藏 Excel 溢出

透過迴圈 viewer.getDocumentInfo().getPages()，對每個頁面分別呼叫 viewer.view 來單獨渲染每個工作表，然後將結果存入快取。此方式可減少記憶體壓力，並加速對同一活頁簿的重複請求。務必使用 try‑with‑resources 關閉 Viewer 實例，以即時釋放原生資源。

常見使用情境與好處

Web portals – 顯示財務表格時避免長字串破壞版面。
Data analytics dashboards – 透過隱藏多餘文字，使大型資料集保持可讀性。
Customer reporting – 提供乾淨、適合列印的 HTML 報告。

透過使用 hide text overflow Excel，您可確保視覺呈現於各瀏覽器與裝置上保持一致。

效能考量

Memory management – 立即釋放 Viewer 實例（如 try‑with‑resources 所示）。
Embedded resources – 嵌入圖片與樣式可減少 HTTP 請求次數，但會增加 HTML 大小；請依頻寬限制選擇適當模式。
Caching – 為常被存取的活頁簿儲存已渲染的 HTML，以避免重新處理。

得益於其串流架構，GroupDocs.Viewer 能在 12 秒內處理 300 工作表的活頁簿，且峰值記憶體低於 250 MB。

常見問題與解決方案

Viewer not releasing memory – 確認使用了 try‑with‑resources 模式；Viewer 實作 AutoCloseable。
Overflow still appears – 再次確認已在 before viewer.view(viewOptions) 前呼叫 viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT);。
Missing styles – 若將資源從嵌入切換為外部，請確保 HTML 頁面連結至產生的 CSS 檔案。

常見問答

Q: What is GroupDocs.Viewer for Java?
A: 它是一個 Java 函式庫，可將超過 100 種文件格式（包括 Excel）渲染為 HTML、PDF、PNG 等，且伺服器上不需 Microsoft Office。

Q: How do I handle large Excel files with text overflow?
A: 如前所示使用 TextOverflowMode.HIDE_TEXT，並啟用快取或逐工作表處理檔案，以降低記憶體使用量。

Q: Can I customize the HTML output further?
A: 可以。HtmlViewOptions 提供多項設定——如自訂 CSS、影像處理與頁面尺寸控制——讓您依品牌需求調整 HTML。

Q: What are common pitfalls when using this feature?
A: 忘記釋放 Viewer 實例，或在 viewer.view 之後才設定溢出選項，會導致記憶體洩漏或隱藏無效。

Q: Where can I get more help or examples?
A: 前往 GroupDocs Support Forum 取得社群協助與官方文件。

結論

依照上述步驟，您即可在使用 GroupDocs.Viewer for Java convert excel to html 時 hide text overflow Excel 單元格。此簡易設定可大幅提升渲染試算表的可讀性，且能無縫整合至基於 Web 的報告解決方案。

資源

Documentation: GroupDocs.Viewer Java Documentation
API reference: GroupDocs API Reference
Download: GroupDocs Downloads
Purchase: Buy GroupDocs License
Free trial: GroupDocs Free Trial
Temporary license: Request Temporary License

Last updated: 2026-09-05
Tested with: GroupDocs.Viewer 25.2 for Java
Author: GroupDocs