Formateur de XML
Formatez du XML avec une indentation lisible tout en conservant éléments, attributs, texte, commentaires et entités échappées.
Rendez la structure XML plus facile à lire
Un XML compact est pratique à transmettre mais difficile à inspecter. Un élément, un attribut, une balise fermante ou un caractère échappé peut être difficile à trouver lorsque tout tient sur une ligne. Ce formateur présente une mise en page lisible pour examiner la structure avant de l'utiliser dans un build, une requête ou une configuration.
Le formatage modifie la présentation, pas les données XML voulues. Il doit conserver les noms d'éléments, les valeurs d'attributs, les nœuds de texte, les commentaires et les références d'entités en ajoutant une indentation et des retours à la ligne cohérents. Un résultat lisible n'est pas une validation de schéma.
Utilisez un petit exemple représentatif pour découvrir l'outil. Conservez séparément le document source, la copie formatée et les résultats de validation ultérieurs afin de distinguer syntaxe XML, schéma, encodage et règles de l'application.
Si le document contient des secrets ou des données personnelles, créez une copie expurgée avant de le coller. Le formatage n'anonymise pas les valeurs et ne prouve pas que leur partage soit autorisé.
Formater n'est pas valider
XML est un format de balisage imbriqué composé d'éléments, d'attributs, de texte, de commentaires, de déclarations et de références de caractères. Les éléments ont besoin de balises ouvrante et fermante correspondantes, les attributs appartiennent à la balise ouvrante, et les caractères réservés comme ampersand doivent être échappés lorsqu'ils représentent des données.
Le formateur lit assez de structure pour organiser les nœuds et les espaces. Il ne prouve pas que le document respecte un XSD, un DTD, une politique de namespaces, un contrat d'application ou une règle métier. Gardez ces contrôles dans le flux qui les définit.
Les espaces peuvent être des données dans certains contextes XML, notamment le contenu mixte et les nœuds de texte. Avant de modifier un document utilisé par un consommateur sensible aux espaces, comparez la sortie à ses exigences et gardez la source originale.
Comment formater du XML
- Collez un document XML complet ou un fragment documenté dans le champ source. Supprimez le texte extérieur et l'enveloppe d'un langage de programmation de la copie de test.
- Lancez le formateur et examinez l'imbrication, les attributs, les commentaires et les textes. Un échec de formatage invite à inspecter la source, mais ne prouve pas un message précis du parser.
- Comparez le document formaté à l'original. Vérifiez que les noms, valeurs, références d'entités, déclarations de namespace et données textuelles n'ont pas changé.
- Après le formatage, exécutez le parser XML, le validateur de schéma ou le test d'application requis par votre projet. Le formatage seul ne démontre ni la validité ni la compatibilité.
- Pour des données de production, retirez les secrets et informations personnelles de l'exemple. Conservez le fichier original pour un diff contrôlé et un retour arrière éventuel.
Méthode de formatage
- Lire la structure XML
L'outil lit le balisage comme du contenu XML imbriqué et identifie les limites des éléments, attributs, textes, commentaires et déclarations à organiser.
- Appliquer l'indentation
Le formateur ajoute des retours à la ligne et une indentation pour rendre visibles les relations parent-enfant. Cet espace est une présentation, pas une nouvelle règle de schéma.
- Préserver les valeurs techniques
Les valeurs d'attributs, références d'entités, préfixes de namespace et commentaires doivent rester liés à l'exemple source. Examinez un diff lorsque les octets exacts comptent.
La page publique documente l'entrée XML pour le formatage. La récupération exacte du parser, la politique d'espaces et les messages d'erreur demandent un test dans un moteur réel.
Lire le résultat formaté
Un résultat réussi est une disposition lisible du XML fourni. Confirmez que l'arbre, les valeurs, attributs, commentaires et déclarations correspondent à la source.
Un échec signifie que le chemin documenté n'a pas pu traiter l'entrée. N'en déduisez pas une règle exacte du parser ou une position d'erreur sans preuve du moteur correspondant.
Si le document échoue ensuite à un XSD ou à un contrôle applicatif, examinez ce contrat séparé. Le formatage n'ajoute pas les éléments, namespaces ou types requis.
Erreurs courantes
Confondre indentation et validation de schéma peut cacher des éléments obligatoires absents ou des attributs invalides.
Remplacer des entités échappées par des caractères visibles peut modifier les données XML ou rendre le document invalide.
Trier les attributs ou les enfants pour des raisons visuelles peut changer l'ordre attendu par le consommateur ou le contenu mixte.
Copier un fragment sans la déclaration namespace nécessaire peut rendre le test différent du document de production.
Limites
La capacité documentée est le formatage XML. Elle ne prouve pas la validation XSD ou DTD, la transformation, la canonicalisation, l'analyse de sécurité ni la compatibilité applicative.
Testez avec le consommateur cible le contenu mixte sensible aux espaces, les namespaces, les documents volumineux et la récupération propre au parser.
Ne collez pas de documents de production confidentiels sauf si votre politique l'autorise. La copie formatée peut conserver les mêmes valeurs sensibles.
Examples
Formater un élément simple
Un élément compact peut-il devenir lisible ?
Envoyez le XML compact.
Les éléments enfants apparaissent sur des lignes séparées et indentées sous note.
Garder les attributs visibles
Comment examiner un élément avec un attribut ?
Envoyez l'élément et examinez la balise ouvrante.
L'attribut id reste sur user et l'enfant name est indenté.
Préserver le texte échappé
Une entité dans le texte reste-t-elle intacte ?
Formatez le document et comparez le nœud texte.
La référence d'entité reste une partie de la représentation du texte.
Formater des enfants répétés
Les éléments répétés peuvent-ils être séparés clairement ?
Envoyez le parent avec deux enfants item.
Chaque enfant répété apparaît sur sa propre ligne, ce qui facilite la revue de l'ordre.
Conserver un commentaire
Que doit-il arriver à un commentaire XML ?
Formatez l'exemple de configuration.
Le commentaire reste dans le document entre le parent et l'élément mode.
Conserver une déclaration
Comment traiter la déclaration XML ?
Envoyez la déclaration avec l'élément racine.
La déclaration reste au début et le contenu de root est indenté dessous.
Frequently asked questions
Le formatage valide-t-il un schéma XML ?
Non. Il organise la structure XML. Utilisez le XSD, le DTD ou le validateur d'application requis pour contrôler le schéma.
Le formatage change-t-il les valeurs ?
Il doit conserver les valeurs et la structure en ajoutant des espaces de présentation. Comparez la sortie à l'original lorsque le texte exact compte.
Les commentaires sont-ils conservés ?
Les exemples traitent les commentaires comme du contenu conservé dans la vue formatée. Confirmez le comportement pour votre entrée avant de l'utiliser dans un pipeline.
Puis-je formater un fragment XML ?
Utilisez un document complet ou une forme de fragment documentée. Le fragment peut dépendre d'un namespace ou d'une racine absente de l'exemple.
Le formatage rend-il le XML plus petit ?
Non. Il ajoute généralement des espaces pour la lecture. Utilisez un minificateur ou un processus de transport séparé pour une sortie compacte.
Que faire de ampersand échappé ?
Conservez les références comme & en tant que données XML. Ne les remplacez pas par ampersand brut si le contexte ne reste pas un XML valide.
Le formatage répare-t-il un XML mal formé ?
Ne le supposez pas. Corrigez la source volontairement et vérifiez-la avec le parser et les contrôles de schéma de l'application.
Que faire après le formatage ?
Examinez un diff, exécutez les contrôles de parser ou de schéma et testez la copie avec le consommateur réel si les espaces ou namespaces comptent.