منسّق XML

ما هو منسّق XML ولماذا تستخدمه؟

<!-- Minified XML input -->
<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01"><name>Wireless Headphones</name><price currency="USD">79.99</price></product></catalog>

<!-- After formatting with 2-space indent -->
<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <product id="p01">
    <name>Wireless Headphones</name>
    <price currency="USD">79.99</price>
  </product>
</catalog>

الميزات الرئيسية

أمثلة

<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01" category="electronics"><name>Wireless Headphones</name><price currency="USD">79.99</price><stock>142</stock><tags><tag>audio</tag><tag>bluetooth</tag></tags></product><product id="p02" category="books"><name>Learning XML</name><price currency="USD">29.99</price><stock>55</stock></product></catalog>

<rss version="2.0"><channel><title>Go Tools Blog</title><link>https://go-tools.org/blog</link><description>Developer tools, tips and tutorials</description><item><title>Understanding XML Namespaces</title><link>https://go-tools.org/blog/xml-namespaces-guide</link><pubDate>Thu, 29 May 2026 00:00:00 GMT</pubDate><description>A deep dive into XML namespace declarations, prefixes, and scope rules with practical examples.</description></item><item><title>XML vs JSON: When to Use Each</title><link>https://go-tools.org/blog/xml-vs-json</link><pubDate>Mon, 25 May 2026 00:00:00 GMT</pubDate></item></channel></rss>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><soap:Header><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:UsernameToken><wsse:Username>api-client</wsse:Username><wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-ext-1.0.xsd#PasswordText">s3cr3t</wsse:Password></wsse:UsernameToken></wsse:Security></soap:Header><soap:Body><GetOrderRequest xmlns="http://example.com/orders"><OrderId>ORD-20260529-001</OrderId><IncludeLineItems>true</IncludeLineItems></GetOrderRequest></soap:Body></soap:Envelope>

كيفية الاستخدام

1. 1

   الصق XML الخاص بك

   أدخل أو الصق XML في حقل الإدخال أعلاه. يمكنك أيضاً النقر على «تحميل مثال» لتجربة عينة (كتالوج منتجات XML مضغوط يظهر بشكل جميل بعد التنسيق).

2. 2

   اختر إجراءً

   انقر على «تنسيق» للتجميل بمسافات بادئة، أو «ضغط» لإزالة المسافات البيضاء، أو «تحقق» للتحقق من الصياغة السليمة. اختر 2 أو 4 مسافات لحجم المسافة البادئة قبل التنسيق.

3. 3

   انسخ الإخراج

   يظهر XML المُعالَج في لوحة الإخراج. انقر على «نسخ» لنقله إلى الحافظة. إذا وجد التحقق أخطاء، تُظهر لافتة الخطأ رقم السطر والعمود بالضبط.

أخطاء XML الشائعة

<products>
  <Item>
    <name>Widget</name>
  </item>
</products>

<products>
  <item>
    <name>Widget</name>
  </item>
</products>

<query>price > 10 & stock > 0</query>

<query>price &gt; 10 &amp; stock &gt; 0</query>

<product id=p01 label="It's a "widget"">

<product id="p01" label="It's a &quot;widget&quot;">

<user><name>Alice</name></user>
<user><name>Bob</name></user>

<users>
  <user><name>Alice</name></user>
  <user><name>Bob</name></user>
</users>

<?xml version="1.0" encoding="UTF-8"?>
<!-- File is actually saved as UTF-16 -->

<?xml version="1.0" encoding="UTF-16"?>
<!-- File saved as UTF-16, declaration matches -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
<!-- ]]> is missing -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
]]></script>

حالات الاستخدام الشائعة

تصحيح أخطاء حمولات SOAP وخدمات الويب

