Collabora 온라인 모바일 웹 보기에서 키보드가 텍스트를 가리는 문제 해결

Collabora Online에서 편집 중인 단락, 셀 또는 검색 필드를 화면 키보드가 가리는 경우, 먼저 문제가 문서 편집기, 모바일 브라우저 또는 WebView에 Collabora를 내장한 앱 중 어디에 있는지 확인하십시오. 휴대폰에서는 키보드가 페이지 레이아웃의 모든 요소 크기를 조정하지 않고도 페이지의 보이는 영역을 줄일 수 있습니다. 편집기는 이전 위치를 유지하는 반면 브라우저 또는 호스트 앱은 작아진 영역을 다르게 처리할 수 있습니다.

서버 설정을 변경하기 전에 아래 사항들을 먼저 확인해 보세요. 내장된 보기와 독립 실행형 브라우저에서 동일한 문서를 비교해 보면 문제가 문서 호스트 때문인지 쉽게 파악할 수 있습니다. Android 앱이나 웹사이트를 관리하는 경우, 사용자 지정 스크립트를 추가하기 전에 호스트에서 키보드와 WebView 여백을 어떻게 처리하는지 검사하세요.

무엇을 먼저 확인해야 할까요?

1. 문서를 저장한 다음, 동일한 휴대폰에서 최신 버전의 독립형 브라우저를 사용하여 해당 파일을 다시 여세요.
2. 동일한 텍스트 또는 스프레드시트 입력란을 탭하고 키보드를 열어 커서와 텍스트가 계속 표시되는지 확인하십시오.
3. 원래 앱 또는 내장 웹뷰에서 동일한 작업을 반복하십시오. 내장 버전에서만 오류가 발생하는 경우 호스트 앱과 웹뷰를 문제의 일부로 기록하십시오.
4. 휴대폰을 회전하거나 한 단계 축소해 보세요. 이는 문제를 진단하기 위한 임시 해결책이며, 깨진 뷰포트를 복구하는 것은 아닙니다.

Collabora Online은 브라우저 기반 서비스이며 현재 주요 브라우저를 지원한다고 설명합니다. 또한 별도의 모바일 앱도 제공합니다. 문서에 접근하는 방법은 서로 다르므로 실제로 사용하는 앱을 테스트해 보세요. Collabora Online 제품 정보 및 Collabora 모바일 앱 정보를 참조하십시오 . 조치: 설정을 변경하기 전에 일반 앱과 독립 실행형 브라우저에서 동일한 문서, 계정 및 입력 필드를 비교해 보세요.

키보드가 텍스트를 가리는 이유는 무엇인가요?

모바일 웹 페이지에는 레이아웃 뷰포트와 비주얼 뷰포트가 있습니다. 레이아웃 뷰포트는 페이지의 레이아웃 영역을 나타내고, 비주얼 뷰포트는 현재 화면에 보이는 영역입니다. 가상 키보드가 나타나면 브라우저는 비주얼 뷰포트를 축소하고 포커스된 영역 쪽으로 스크롤할 수 있습니다. 정확한 동작은 브라우저와 임베딩 환경에 따라 다릅니다. 문서 편집기, 브라우저 또는 네이티브 호스트가 이전 뷰포트 높이를 사용하는 경우 활성 콘텐츠가 키보드 뒤에 가려질 수 있습니다.

이러한 차이점은 MDN의 VisualViewport 참조 문서에 설명되어 있습니다 . 이는 기본 웹 동작을 설명하는 것이지, 특정 Collabora 릴리스에 확정된 결함이 있다는 것을 의미하는 것은 아닙니다. 조치: 독립 실행형 브라우저 비교를 사용하여 문제가 여러 브라우저에서 편집기와 함께 발생하는지 아니면 특정 호스트에서만 발생하는지 확인하십시오.

문서를 편집하는 사용자를 위한 수정 사항

1. 편집 컨텍스트를 업데이트하고 다시 엽니다.

모바일 브라우저 또는 호스트 앱의 업데이트를 설치한 후 문서를 닫았다가 다시 여세요. 이렇게 하면 오래된 페이지 상태나 버전 관련 문제를 해결할 수 있지만, 뷰포트 버그를 완전히 해결하는 것은 아닙니다. 브라우저 또는 운영 체제 업데이트 중에 캐시된 탭이 열려 있는 상태로 유지되지 않도록 하세요. 조치: 완전히 닫았다가 다시 연 후 다시 테스트하고, 키보드가 여전히 커서를 가리는 경우 브라우저 또는 앱 버전을 기록해 두세요.

2. 비교 또는 임시 해결책으로 독립 실행형 브라우저를 사용하십시오.

