La visionneuse de fichiers Ajouté en 0.9.9

La visionneuse de fichiers affiche un fichier à la fois, sur tout l’écran. Elle s’ouvre quand vous cliquez sur un fichier dans 📁 Browse files (Parcourir les fichiers), sur un nom de fichier qu’un agent a écrit dans sa réponse, ou sur une image, une vidéo ou un fichier audio joint à la conversation. Vous pouvez consulter le fichier, le lire, zoomer dessus, l’enregistrer et, pour les images, l’annoter.

Les images, les vidéos et les fichiers audio s’affichent sur fond noir. Le texte tient dans une colonne qui reste lisible sur un écran large. Le titre, les boutons et une ligne indiquant le type et la taille du fichier flottent au-dessus du contenu. Un appui ou un clic sur le contenu les masque, puis les fait revenir. Pendant la lecture d’une vidéo ou d’un fichier audio, ils s’estompent aussi au bout de trois secondes ; bouger la souris ou toucher un bouton les fait revenir. Un lecteur en pause les affiche toujours.

L’aspect de chaque type de fichier #

Le relais déduit le type de l’extension du fichier et, pour le texte, d’un coup d’œil à ses premiers octets.

La ligne au-dessus du contenu se lit comme CODE · javascript · 4.2 KB : le type, le langage s’il y en a un, et la taille.

Boutons des fichiers texte #

Pour les fichiers Markdown, de code et de texte venant du workspace, des lecteurs ou du dossier de la session, la barre d’outils propose Preview (Aperçu) et Raw. Preview est la vue rendue ou colorée, Raw le texte brut.

Un fichier Markdown s’ouvre avec son HTML de mise en page activé, et une ligne indique ⚠ Safe layout HTML enabled; active content is blocked. Show literal HTML (Afficher le HTML brut) le désactive, de sorte que le HTML du fichier apparaît comme du texte, et Show HTML layout (Afficher la mise en page HTML) le réactive. Les scripts ne s’exécutent jamais, dans un cas comme dans l’autre.

Un lien relatif dans un fichier Markdown rendu ouvre le fichier lié dans la même visionneuse, et un bouton ← Back (Retour) apparaît dans la barre d’outils pour revenir au fichier précédent. Un lien vers une adresse web s’ouvre dans un nouvel onglet. Un fichier ouvert ainsi n’a pas de voisins vers lesquels balayer.

Fichiers volumineux et binaires #

• Texte volumineux. La visionneuse lit les 512 premiers Ko d’un fichier texte. Pour un fichier plus long, la ligne au-dessus du contenu ajoute truncated to 512 KB. Le reste n’est pas affiché ; Download donne le fichier entier.
• Contenu binaire. Un fichier qui ressemble à du texte par son extension, mais dont les octets sont binaires (ou que le relais sert avec un type binaire), s’affiche sous la forme de la carte « no inline preview ».
• Images, vidéo, audio. Aucune limite de taille ne s’applique à eux dans la visionneuse.
• Un fichier illisible. La visionneuse affiche Preview failed avec l’erreur, par exemple File not found (Fichier introuvable).

Passer d’un fichier à l’autre #

La possibilité de passer à un autre fichier dépend de la façon dont vous avez ouvert le fichier affiché.

Un dossier qui ne contient qu’un fichier, ou une conversation qui ne contient qu’une image, s’ouvre sans galerie. Quand il y en a une, deux boutons (‹ et ›) et la position (par exemple 3 / 12) apparaissent en bas. La galerie ne boucle pas : les boutons sont désactivés aux deux extrémités. Les voisins des deux côtés sont chargés à l’avance, si bien qu’un pas arrive directement sur le fichier et non sur Fetching file preview… (Chargement de l’aperçu du fichier…).

Un fichier d’une conversation qui n’est ni une image, ni une vidéo, ni un fichier audio (un PDF, par exemple) est un lien normal sous le message et s’ouvre dans un nouvel onglet du navigateur, pas dans la visionneuse.

La fermer #

• Balayez vers le bas sur une image, un lecteur ou une carte. Le contenu suit votre doigt et disparaît si vous balayez assez loin ou assez vite. Le texte, lui, défile sous votre doigt.
• Balayez sur le côté pour parcourir la galerie. Les glissements à la souris ne balaient pas, pour que vous puissiez toujours sélectionner du texte ; une image agrandie se déplace au lieu de balayer.
• × dans le coin supérieur droit, ou Esc.
• Back sur un téléphone, voir plus bas.

Zoom et déplacement #

Une image s’affiche d’abord à sa taille ajustée, et jamais plus petite. Ajustée, un balayage sur le côté passe au fichier suivant et un balayage vers le bas ferme la visionneuse. Agrandie, ces mêmes glissements déplacent l’image.

Le retour sur un téléphone et dans l’app installée #

Tant que la visionneuse est ouverte, le geste ou le bouton retour du système ferme la visionneuse et rien d’autre. L’adresse dans le navigateur ne change pas.

Dans l’app installée depuis le navigateur (Android, iOS ou ordinateur), Back ne ferme jamais l’app de lui-même. Quand il n’y a plus rien à fermer, il affiche Press back again to close the app, et un second appui la ferme. Tant que vous n’avez pas touché la page une première fois, le navigateur laisse Back quitter, ce qu’une page ne peut pas changer. Dans un onglet de navigateur ordinaire, le bouton retour est celui du navigateur, comme d’habitude.

Actions #

Cliquez sur le titre en haut pour copier la référence du fichier, comme `@file:src/app.js`, que vous pouvez coller dans la zone de saisie pour que l’agent lise ce fichier. L’info-bulle du titre affiche le texte exact. Pour un fichier des lecteurs ou du dossier de la session, la référence contient le chemin absolu.

Où mène un lien dans une réponse #

• Un nom ou un chemin de fichier en texte simple, comme src/app.js, avec l’extension d’un type de fichier connu, est un lien qui ouvre le fichier dans la visionneuse. Il est toujours lu comme un chemin dans le workspace de la conversation. Un chemin absolu est ramené à sa partie située dans le workspace. Un chemin absolu qui n’est pas dans le workspace, comme /var/log/app.log, devient lui aussi un chemin du workspace et échoue avec File not found. Les noms dans le code en ligne et les blocs de code ne deviennent pas des liens.
• Une image que l’agent a intégrée par son chemin absolu s’ouvre dans la visionneuse avec les autres médias de la conversation. Cela fonctionne aussi pour les fichiers hors du workspace. Voir Médias dans la réponse d’un agent.
• Un lien Markdown vers un chemin de fichier ouvre le fichier brut dans un nouvel onglet du navigateur, pas dans la visionneuse, tout comme un lien vers une adresse web. Le même chemin écrit en texte simple s’ouvre dans la visionneuse.

Ce que la visionneuse peut ouvrir #

La visionneuse demande le fichier au relais : c’est donc le relais qui décide.

Un chemin qui désigne un dossier, ou un fichier qui n’existe plus, est refusé. Les fichiers HTML et XML s’affichent comme du texte et un SVG ne peut pas exécuter de script, si bien qu’un fichier écrit par un agent ne s’exécute jamais comme une page sur le relais. Un lien partagé en lecture seule ne peut pas récupérer les fichiers du workspace ou des lecteurs, et un clic sur une image intégrée n’y fait rien.

Touches #

Les touches fléchées ne fonctionnent que lorsqu’il y a une galerie, et pas pendant que vous tapez dans un champ.