تصل استجابات SOAP من واجهات برمجية للمؤسسات وخدمات ويب قديمة كسلاسل XML في سطر واحد. الصق الحمولة الخام في المنسّق لترى فوراً بنية المغلّف والترويسات والجسم — مما يُسهّل إيجاد الحقل الذي تحتاجه أو رصد عدم تطابق في مساحة الأسماء. انظر أيضاً: محوّل XML إلى JSON إذا كنت بحاجة إلى معالجة الحمولة في JavaScript.

التحقق من ملفات الإعداد وواصفات النشر

ملفات Maven POM وسياقات تطبيق Spring XML وملف Tomcat server.xml وملفات Android Manifest والعديد من ملفات إعداد Java/المؤسسات الأخرى هي XML. تحقق منها عبر «التحقق» قبل الالتزام لاكتشاف الوسوم غير المتطابقة أو مشاكل الترميز التي لن تظهر إلا في وقت البناء أو النشر.

تنسيق إخراج تغذيات RSS وAtom

تغذيات RSS 2.0 وAtom 1.0 هي XML. عند تطوير مولّد تغذية أو تصحيح مشاكل التوافق مع قارئ التغذية، نسّق XML التغذية الخام لفحص وصف القناة وبنية العناصر وإعلانات مساحات الأسماء المطلوبة جنباً إلى جنب.

قراءة وتحرير ملفات SVG

ملفات SVG المُصدَّرة من Figma أو Illustrator أو Sketch هي XML صالح لكنها كثيراً ما تكون مضغوطة أو تحتوي على مسافات بادئة مفرطة من المُصدِّر. نسّق SVG للحصول على شجرة عناصر نظيفة وقابلة للتنقل قبل إجراء تعديلات يدوية على المسارات أو المجموعات أو سمات التنسيق.

إعداد XML للتخزين أو النقل

عند تخزين XML في عمود قاعدة بيانات أو إرساله كحقل سلسلة نصية في JSON في طلب API أو إدراجه في قائمة انتظار رسائل، استخدم الضغط أولاً لإزالة المسافات البيضاء غير الضرورية. هذا يُقلّل حجم الحمولة ويتجنب مشاكل مع محللات JSON التي قد تختنق من أحرف التحكم غير المُهرَّبة في سلاسل XML المُسنَّنة الكبيرة.

تحويل XML إلى JSON

إذا كنت بحاجة إلى تحويل XML المُنسَّق إلى JSON للاستخدام في تطبيق JavaScript أو واجهة REST برمجية، استخدم محوّل XML إلى JSON. للعكس — بناء XML من بنية JSON — استخدم محوّل JSON إلى XML.

تفاصيل تقنية

DOMParser في المتصفح لتحليل XML

يستخدم تحليل XML DOMParser الأصلي في المتصفح مع نوع MIME هو 'text/xml'. هذا هو المحرك نفسه الذي يُشغّل عرض SVG وXHTML في المتصفح — متوافق بالكامل مع XML 1.0 ويُبلّغ عن أخطاء الصياغة السليمة مع معلومات السطر والعمود. عندما لا يكون المستند مُصاغاً بشكل سليم، تُعيد DOMParser مستند خطأ يحتوي على رسالة الخطأ والموضع، والتي تستخرجها هذه الأداة وتعرضها.

تسلسل شجرة DOM للتنسيق

يعمل التنسيق بتحليل XML في شجرة DOM ثم استعراض الشجرة بشكل تكراري لإنتاج إخراج مُسنَّن. يحافظ هذا النهج على البنية الدلالية للمستند: يُسلسَل تداخل العناصر ومحتوى النص والسمات وأقسام CDATA وتعليمات المعالجة والتعليقات مرة أخرى بدقة كما تم تحليلها. تُحذف فقط العقد النصية التي تحتوي على مسافات بيضاء فحسب بين العناصر — تُحفظ دائماً العقد النصية التي تحتوي على أحرف غير مسافة بيضاء.

الضغط بإزالة العقد النصية ذات المسافات البيضاء فحسب

