Comment formater un texte XML avec une indentation lisible

Collez votre texte XML, choisissez beautify et définissez l’indentation souhaitée pour obtenir une version lisible. Pour une sortie compacte, utilisez minify, en sachant que les commentaires et les espaces entre les balises seront retirés.

À quoi sert la mise en forme XML ?

Un texte XML difficile à parcourir devient plus lisible après une mise en forme structurée. L’outil accepte du texte XML et peut produire une version indentée, avec une largeur d’indentation configurable. Le mode beautify convient à la lecture et à la vérification visuelle de la hiérarchie des éléments.

Cette opération est utile avant une relecture, une comparaison manuelle ou une correction de structure. Elle ne transforme toutefois pas un texte quelconque en XML valide : le traitement de mise en forme analyse le XML avant de produire le résultat.

Procédure pour formater un texte XML

1. Préparez le texte XML à traiter. Vérifiez qu’il s’agit bien d’une chaîne de texte et retirez, si nécessaire, les caractères ajoutés par erreur autour du document.
2. Collez le contenu dans la zone prévue à cet effet. Un texte vide ou composé uniquement d’espaces est accepté et renvoie une sortie vide.
3. Conservez le mode beautify pour obtenir une présentation lisible. Si un autre mode est disponible, sélectionnez explicitement beautify plutôt que minify.
4. Choisissez la largeur d’indentation. La valeur par défaut est de 2 espaces. Pour une valeur contenant autre chose qu’un nombre entier, ou inférieure à 0 ou supérieure à 8, la valeur utilisée revient à 2 espaces.
5. Lancez le formatage, puis consultez la sortie. En cas d’échec, contrôlez d’abord les balises, les guillemets et l’imbrication du XML avant de recommencer.

Pour obtenir une version compacte, sélectionnez le mode minify. Lorsque l’entrée contient des caractères autres que des espaces, ce mode vérifie d’abord que le XML peut être analysé. Il retire ensuite les commentaires, réduit les espaces situés entre les balises et supprime les espaces au début et à la fin du texte. Cette sortie compacte n’est donc pas destinée à conserver la présentation originale.

Comprendre la sortie et ses limites

En mode beautify, attendez-vous à un XML réorganisé sur plusieurs lignes, avec des niveaux d’indentation qui rendent les relations entre les éléments plus faciles à lire. Une sortie réussie indique que le traitement a produit du texte formaté ; elle ne remplace pas une vérification du contenu métier du document.

Un résultat infructueux peut notamment venir d’un XML mal formé. Une entrée qui n’est pas fournie sous forme de texte échoue également. Pour une entrée contenant des caractères autres que des espaces, un volume supérieur à 1 000 000 d’octets UTF-8 est rejeté. À l’inverse, une entrée composée uniquement d’espaces est traitée comme une entrée vide avant cette vérification.

Utilisez beautify pour inspecter la structure et minify pour obtenir une représentation compacte lorsque la conservation des commentaires et des espaces entre les balises n’est pas nécessaire.

Exemple pratique

Vous recevez un fragment XML compact et souhaitez en inspecter rapidement la hiérarchie avant de le relire.

Collez le texte <catalogue><article>Guide</article></catalogue>, laissez le mode beautify sélectionné et utilisez une indentation de 2 espaces.

La sortie attendue est un XML lisible sur plusieurs lignes, avec l’élément enfant placé à un niveau d’indentation distinct de l’élément racine.

Limites

• Une entrée non textuelle échoue. Pour un contenu contenant autre chose que des espaces, une taille supérieure à 1 000 000 d’octets UTF-8 est rejetée.

Erreurs fréquentes

• Une balise non refermée, un attribut mal encadré ou une imbrication incorrecte peut empêcher l’analyse du XML. Corrigez la structure, puis relancez le formatage.

Questions fréquentes

Puis-je envoyer un champ XML vide ?

Oui, si l’entrée est vide ou composée uniquement d’espaces : elle renvoie une sortie vide avec succès. Pour un texte non vide, le contenu doit pouvoir être analysé comme du XML.

Que se passe-t-il si la largeur d’indentation n’est pas valide ?

Oui, pour une entrée contenant autre chose que des espaces, une largeur inférieure à 0, supérieure à 8 ou impossible à convertir en entier revient à la valeur par défaut de 2 espaces.

Le mode minify conserve-t-il les commentaires XML ?

Non. Le mode minify retire les commentaires, réduit les espaces entre les balises et supprime les espaces en début et en fin de texte. Utilisez beautify si vous devez conserver une présentation lisible.