클라우드 스토리지 앱, 이메일 클라이언트 또는 사용자 지정 포털에서 Collabora를 열 경우, 해당 서비스에서 제공하는 "브라우저에서 열기" 옵션이 있으면 해당 옵션을 사용하십시오. 독립 실행형 브라우저에서도 텍스트가 계속 표시되면 앱에 내장된 WebView 또는 기본 화면 레이아웃에 문제가 있을 가능성이 높습니다. 두 버전 모두에서 동일한 문제가 발생하는 경우, 브라우저 엔진, 운영 체제, 편집기 버전 또는 특정 Collabora 컨트롤에 문제가 있을 수 있습니다.

독립 실행형 브라우저가 항상 최적의 해결책이라고 생각하지 마십시오. 인증이나 파일 저장을 위해 호스트에 접속해야 할 수도 있습니다. 조치: 긴급 편집 시에는 커서가 계속 표시되는 경로를 사용하고, 서비스 또는 앱 관리자에게 비교 결과를 보고하십시오.

3. 일하는 동안 공간을 더 확보하세요

단기적인 해결 방법으로는 기기를 가로 모드로 회전하거나, 페이지 확대/축소를 약간 줄이거나, 활성 단락이 화면 위쪽에 오도록 문서를 스크롤하거나, 편집 사이에 키보드를 닫는 방법이 있습니다. Calc에서는 수식 입력 영역이나 셀 편집 컨트롤이 그리드에서 직접 편집할 때와 다르게 동작할 수 있으므로, 어떤 컨트롤이 숨겨지는지 특정 컨트롤을 테스트해 보세요. 이러한 조치를 통해 포커스가 맞춰진 콘텐츠를 표시할 수 있지만, 앱의 뷰포트 처리 방식이 올바르다는 것을 보장하는 것은 아닙니다.

조치: 각 해결 방법을 적용한 후 동일한 편집 작업을 반복하고 삽입 지점과 주변 텍스트가 모두 보이는지 확인하십시오. 도구 모음 필드 또는 검색 상자 중 하나만 가려진 경우, 전체 문서를 사용할 수 없다고 설명하는 대신 해당 필드를 구체적으로 보고하십시오.

이것은 Collabora에서 알려진 문제인가요?

최근 Collabora 보고서 중 일부에서는 키보드가 나타날 때 모바일 컨트롤이 숨겨지는 현상이 보고되었지만, 이는 특정 기기, 앱 버전 및 워크플로와 관련이 있습니다. 예를 들어, 2026년 9월 보고서에서는 iOS 및 iPadOS용 Collabora 모바일 앱에서 키보드로 인해 검색 필드가 가려지는 현상이 언급되었으며, 해당 보고서는 프로젝트 이슈 트래커에서 '미확인'으로 표시되어 있습니다. 이 보고서는 보고된 증상에 대한 증거일 뿐, 모든 Collabora Online 모바일 브라우저에 동일한 버그가 있거나 수정 사항이 있다는 것을 의미하지는 않습니다. 정확한 문제 범위는 Collabora 모바일 검색 필드 보고서를 참조하십시오.

조치: 해당 문제를 귀하의 사례로 처리하기 전에 문제 상태 및 버전 정보를 확인하십시오. 브라우저 기반 Collabora 세션을 사용하는 사용자는 문제가 Collabora Office의 기본 모바일 앱이 아닌 웹 버전에서 발생한다는 점을 명확히 밝혀야 합니다.

안드로이드 웹뷰 개발자는 무엇을 확인해야 할까요?

앱에서 Collabora Online을 Android WebView에 포함하는 경우 호스트 액티비티의 소프트 키보드 및 창 여백 동작을 검사하세요. Android 가이드라인에 따르면 액티비티는 키보드가 열릴 때 창 크기 조정을 요청할 수 있습니다 android:windowSoftInputMode="adjustResize". 또한 Android는 최신 WebView 창 여백에 대한 문서를 제공합니다. 여백 변경 사항을 처리하지 못하거나 전달하지 못하면 WebView가 뷰포트 업데이트를 수신하지 못하게 되어 와 같은 동작에 문제가 발생할 수 있습니다 scrollIntoView(). 최신 Android 입력 방식 가시성 가이드라인 과 Android WebView 창 여백 가이드를 참조하세요 .

