Collabora 모바일 키보드가 열릴 때 텍스트가 계속 표시되도록 설정

Collabora Online에서 화면 키보드가 현재 작업 중인 줄을 가리는 경우, 먼저 변경 내용을 저장하고 키보드를 닫은 다음 커서가 키보드 위로 올라올 때까지 문서를 스크롤하십시오. 문제가 다시 발생하면 동일한 파일을 모바일 브라우저에서 열어 보십시오. 이렇게 하면 브라우저, 내장 WebView 또는 Collabora가 호스팅되는 페이지 중 어느 것이 문제의 원인인지 파악하는 데 도움이 됩니다.

모바일 키보드 겹침 문제를 한 번에 해결할 수 있는 사용자 설정은 없습니다. Collabora Online은 브라우저 또는 다른 제품과의 통합 내에서 실행되므로, 해결 방법은 편집기의 높이가 잘못된 레이어에 있는지 여부에 따라 달라집니다. 아래 검사 항목들은 임시 편집 해결 방법과 관리자 또는 앱 개발자가 변경해야 할 사항을 구분합니다.

1. 편집 내용을 손상시키지 않고 숨겨진 줄을 복구합니다.

1. 편집 또는 동기화가 완료될 때까지 기다린 후, 호스트에서 저장 명령을 제공하는 경우 저장하십시오.
2. 키보드의 아래쪽 화살표 키 또는 기기의 뒤로 가기 버튼을 눌러 키보드를 숨기세요. 저장하지 않은 편집 내용이 있는 문서를 다시 불러오지 마세요.
3. 활성화된 단락, 표 셀 또는 입력 필드가 키보드 영역 위에 오도록 문서를 스크롤합니다.
4. 삽입하려는 지점을 다시 탭하세요. 키보드가 열리자마자 해당 지점을 가리는 경우, 키보드를 숨기고 커서를 문서에서 약간 더 위쪽으로 옮긴 후 계속 진행하세요.

이는 레이아웃을 수정하는 대신 현재 화면을 변경하는 것입니다. 커서가 다음 키 입력 시까지만 표시되거나 키보드가 열릴 때 페이지가 이동하는 경우 브라우저 및 호스트 검사를 계속 진행하십시오.

2. 어떤 레이어가 겹치는 현상을 일으키는지 확인하십시오.

동일한 파일에 대해 동일한 편집 작업을 반복하고 오류가 발생하는 부분을 기록하십시오. Collabora는 Collabora Online을 반응형 브라우저 편집기로 설명하며, 별도의 Collabora Office 모바일 앱과 구분합니다. 두 경로는 서로 다른 브라우저 엔진, 호스트 컨테이너 및 키보드 처리 방식을 사용할 수 있으므로 제품 결함을 보고하기 전에 동일한 조건의 두 환경을 비교하십시오.

• 특정 브라우저에서만 문제가 발생하는 경우, 해당 브라우저를 업데이트하고 회사에서 지원하는 다른 최신 브라우저에서 파일을 테스트해 보세요.
• 호스트 앱은 오류가 발생하지만 시스템 브라우저에서는 링크가 정상적으로 작동합니다. 앱 소유자는 앱에 내장된 WebView 또는 키보드 크기 조정 설정을 조사해 볼 필요가 있습니다.
• 브라우저와 호스트 앱 모두 특정 기기에서 오류가 발생합니다. 기기 모델, 운영 체제 버전, 브라우저 버전, 그리고 페이지가 세로 모드인지 가로 모드인지 확인하십시오. 이는 기기/브라우저 뷰포트 간의 상호 작용 문제를 시사하지만, 그 자체로 Collabora의 결함을 증명하는 것은 아닙니다.
• 동일한 오류가 특정 서비스에서만 여러 기기에서 발생하는 경우, 해당 서비스 관리자에게 내장 편집기 컨테이너와 모바일 레이아웃을 점검해 달라고 요청하십시오.

Collabora의 공식 FAQ에서는 모바일 브라우저에서 반응형 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"앱 레이아웃은 키보드가 남긴 공간에 맞춰 크기가 조정되어 스크롤이 필요할 때 콘텐츠에 접근할 수 있도록 유지됩니다. Collabora를 내장한 앱의 경우 Activity 매니페스트에 다음 내용이 포함될 수 있습니다.

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

정확한 액티비티 이름과 기존 매니페스트 속성은 앱에 따라 다릅니다. 중복된 액티비티를 추가하는 대신 이 설정을 현재 선언에 병합하세요. 이 Android 설정은 네이티브 Android 앱 또는 WebView 호스트에 적용되며 일반 브라우저 탭이나 iOS에는 적용되지 않습니다. 앱 빌드를 변경하기 전에 Android 키보드 표시 가이드를 참조하세요.

검증 체크리스트

• 키보드가 열려 있는 상태에서 편집 중인 행이나 셀이 계속 표시되거나, 문서를 충분히 스크롤하여 해당 행이나 셀을 표시할 수 있습니다.
• 여러 줄을 입력해도 키보드 뒤쪽의 커서는 이동하지 않습니다.
• 키보드를 숨기면 빈 공간이나 스크롤 영역이 생기지 않고 문서 전체 화면이 복원됩니다.
• 기기를 회전시킨 후, 그리고 지원되는 각 접속 경로(직접 브라우저, 내장 앱 또는 전용 모바일 앱)에서 테스트를 반복하십시오.
• 변경 사항이 저장되었는지 확인한 후, 지속적인 오류가 발생하는 경우 파일 형식, 장치 및 운영 체제, 브라우저 또는 호스트 앱 버전, 그리고 재현 단계를 함께 보고해 주십시오.

웹 페이지가 클라우드 스토리지 제공업체 또는 조직에서 관리되는 경우 사용자는 프레임 크기를 변경할 수 없을 수 있습니다. 체크리스트와 재현 세부 정보를 해당 서비스 관리자에게 보내십시오. 호스트 페이지 또는 앱의 소유자만 뷰포트 또는 WebView 구성을 변경할 수 있습니다.