يستعرض الضغط شجرة DOM نفسها ويزيل العقد النصية التي يكون محتواها مسافات بيضاء بالكامل (مسافات وأجزاء ومستحدثات). لا تُزال أبداً العقد النصية ذات المحتوى المختلط أو المحتوى غير المسافة البيضاء — وهي البيانات الفعلية بين الوسوم. تُسلسَل السمات وقيمها بدون مسافات بيضاء إضافية. النتيجة هي أكثر تمثيل XML صالح إيجازاً للمستند الأصلي.

100% قائم على المتصفح — بدون رفع ملفات أو خادم

تتم جميع المعالجة في وقت تشغيل JavaScript في متصفحك. لا تُنقَل أي بيانات إلى أي خادم في أي وقت. هذا مهم بشكل خاص لحمولات XML التي كثيراً ما تحتوي على محتوى حساس: رموز WS-Security لـ SOAP وبيانات مرضى HL7 وإعداد خدمات داخلية وتنسيقات الرسائل المالية (FIX وSWIFT ISO 20022). الأداة آمنة للاستخدام مع أي XML لا تريد لصقه في خدمة عامة.

أفضل الممارسات

تحقق قبل التنسيق، ونسّق قبل الالتزام

تحقق من XML أولاً للتأكد من صياغته السليمة قبل إعادة تنسيقه — سيُنتج المنسّق إخراجاً غير صحيح بصمت إذا لم يكن الإدخال XML صالحاً. بمجرد التحقق منه، نسّقه وراجع الإخراج المُسنَّن قبل الالتزام بملفات الإعداد أو قوالب التغذية أو تعريفات WSDL في نظام التحكم بالإصدارات.

استخدم مسافتين للتنسيقات الويبية، و4 مسافات لـ XML المؤسسي

مسافتان هي الاتفاقية لتغذيات RSS/Atom وSVG وXHTML وXML لـ Android ومعظم XML المواجه للويب. 4 مسافات شائعة في بيئات مؤسسات Java (Maven POM وملفات سياق Spring وواصفات نشر JBoss). طابق اتفاقية ملفاتك وسلسلة أدواتك الحالية.

اضغط XML قبل تضمينه في JSON

إذا كنت بحاجة إلى تضمين سلسلة XML كقيمة حقل في JSON، اضغطه دائماً أولاً. يحتوي XML المُسنَّن على أسطر جديدة ومسافات متعددة يجب تهريبها في JSON (\n ومسافات \u0020 متعددة)، مما يُضخّم حجم الحمولة بشكل كبير. XML المضغوط أقل احتمالاً بكثير لتشغيل حدود طول السطر في وسطاء الوكلاء أو أنظمة التسجيل.

هرّب الأحرف الخاصة في محتوى النص، واستخدم CDATA باعتدال

بالنسبة لقيم النص القصيرة التي تحتوي على & أو <، استخدم مراجع الكيانات (& و<) — فهي أكثر توافقاً من أقسام CDATA وتعمل في قيم السمات أيضاً. احجز أقسام CDATA () لتضمين كتل كبيرة من الكود أو استعلامات SQL أو أجزاء HTML حيث سيجعل تهريب كل حرف خاص المحتوى غير قابل للقراءة.

أعلن عن مساحات الأسماء في أقرب وقت ممكن

أعلن عن مساحات أسماء XML (xmlns:prefix="URI") على عنصر الجذر أو أعلى عنصر يستخدم البادئة. إعلان مساحات الأسماء عميقاً في شجرة المستند يجعل XML أصعب قراءةً ويمكن أن يُسبّب مشاكل مع محللات XML المستندة إلى البث (SAX وStAX) التي تعالج مساحات الأسماء بشكل تدريجي. يُوضّح مثال مغلّف SOAP أعلاه النمط الموصى به: جميع إعلانات مساحات الأسماء على عنصر Envelope الجذر.

الأسئلة الشائعة