adjustResize이는 유용한 시작점이 될 수 있지만, 만능 해결책은 아닙니다. 화면 전체를 덮는 레이아웃, Android 버전, 사용자 지정 키보드 여백 리스너, 부모 컨테이너, WebView 배치 등이 결과에 영향을 미칠 수 있습니다. 특히, 하위 요소가 키보드 여백을 어떻게 받는지 이해하지 않고서는 키보드 여백을 사용하지 마십시오. 조치: WebView와 표준 편집 가능 필드가 있는 최소한의 호스트 화면을 테스트한 다음 Collabora 페이지의 키보드 동작과 비교하십시오. 호스트 설정을 한 번에 하나씩 변경하고 스크롤, 캐럿 표시, 키보드 닫기 기능을 다시 테스트하십시오.

iOS에서 웹 뷰를 포함하는 네이티브 앱은 호스트 앱의 UIKit/WebKit 레이아웃과 페이지 자체 모두에서 키보드 인식 레이아웃을 확인해야 합니다. Apple은 UIKit의 keyboardLayoutGuide를 통해 키보드 인식 레이아웃에 대한 문서를 제공합니다 . 이는 앱 개발자를 위한 플랫폼 지침이며, Collabora 문서의 최종 사용자 설정이 아닙니다.

Collabora에 JavaScript 또는 CSS를 추가해야 할까요?

일반적으로 에디터 iframe에 CSS를 삽입하거나 Collabora의 문서 레이아웃을 변경하는 것부터 시작하지 마세요. VirtualKeyboard API를 사용하면 웹 애플리케이션이 키보드 오버레이를 직접 제어할 수 있지만, MDN에서는 이 API의 사용이 제한적이라고 명시하고 있으며, 브라우저의 일반적인 크기 조정 동작을 사용하지 않으려면 페이지에서 키보드 형상을 직접 관리해야 한다고 설명합니다. 또한 iframe 내부의 시각적 뷰포트는 최상위 페이지의 크기와 다를 수 있습니다. 자세한 내용은 MDN의 VirtualKeyboard API 참조 및 VisualViewport 참조를 확인하세요 .

조치: 먼저 지원되는 통합 및 호스트 앱 구성을 사용하십시오. 통합을 유지 관리하고, 대상 장치에서 문제를 재현했으며, 문서 입력이나 저장을 방해하지 않고 편집기의 내장 프레임을 테스트할 수 있는 경우에만 페이지 수준의 해결 방법을 추가하십시오.

재현 가능한 문제를 어떻게 보고하나요?

관리자 또는 앱 개발자에게 다음 내용을 포함한 간단한 보고서를 보내세요:

• 휴대폰 또는 태블릿 모델, 운영 체제 버전, 그리고 해당되는 경우 키보드 앱 정보를 알려주세요.
• 브라우저 이름과 버전, 또는 WebView가 관련된 경우 호스트 앱 이름과 버전입니다.
• Collabora Online 버전(알려진 경우)과 사용된 클라우드 또는 포털 통합 정보를 제공합니다.
• 문서 유형과 숨겨지는 컨트롤의 정확한 종류(예: Writer 텍스트, Calc 셀, 수식 입력줄 또는 검색 필드)를 지정합니다.
• 동일한 문서가 독립 실행형 브라우저에서 제대로 작동하는지, 그리고 세로 방향과 가로 방향에 따라 결과가 달라지는지 여부.
• 개인 문서 내용은 삭제하거나 가린 짧은 화면 녹화 영상입니다.

Collabora의 문제 추적 시스템은 모바일 사용자에게 기기 및 운영 체제 버전, 앱 버전, 재현 단계, 예상 동작 및 실제 동작을 포함하도록 요청합니다. 문제 보고 페이지 를 준수하고 기밀 문서나 인증 정보를 게시하지 마십시오.

문제가 해결되었는지 어떻게 알 수 있나요?

같은 파일을 다시 열고 키보드가 표시된 상태에서 동일한 편집 작업을 반복하세요. 선택된 텍스트 또는 셀이 계속 표시되어야 하고, 커서가 예상 위치에 있어야 하며, 페이지가 이동하거나 포커스를 잃지 않고 텍스트를 입력하고, 다음 단락이나 셀로 스크롤하고, 키보드를 닫을 수 있어야 합니다. 세로 모드와 가로 모드에서 각각 한 번씩 반복한 다음, 워크플로에 내장 앱과 독립 실행형 브라우저 모두 중요한 경우 각각 별도로 테스트하세요.

특정 경로에서만 문제가 발생하는 경우, 진단 범위를 해당 브라우저, 앱 또는 컨트롤로 제한하십시오. 이 정보는 유지 관리자가 Collabora 모바일 편집기, 브라우저 뷰포트 또는 네이티브 WebView 컨테이너 중 어느 부분을 조사해야 할지 결정하는 데 도움이 됩니다.