在 Collabora 移動鍵盤開啟時保持文字可見

如果 Collabora Online 中的螢幕鍵盤遮蔽了當前行，請先儲存更改，關閉鍵盤，然後捲動文檔，直到遊標出現在鍵盤上方。如果問題仍然存在，請在行動瀏覽器中開啟同一個檔案；這有助於確定問題出在瀏覽器、嵌入式 WebView 或 Collabora 所在的頁面。

沒有單一的使用者設定可以解決所有移動鍵盤重疊問題。 Collabora Online 運行在瀏覽器或其他產品的整合環境中，因此可用的解決方法取決於哪個層導致編輯器高度不正確。以下檢查將臨時編輯解決方法與管理員或應用程式開發人員可能需要進行的變更區分開來。

1. 在不遺失編輯內容的情況下恢復隱藏行

1. 等待編輯或同步完成，如果主機提供儲存命令，則儲存。
2. 使用向下箭頭鍵或裝置的「返回」鍵隱藏鍵盤。不要重新載入未儲存編輯的文檔。
3. 捲動文檔，使目前段落、表格儲存格或輸入欄位位於鍵盤區域上方。
4. 再次點選目標插入點。如果鍵盤一開啟就遮擋住了插入點，請將其隱藏，並將遊標稍微向上移動到文件中更高的位置後再繼續操作。

這會改變目前視圖，而不是修正佈局。如果遊標僅在下次按鍵前可見，或開啟鍵盤時頁面跳動，請繼續進行瀏覽器和主機檢查。

2. 確定是哪一層導致了重疊

使用同一文件重複相同的編輯操作，並記錄出錯之處。 Collabora 將 Collabora Online 描述為響應式瀏覽器編輯器，並將其與獨立的 Collabora Office 行動應用區分開來。由於這些路徑可能使用不同的瀏覽器引擎、主機容器和鍵盤處理方式，因此在報告產品缺陷之前，請務必進行同類比較。

• 只有一個瀏覽器發生故障：請更新該瀏覽器，並在貴組織支援的其他目前瀏覽器中測試該檔案。
• 宿主應用程式發生故障，但其連結在系統瀏覽器中有效：應用程式的嵌入式 WebView 或其鍵盤調整大小配置可能是應用程式擁有者需要調查的地方。
• 瀏覽器和宿主應用程式在同一裝置上均發生故障：請注意裝置型號、作業系統版本、瀏覽器版本以及頁面是縱向還是橫向顯示。這表示存在設備/瀏覽器視窗互動問題，但這本身並不能證明是 Collabora 的缺陷。
• 相同故障僅在一個服務中的多個裝置上發生：請該服務的管理員檢查嵌入式編輯器容器及其行動佈局。

Collabora 的官方常見問題解答介紹如何在行動瀏覽器中使用響應式 Collabora Online。其行動產品概述則分別討論了基於瀏覽器的 Collabora Online 和專用行動應用。在選擇應向哪個團隊提交錯誤報告時，請參考此差異。

3. 如果您維護嵌入 Collabora 的頁面

在行動裝置上，視覺化裝置是指頁面上目前在螢幕上可見的部分；鍵盤可以縮小視覺視窗，而不會改變頁面的佈局視窗。 MDN 指出，不同瀏覽器的視窗行為有所不同。在嵌入式設定中，頂級宿主頁面可能具有有用的視覺視窗尺寸，而 iframe 本身的尺寸則無法以相同的方式反映鍵盤調整後的螢幕尺寸。

檢查宿主頁面在鍵盤開啟時是否響應：其編輯器框架應適應可用高度，遊標應始終可觸及，並且頁面應能夠滾動到框架可見區域。避免使用固定像素高度或永久全螢幕框架，因為後者假定鍵盤永遠不會改變可見區域。使用外部頁面的視窗大小調整和捲動事件重新計算編輯器的可用空間，然後在使用者實際使用的瀏覽器和裝置上進行測試。 MDN 文件中提供了VisualViewport API及其針對此類可見區域變更的調整大小事件。

部分瀏覽器也支援視口設置interactive-widget=resizes-content，該設定會在虛擬鍵盤出現時調整頁面內容的大小。這會影響宿主頁面的佈局，瀏覽器支援並不統一，因此請勿將其作為 Collabora 的通用修復方案。部署前，請測試完整的嵌入式體驗，包括選單、工具列、捲動和鍵盤關閉功能。 MDN 在其視口元參考文件中對此選項進行了說明。

4. 如果 Collabora 在 Android 應用程式內打開

請應用程式開發者檢查包含 WebView 的 Activity。 Android 官方指南指出，android:windowSoftInputMode="adjustResize"WebView 會調整應用程式佈局以適應鍵盤留下的空間，以便在需要捲動時仍能存取內容。對於嵌入 Collabora 的應用，Activity 清單可能包含：

<activity
    android:name=".EditorActivity"
    android:windowSoftInputMode="adjustResize" />

確切的 Activity 名稱和現有清單屬性取決於應用程式；請將此設定合併到目前聲明中，而不是新增重複的 Activity。此 Android 設定適用於原生 Android 應用程式或 WebView 宿主，不適用於一般瀏覽器標籤頁，也不適用於 iOS。更改應用程式版本前，請參閱Android 鍵盤可見性指南。

核查清單

• 鍵盤開啟時，正在編輯的行或儲存格仍然可見，或者文件可以捲動到足夠遠的位置來顯示它。
• 輸入多行文字不會將遊標移到鍵盤後面。
• 隱藏鍵盤後，文件視圖將恢復完整狀態，不會出現空白區域或滾動區域被遮蔽的情況。
• 旋轉裝置後，在每個支援的存取路徑（直接瀏覽器、嵌入式應用程式或專用行動應用程式）中重複測試。
• 確認變更已儲存，然後報告持續存在的故障，並提供檔案類型、裝置和作業系統、瀏覽器或主機應用程式版本以及重現步驟。

如果網頁由您的雲端儲存供應商或組織控制，使用者可能無法變更其框架大小。請將檢查清單和重現步驟傳送給該服務的管理員；只有託管頁面或應用程式的擁有者才能變更其視窗或 WebView 設定。