ماذا تفعل الأداة
يأخذ منسّق الأكواد الكود المتكدّس أو المصغَّر أو غير المنتظم في مسافاته البادئة، ويعيد طباعته بنمط نظيف ومتّسق. ويدعم اللغات الأكثر شيوعًا في عمل الويب: HTML وCSS وSCSS وLess وJavaScript وTypeScript وJSON وXML وMarkdown وYAML وGraphQL.
تعتمد الأداة في جوهرها على Prettier، المنسّق الذي تستخدمه ملايين المشاريع، لذا تبدو النتيجة تمامًا مثل كود نُسِّق في VS Code أو بواسطة pre-commit hook. ولا يُحمَّل محلل كل لغة إلا عند اختيارها، ما يبقي الصفحة سريعة.
طريقة الاستخدام
- اختر اللغة الخاصة بالكود.
- الصق الكود، أو افتح ملفًا.
- اختر نمط المسافة البادئة (مسافتان أو 4 مسافات أو Tab) وعرض السطر. تُلَفّ الأسطر الأطول من العرض حيث تسمح اللغة بذلك.
- في JavaScript وTypeScript، اختر ما إذا كانت العبارات تنتهي بـ الفواصل المنقوطة. وفي السكربتات وملفات الأنماط، اختر علامات اقتباس مفردة إذا كان مشروعك يفضّلها.
- انسخ النتيجة أو نزّلها.
مثال
المثال صفحة HTML من سطر واحد تتضمن CSS وJavaScript مضمّنين. بعد التنسيق، يصبح كل عنصر في سطر مستقل، وتُفرَد قواعد CSS بتصريح واحد في كل سطر، وتحصل الدالة السهمية في السكربت على أقواس وفاصلة منقوطة:
<script>
const items = [1, 2, 3];
items.forEach((i) => console.log(i));
</script>
نصائح
- التنسيق أيضًا فحص سريع للصياغة. إذا لم يتمكن Prettier من تحليل الإدخال، تعرض رسالة الخطأ السطر والعمود لتنتقل مباشرة إلى موضع الخطأ.
- يُنسَّق XML مع اعتبار المسافات البيضاء غير مؤثرة كي تُزاح الوسوم المتداخلة. إذا كان مستندك يعتمد على مسافات دقيقة داخل العناصر، فراجع النتيجة قبل استخدامها.
- تحتاج العكس؟ استخدم أداة تصغير JavaScript وCSS لتقليص الكود للإنتاج، أو منسّق JSON للتحقق من JSON وتصغيره.
الأسئلة الشائعة
› ما المنسّق الذي تستخدمه هذه الأداة؟
Prettier، أكثر منسّقات الأكواد استخدامًا في مشاريع الويب، ويعمل بالكامل في متصفحك. ويأتي دعم XML من إضافة Prettier XML الرسمية. والمخرجات مطابقة لما يُنتجه Prettier في المحرر بالإعدادات نفسها.
› هل تغيّر الأداة ما يفعله الكود؟
لا. يغيّر Prettier الشكل فقط، مثل المسافة البادئة وفواصل الأسطر والمسافات ونمط علامات الاقتباس. وإذا كان في الكود خطأ نحوي، تتوقف الأداة وتشير إلى السطر بدلًا من التخمين.
› لماذا يُنسَّق أيضًا الكود داخل وسوم script وstyle في HTML؟
يُحيل منسّق HTML أكواد CSS وJavaScript المضمّنة إلى محللات Prettier المناسبة، فتعود الصفحة كلها بمسافات بادئة متناسقة.
› هل يُرفع الكود الخاص بي؟
لا. يجري التنسيق محليًا ولا يُرسَل أي شيء إلى خادم.