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

當您在將試算表轉換為 HTML 時 隱藏 Excel 文字溢出 單元格，結果會顯得乾淨且專業。在本教學中，我們將逐步說明如何防止文字雜亂溢出，使用 GroupDocs.Viewer for Java。您將看到如何設定檢視器、嵌入資源，以及渲染 Excel 活頁簿，使任何超出單元格邊界的文字都會被隱藏。

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

快速解答

  • 「hide text overflow excel」是什麼作用？ 它會在 HTML 渲染時抑制任何超出單元格寬度或高度的內容。
  • 哪個函式庫負責此功能？ GroupDocs.Viewer for Java 提供 TextOverflowMode.HIDE_TEXT 選項。
  • 我需要授權嗎？ 可取得臨時授權供評估使用；正式環境需購買完整授權。
  • 我也可以將 Excel 轉換為 HTML 嗎？ 可以——同一個檢視器在套用溢出設定的同時，將 Excel 檔案轉換為 HTML。
  • 此方法適用於大型活頁簿嗎？ 完全適用，只要遵循「效能考量」章節中的建議即可。

什麼是 hide text overflow excel？

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

為什麼使用 GroupDocs.Viewer 來將 Excel 轉換為 HTML？

GroupDocs.Viewer 提供快速的伺服器端解決方案，可 將 Excel 轉換為 HTML，且不需在伺服器上安裝 Microsoft Office。它支援廣泛的 Excel 功能，並讓您精細控制單元格的顯示方式——例如隱藏溢出的文字。

前置條件

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

設定 GroupDocs.Viewer for Java

將檢視器函式庫加入您的 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>

取得授權

取得臨時授權以解鎖全部功能：

實作指南

以下為逐步說明，保留原始程式碼區塊不變，並加入清晰的說明。

步驟 1：定義輸出目錄

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

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

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

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

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

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

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

步驟 3：設定 HtmlViewOptions

告訴檢視器嵌入資源並隱藏溢出的單元格文字。

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

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

步驟 4：渲染文件

使用配置好的選項執行檢視器。

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

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

常見使用情境與效益

  • Web 入口網站 – 顯示財務表格時避免長字串破壞版面。
  • 資料分析儀表板 – 透過隱藏多餘文字，使大型資料集保持可讀性。
  • 客戶報告 – 提供乾淨、適合列印的 HTML 報告。

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

效能考量

  • 記憶體管理 – 立即釋放 Viewer 實例（如使用 try‑with‑resources 所示）。
  • 嵌入資源 – 嵌入圖片與樣式可減少 HTTP 請求次數，但會增大 HTML 大小；請依頻寬需求選擇適當模式。
  • 快取 – 將常用活頁簿的渲染 HTML 儲存起來，以免重複處理。

常見問與答

Q1: GroupDocs.Viewer for Java 是什麼？
A1: 它是一個 Java 函式庫，可將超過 100 種文件格式（包括 Excel）渲染為 HTML、PDF、PNG 等，且不需在伺服器上安裝 Microsoft Office。

Q2: 如何處理帶有文字溢出的大型 Excel 檔案？
A2: 如範例所示使用 TextOverflowMode.HIDE_TEXT，並考慮啟用快取或將檔案分塊處理，以降低記憶體壓力。

Q3: 我可以進一步自訂 HTML 輸出嗎？
A3: 可以。HtmlViewOptions 提供多項設定，例如自訂 CSS、圖片處理與頁面大小控制。

Q4: 使用此功能時常見的陷阱是什麼？
A4: 忘記釋放 Viewer 實例，或使用預設的溢出模式（會顯示文字）而非 HIDE_TEXT。

Q5: 我可以在哪裡取得更多協助或範例？
A5: 前往 GroupDocs Support Forum 獲得社群協助與官方文件。

結論

依照上述步驟，您即可在使用 GroupDocs.Viewer for Java 將 excel 轉換為 html 時 隱藏 Excel 文字溢出 單元格。此簡單設定大幅提升渲染試算表的可讀性，且能無縫整合至基於 Web 的報告解決方案中。

資源

最後更新： 2025-12-18
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs