Manter o texto visível quando o teclado do Collabora Mobile for aberto

Se o teclado virtual cobrir a linha ativa no Collabora Online, primeiro salve as alterações, feche o teclado e role o documento até que o cursor fique visível acima dele. Se o problema persistir, abra o mesmo arquivo em um navegador móvel completo; isso ajuda a determinar se a causa é o navegador, uma WebView incorporada ou a página que hospeda o Collabora.

Não existe uma configuração única que corrija todos os problemas de sobreposição do teclado em dispositivos móveis. O Collabora Online funciona dentro de um navegador ou da integração de outro produto, portanto, a solução disponível depende de qual camada está mantendo o editor na altura incorreta. As verificações abaixo diferenciam uma solução alternativa temporária para edição das alterações que um administrador ou desenvolvedor de aplicativos pode precisar fazer.

1. Recupere a linha oculta sem correr o risco de edições.

1. Aguarde a conclusão da edição ou sincronização e, em seguida, salve se o host fornecer um comando para salvar.
2. Oculte o teclado usando a seta para baixo ou o botão Voltar do dispositivo. Não recarregue um documento com edições não salvas.
3. Deslize o documento para que o parágrafo ativo, a célula da tabela ou o campo de entrada fique acima da área do teclado.
4. Toque novamente no ponto de inserção desejado. Se o teclado o cobrir assim que ele abrir, oculte-o e posicione o cursor um pouco mais acima no documento antes de continuar.

Isso altera a visualização atual em vez de corrigir o layout. Se o cursor permanecer visível apenas até a próxima tecla ser pressionada, ou se a página saltar quando o teclado for aberto, continue com as verificações do navegador e do host.

2. Identifique qual camada causa a sobreposição.

Repita a mesma ação de edição com o mesmo arquivo e observe onde ocorre a falha. A Collabora descreve o Collabora Online como um editor responsivo para navegadores e o diferencia do aplicativo móvel Collabora Office. Esses aplicativos podem usar mecanismos de navegador, contêineres de hospedagem e recursos de teclado diferentes; portanto, compare versões semelhantes antes de relatar um defeito do produto.

• Apenas um navegador apresenta falha: atualize esse navegador e teste o arquivo em outro navegador atual compatível com sua organização.
• O aplicativo host apresenta falhas, mas o link funciona no navegador do sistema: o WebView incorporado ao aplicativo ou sua configuração de redimensionamento do teclado são pontos prováveis ​​para o proprietário do aplicativo investigar.
• Tanto o navegador quanto o aplicativo host apresentam falhas em um dos dispositivos: observe o modelo do dispositivo, a versão do sistema operacional, a versão do navegador e se a página está em modo retrato ou paisagem. Isso indica uma interação entre o dispositivo e a área de visualização do navegador, mas não comprova, por si só, um defeito do Collabora.
• A mesma falha ocorre em vários dispositivos, mas apenas em um serviço específico: solicite ao administrador desse serviço que inspecione o contêiner do editor incorporado e seu layout para dispositivos móveis.

As perguntas frequentes oficiais da Collabora descrevem o uso responsivo do Collabora Online em navegadores móveis. A visão geral do produto para dispositivos móveis aborda separadamente o Collabora Online baseado em navegador e o aplicativo móvel dedicado. Leve essa distinção em consideração ao escolher qual equipe deve receber um relatório de erros.

3. Se você mantiver a página que incorpora o Collabora

Em dispositivos móveis, a área visível da página (viewport) é a parte da página que está atualmente visível na tela; o teclado pode reduzi-la sem alterar o layout da página. O MDN observa que o comportamento da área visível varia entre os navegadores. Em uma configuração incorporada, a página principal pode ter medidas úteis da área visível, enquanto as medidas do próprio iframe não representam a tela ajustada pelo teclado da mesma forma.

Verifique se a página principal responde quando o teclado é aberto: o quadro do editor deve se ajustar à altura disponível, o cursor deve permanecer acessível e a página deve permitir a rolagem do quadro para que ele fique visível. Evite uma altura fixa em pixels ou um quadro permanentemente em tela cheia que pressuponha que o teclado nunca altere a área visível. Use os eventos de redimensionamento e rolagem da viewport da página externa para recalcular o espaço disponível para o editor e, em seguida, teste nos navegadores e dispositivos reais que seus usuários utilizam. A MDN documenta a API VisualViewport e seus eventos de redimensionamento para esse tipo de alteração de área visível.

Alguns navegadores também suportam a configuração viewport interactive-widget=resizes-content, que instrui o navegador a redimensionar o conteúdo da página quando o teclado virtual aparece. Isso afeta o layout da página hospedeira e o suporte do navegador não é uniforme, portanto, não adicione essa configuração como uma correção universal para o Collabora. Teste toda a experiência incorporada, incluindo menus, barra de ferramentas, rolagem e ocultação do teclado, antes de implementá-la. A MDN documenta essa opção em sua referência de metadados viewport .

4. Se o Collabora for aberto dentro de um aplicativo Android

Peça ao desenvolvedor do aplicativo para inspecionar a Activity que contém o WebView. As diretrizes oficiais do Android recomendam android:windowSoftInputMode="adjustResize"redimensionar o layout do aplicativo para o espaço deixado pelo teclado, mantendo o conteúdo acessível quando for necessário rolar a tela. Para um aplicativo que incorpora o Collabora, o manifesto da Activity pode incluir:

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

O nome exato da Activity e os atributos existentes no manifesto dependem do aplicativo; incorpore essa configuração à declaração atual em vez de adicionar uma Activity duplicada. Essa configuração do Android se aplica a um aplicativo Android nativo ou a um host WebView, não a uma guia de navegador comum nem ao iOS. Consulte o guia de visibilidade do teclado do Android antes de alterar a versão do aplicativo.

Lista de verificação

• Com o teclado aberto, a linha ou célula que está sendo editada permanece visível, ou o documento pode ser rolado o suficiente para revelá-la.
• Digitar várias linhas não move o cursor para trás do teclado.
• Ocultar o teclado restaura a visualização completa do documento, sem espaços em branco ou áreas de rolagem bloqueadas.
• Repita o teste após girar o dispositivo e em cada caminho de acesso compatível: navegador direto, aplicativo integrado ou aplicativo móvel dedicado.
• Confirme se as alterações foram salvas e, em seguida, relate falhas persistentes, informando o tipo de arquivo, dispositivo e sistema operacional, versão do navegador ou aplicativo host e os passos para reproduzir o problema.

Se a página da web for controlada pelo seu provedor de armazenamento em nuvem ou pela sua organização, os usuários podem não conseguir alterar o tamanho do frame. Envie a lista de verificação e os detalhes da reprodução para o administrador desse serviço; somente o proprietário da página ou aplicativo host pode alterar a viewport ou a configuração do WebView.