Garder le texte visible à l'ouverture du clavier mobile Collabora

Si le clavier virtuel masque la ligne active dans Collabora Online, enregistrez vos modifications, fermez le clavier et faites défiler le document jusqu'à ce que le curseur soit visible au-dessus. Si le problème persiste, ouvrez le même fichier dans un navigateur mobile complet ; cela permettra de déterminer si la cause est le navigateur, une WebView intégrée ou la page hébergeant Collabora.

Il n'existe pas de paramètre utilisateur unique permettant de corriger tous les chevauchements de clavier sur mobile. Collabora Online s'exécute dans un navigateur ou via l'intégration d'un autre produit ; la solution disponible dépend donc de la couche qui positionne l'éditeur à la mauvaise hauteur. Les vérifications ci-dessous permettent de distinguer une solution de contournement temporaire des modifications qu'un administrateur ou un développeur d'applications pourrait devoir apporter.

1. Récupérer la ligne cachée sans risquer de modifications

1. Attendez la fin de la modification ou de la synchronisation, puis enregistrez si le système hôte propose une commande d'enregistrement.
2. Masquez le clavier à l'aide de la flèche vers le bas ou du bouton Retour de l'appareil. Ne rechargez pas un document contenant des modifications non enregistrées.
3. Faites défiler le document de sorte que le paragraphe actif, la cellule de tableau ou le champ de saisie se trouve au-dessus de la zone du clavier.
4. Touchez à nouveau le point d'insertion souhaité. Si le clavier le recouvre dès son ouverture, masquez-le et placez le curseur légèrement plus haut dans le document avant de continuer.

Cela modifie l'affichage actuel sans corriger la mise en page. Si le curseur reste visible jusqu'à la prochaine frappe ou si la page saute à l'ouverture du clavier, poursuivez les vérifications du navigateur et du serveur.

2. Identifiez la couche à l'origine du chevauchement.

Répétez la même action d'édition avec le même fichier et notez où elle échoue. Collabora décrit Collabora Online comme un éditeur de navigateur adaptatif et le distingue de l'application mobile Collabora Office. Ces deux solutions peuvent utiliser différents moteurs de navigateur, conteneurs hôtes et gestion du clavier ; comparez donc des éléments similaires avant de signaler un défaut.

• Un seul navigateur pose problème : mettez à jour ce navigateur et testez le fichier dans un autre navigateur récent pris en charge par votre organisation.
• L'application hôte ne fonctionne pas, mais son lien fonctionne dans le navigateur système : la WebView intégrée à l'application ou sa configuration de redimensionnement du clavier sont des pistes probables à explorer pour le propriétaire de l'application.
• Sur un même appareil, le navigateur et l'application hôte rencontrent tous deux un problème : veuillez noter le modèle de l'appareil, la version du système d'exploitation, la version du navigateur et l'orientation de la page (portrait ou paysage). Ce problème suggère une interaction entre l'appareil et la zone d'affichage du navigateur, mais ne constitue pas à lui seul une preuve de défaut de Collabora.
• Le même problème se produit sur plusieurs appareils, mais uniquement au sein d'un même service : demandez à l'administrateur de ce service d'inspecter le conteneur de l'éditeur intégré et sa mise en page mobile.

La FAQ officielle de Collabora décrit l'utilisation adaptative de Collabora Online sur les navigateurs mobiles. Sa présentation du produit mobile aborde séparément Collabora Online via navigateur et l'application mobile dédiée. Tenez compte de cette distinction pour déterminer à quelle équipe signaler un bug.

3. Si vous gérez la page qui intègre Collabora

Sur mobile, la zone d'affichage (ou viewport) correspond à la partie de la page visible à l'écran ; le clavier permet de la réduire sans modifier la mise en page. MDN indique que le comportement de la zone d'affichage varie selon les navigateurs. Dans une application intégrée, la page hôte principale peut fournir des mesures utiles de la zone d'affichage, tandis que les mesures de l'iframe ne reflètent pas de la même manière l'écran ajusté par le clavier.

Vérifiez que la page hôte réagit correctement à l'ouverture du clavier : le cadre de l'éditeur doit s'adapter à la hauteur disponible, le curseur doit rester accessible et la page doit pouvoir faire défiler le cadre pour l'afficher. Évitez une hauteur fixe en pixels ou un cadre plein écran permanent qui suppose que le clavier ne modifie jamais la zone visible. Utilisez les événements de redimensionnement et de défilement de la fenêtre d'affichage de la page externe pour recalculer l'espace disponible pour l'éditeur, puis effectuez des tests sur les navigateurs et appareils utilisés par vos utilisateurs. La documentation MDN décrit l' API VisualViewport et ses événements de redimensionnement pour ce type de modification de la zone visible.

Certains navigateurs prennent également en charge le paramètre viewport interactive-widget=resizes-content, qui demande au navigateur de redimensionner le contenu de la page lorsque le clavier virtuel apparaît. Ce paramètre affecte la mise en page de la page hôte et sa compatibilité n'est pas uniforme ; il est donc déconseillé de l'intégrer comme solution universelle pour Collabora. Testez l'ensemble de l'expérience intégrée, y compris les menus, la barre d'outils, le défilement et la fermeture du clavier, avant tout déploiement. MDN documente cette option dans sa référence relative aux métadonnées viewport .

4. Si Collabora s'ouvre dans une application Android

Demandez au développeur de l'application d'inspecter l'activité contenant la WebView. Selon les recommandations officielles d'Android, android:windowSoftInputMode="adjustResize"la mise en page de l'application est redimensionnée à l'espace laissé par le clavier, ce qui permet de conserver l'accessibilité du contenu lors du défilement. Pour une application intégrant Collabora, le manifeste de l'activité peut inclure :

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

Le nom exact de l'activité et les attributs du manifeste dépendent de l'application ; fusionnez ce paramètre avec la déclaration actuelle plutôt que d'ajouter une activité dupliquée. Ce paramètre Android s'applique aux applications Android natives et aux hôtes WebView, et non aux onglets de navigateur classiques ni à iOS. Consultez le guide de visibilité du clavier Android avant de modifier la version de votre application.

Liste de vérification

• Lorsque le clavier est ouvert, la ligne ou la cellule en cours d'édition reste visible, ou bien le document peut défiler suffisamment pour la révéler.
• Saisir plusieurs lignes ne déplace pas le curseur derrière le clavier.
• Masquer le clavier rétablit l'affichage complet du document sans espace vide ni zone de défilement bloquée.
• Répétez le test après avoir fait pivoter l'appareil et dans chaque voie d'accès prise en charge : navigateur direct, application intégrée ou application mobile dédiée.
• Vérifiez que les modifications sont enregistrées, puis signalez les échecs persistants en précisant le type de fichier, l'appareil et le système d'exploitation, la version du navigateur ou de l'application hôte, ainsi que les étapes de reproduction.

Si la page web est gérée par votre fournisseur de stockage cloud ou votre organisation, les utilisateurs ne pourront peut-être pas modifier la taille de son cadre. Veuillez transmettre la liste de vérification et les détails de reproduction au responsable de ce service ; seul le propriétaire de la page ou de l’application hôte peut modifier la configuration de sa fenêtre d’affichage ou de WebView.