修復 Collabora 在線移動網頁視圖鍵盤遮擋文本的問題

如果在 Collabora Online 中，螢幕鍵盤遮擋了您正在編輯的段落、儲存格或搜尋框，請先確定問題出在哪裡：是文件編輯器、行動瀏覽器，還是將 Collabora 嵌入 WebView 的應用程式。在手機上，鍵盤可能會縮小頁面的可見區域，而無需調整頁面佈局中每個元素的大小。編輯器可能保持原有位置，而瀏覽器或宿主應用程式則會以不同的方式處理較小的可見區域。

在更改伺服器設定之前，請先進行以下檢查。快速比較相同文件在嵌入式視圖和獨立瀏覽器中的顯示效果，通常可以判斷問題是否出在文件託管服務。如果您負責維護 Android 應用程式或網站，請在新增自訂腳本之前，請檢查託管服務如何處理鍵盤和 WebView 的內邊距。

首先應該檢查什麼？

1. 儲存文檔，然後在同一部手機上使用最新版本的獨立瀏覽器重新開啟同一個文件。
2. 點擊相同的文字或電子表格輸入框，打開鍵盤，並注意遊標和文字是否仍然可見。
3. 在原始應用程式或嵌入式 Web 視圖中重複上述步驟。如果只有嵌入式版本失敗，請將宿主應用程式和 Web 檢視記錄下來，作為問題的一部分。
4. 嘗試旋轉手機或縮小一格螢幕。這些只是診斷性的臨時解決方案，並不能修復損壞的視窗。

Collabora 將 Online 描述為基於瀏覽器的版本，並表示支援當前主流瀏覽器；它還提供獨立的行動應用程式。這兩種方式存取文件的方式不同，因此請測試您實際使用的版本。請參閱Collabora Online 的產品資訊和Collabora 行動應用程式的資訊。操作：在變更設定之前，請在常用應用程式和獨立瀏覽器中比較相同文件、帳戶和輸入欄位。

為什麼鍵盤會遮住文字？

行動網頁包含佈局視口和視覺視窗。佈局視窗描述頁面的佈局區域，而視覺視窗則是目前螢幕上可見的部分。當虛擬鍵盤出現時，瀏覽器可能會縮小視覺視窗並捲動到焦點所在區域。具體行為因瀏覽器和嵌入環境而異。如果文件編輯器、瀏覽器或原生宿主程式沿用舊的視窗高度，則活動內容可能會被鍵盤遮擋。

MDN 的VisualViewport參考文件中記錄了這一差異。它解釋了底層 Web 行為，但並未顯示某個特定的 Collabora 版本存在已確認的缺陷。操作：使用獨立瀏覽器對比來確定問題是否會跨瀏覽器伴隨編輯器出現，還是僅出現在單一主機上。

修復有人編輯文檔的問題

1. 更新並重新開啟編輯上下文

安裝行動瀏覽器或宿主應用程式的可用更新，關閉文檔，然後重新開啟。這可以解決頁面狀態過時或版本特定問題，但不能保證修復視口錯誤。避免依賴在瀏覽器或作業系統更新期間一直保持開啟的快取標籤頁。操作：完全關閉並重新開啟後再次測試，如果鍵盤仍然隱藏遊標，請記下瀏覽器或應用程式版本。

2. 使用獨立瀏覽器作為對比或臨時解決方案。

如果 Collabora 是從雲端儲存應用程式、電子郵件用戶端或自訂入口網站開啟的，請使用該服務的「在瀏覽器中開啟」選項（如有）。如果文字在獨立瀏覽器中仍然可見，則很可能是套用的嵌入式 WebView 或其原生螢幕佈局的問題。如果兩種方式都出現相同的問題，則問題可能出在瀏覽器引擎、作業系統、編輯器版本或特定的 Collabora 控制項上。

不要以為獨立瀏覽器永遠是最佳解決方案：主機可能用於身份驗證或檔案保存。操作：使用能保持遊標可見以便緊急編輯的路由，並將比較結果報告給服務或應用程式維護者。

3. 工作時要騰出更多空間

作為短期解決方法，您可以將裝置旋轉到橫屏模式，稍微降低頁面縮放比例，捲動文件使當前段落顯示在螢幕上的更高位置，或在編輯間隙關閉鍵盤。在 Calc 中，公式輸入區域或儲存格編輯控制項的行為可能與在網格中直接編輯不同，因此請測試導致隱藏的特定控制項。這些步驟可以使焦點內容可見，但並不能證明應用程式的視口處理方式正確。

操作：每次嘗試其他方法後，重複相同的編輯操作，並檢查是否能看到插入點及其周圍的文字。如果只有一個工具列字段或搜尋框被遮擋，請具體報告該字段，而不是將整個文件描述為無法使用。

這是 Collabora 已知的問題嗎？

最近一些 Collabora 的報告描述了鍵盤彈出時移動控制會被隱藏的情況，但這些情況與特定設備、應用版本和工作流程相關。例如，2026 年 9 月的一份報告描述了 iOS 和 iPadOS 版 Collabora 行動應用程式中的搜尋框會被鍵盤隱藏；該報告在專案的問題追蹤器中被標記為「未確認」。該報告僅表明存在已報告的症狀，並未證明所有 Collabora Online 行動瀏覽器都存在相同的錯誤，也不表示已被修復程式可用。請查看Collabora 行動搜尋框報告以了解其具體範圍。

操作：在將此問題作為您的案例處理之前，請先查看問題的狀態和版本詳情。使用基於瀏覽器的 Collabora 會話的使用者也應明確說明問題出現在網頁版 Collabora 中，而不是 Collabora Office 的原生行動應用程式中。

Android WebView 開發人員應該檢查哪些內容？

如果您的應用程式將 Collabora Online 嵌入到 Android WebView 中，請檢查宿主 Activity 的軟鍵盤和視窗內邊距行為。 Android 的指南指出，Activity 可以在鍵盤開啟時要求調整視窗大小android:windowSoftInputMode="adjustResize"。 Android 也記錄了現代 WebView 的視窗內邊距：內邊距變更的接收或傳遞失敗會導致 WebView 無法接收視窗更新，並可能幹擾某些行為，例如…（此處原文似乎有誤，無法翻譯scrollIntoView()）。請閱讀目前的Android 輸入法可見性指南和Android 的 WebView 視窗內邊距指南。

adjustResize這是一個有用的起點，但並非通用的一鍵式補丁。全螢幕佈局、Android 版本、自訂內邊距監聽器、父容器以及 WebView 的位置都可能影響結果。尤其需要注意的是，在不了解子元素如何接收鍵盤內邊距的情況下，切勿直接使用它們。操作步驟：建立一個包含 WebView 和標準可編輯欄位的最小宿主螢幕進行測試，然後將其鍵盤行為與 Collabora 頁面進行比較。每次只更改宿主螢幕的一個設置，並重新測試滾動、遊標可見性和鍵盤關閉功能。

在 iOS 系統中，嵌入 Web 視圖的原生應用程式需要在宿主應用程式的 UIKit/WebKit 佈局以及頁面本身中進行檢查。蘋果透過UIKit 的 keyboardLayoutGuide文件對鍵盤感知佈局進行了說明。這是面向應用程式開發者的平台指南，而非 Collabora 文件的最終使用者設定。

Collabora 是否應該加入 JavaScript 或 CSS？

通常情況下，不要一開始就嘗試在編輯器 iframe 中註入 CSS 或更改 Collabora 的文件佈局。 VirtualKeyboard API 可讓 Web 應用程式直接控制鍵盤覆蓋層，但 MDN 指出其可用性有限，並解釋說，要放棄瀏覽器的預設縮放行為，頁面需要自行管理鍵盤的幾何形狀。此外，iframe 內的視覺視窗尺寸也不一定與頂級頁面相同。請參閱 MDN 的VirtualKeyboard API 參考文件和VisualViewport 參考文件。

操作：首先使用受支援的整合和宿主應用程式配置。只有當您維護了整合、已在目標裝置上重現了問題，並且可以在不中斷文件輸入或儲存的情況下測試編輯器的嵌入式框架時，才會新增頁面層級變通方案。

如何報告可復現的問題？

向管理員或應用程式開發者發送一份簡短的報告，內容包括：

• 手機或平板電腦型號、作業系統版本以及鍵盤應用（如有）。
• 瀏覽器名稱和版本，或如果涉及 WebView，則為宿主應用程式名稱和版本。
• 如果知道 Collabora Online 的版本，以及所使用的雲端或入口網站整合方式。
• 文件類型以及要隱藏的確切控件，例如 Writer 文字、Calc 儲存格、公式欄或搜尋欄位。
• 同一文件在獨立瀏覽器中是否能正常運作，以及縱向或橫向顯示是否會改變結果。
• 一段簡短的螢幕錄影，其中私人文件內容已被移除或遮蔽。

Collabora 的問題追蹤系統要求行動裝置問題報告者提供設備及作業系統版本、應用程式版本、重現步驟、預期行為和實際行為。請關注其問題報告頁面，並避免發布機密文件或身份驗證資訊。

如何判斷它是否已修復？

重新開啟同一個文件，並在鍵盤可見的情況下重複相同的編輯操作。焦點文字或儲存格應保持可見；遊標應位於預期位置；您應該能夠輸入文字、捲動到下一個段落或儲存格，並在頁面不跳動或失去焦點的情況下關閉鍵盤。在縱向和橫向模式下分別重複上述操作一次，然後分別測試嵌入式應用程式和獨立瀏覽器（如果兩者都對您的工作流程至關重要）。

如果只有一條路徑仍然失敗，請將診斷範圍限定在該瀏覽器、應用程式或控制項上。這些資訊有助於維護人員決定是調查 Collabora 的行動編輯器、瀏覽器視窗或原生 WebView 容器。