البرمجة

تصغير CSS وتنسيقه: راجع التعليقات والقواعد وحجم الملف

·

يقلل تصغير CSS نص ورقة الأنماط بحذف ما لا يلزم واستخدام صيغ أقصر. في ToolMellow عمليتان منفصلتان: «صغّر CSS» لإنتاج نص مكثف، و«نسّق CSS» لترتيب المصدر بمسافات بادئة تسهّل قراءته. الصق ورقة الأنماط أو افتح ملفًا نصيًا محليًا، ثم راجع «النتيجة» المنفصلة قبل استخدامها.

ابدأ بـ CSS جاهز للنشر ولا يحتوي على محددات متداخلة. حوّل التعشيق الأصلي وصيغ المعالجات المسبقة داخل مشروعك أولًا. يرفض المصغّر بعض الصيغ التي لا يستطيع تحليلها بأمان، لكن نجاح العملية لا يثبت صحة كل خاصية أو بقاء كل تعليق أو سلامة سلوك الصفحة.

ضغط CSS وتنسيقه

اعمل على ورقة الأنماط كاملة واحتفظ بالأصل

اختر «جرّب مثالًا» لمقارنة العمليتين، أو الصق مصدرك في «الإدخال» أو افتح ورقة أنماط محلية. تقرأ العمليتان الإدخال كله؛ تحديد جزء من النص لا يحصر التصغير أو التنسيق في ذلك الجزء.

لا تغيّر العملية الناجحة الإدخال، بل تنشئ «نتيجة» منفصلة للقراءة فقط. تعديل الإدخال أو إعداد المعالجة يمسح النتيجة السابقة، لذا شغّل العملية مجددًا بعد التعديل. احتفظ بنسخة من الأصل قبل استبداله بنص مصدّر أو معاد استخدامه.

  • قدّم CSS بلا محددات متداخلة، واحتفظ بنسخة من ورقة الأنماط الأصلية.
  • اختر الاحتفاظ بالتعليقات المهمة في المستوى الأعلى أو حذف جميع التعليقات.
  • اترك إعادة تنظيم القواعد معطلة أولًا، وفعّلها بعد فهم أثرها.
  • استخدم «صغّر CSS» لناتج مكثف، و«نسّق CSS» لمسافات بادئة تسهّل المراجعة.
  • راجع النتيجة كاملة والإشعارات المطلوبة والأخطاء ومقارنة البايتات.
  • انسخ النتيجة كاملة أو نزّلها، واختبرها داخل المشروع الذي سيستخدمها.

ميّز بين إعدادات التصغير وإعدادات التنسيق

تستخدم عملية «صغّر CSS» خيارات التعليقات وإعادة تنظيم القواعد. أما «نسّق CSS» فتستخدم المسافة البادئة ومحرك تنسيق مستقلًا. لذلك لا يوجّه خيار التصغير المنسّق إلى حذف التعليقات أو دمج القواعد.

تبدأ الأداة بمسافتين، ووضع الاحتفاظ بالتعليقات المهمة، وإعادة تنظيم معطلة. «التفاف الأسطر» يغيّر العرض في المحرر. لا يوجد هنا إعداد لقائمة المتصفحات المستهدفة أو فحص المشروع أو تصدير source map.

ميّز بين إعدادات التصغير وإعدادات التنسيق
الإعداد أو العمليةالقيمة هناالأثر
صغّر CSSمصدر ورقة أنماط مكثفيستخدم إعدادَي التعليقات وإعادة التنظيم.
نسّق CSSمصدر ورقة أنماط سهل القراءةيستخدم إعداد المسافة البادئة.
المسافة البادئةمسافتان أو 4 مسافات؛ الافتراضي مسافتانتؤثر في التنسيق، لا في بنية ناتج التصغير.
التعليقات عند التصغيراحتفظ بالمهمّة (!) أو احذف الكليعتمد بقاء التعليق المهم على موضعه أيضًا.
اسمح بإعادة تنظيم القواعدمعطّل افتراضيًايفعّل مرحلة إضافية من التحسين البنيوي.
التفاف الأسطرعرض فقطلا يضيف فواصل أسطر إلى المصدر.
النتيجةللقراءة فقطيظهر الناتج الناجح منفصلًا عن الإدخال.
إشعار الحجمبايتات UTF-8 ونسبة مئوية مقربة إلى عدد صحيحقد يبيّن أن النتيجة أصغر أو أكبر.

CSSO: واجهة التصغير وخيارات الضغطخيارات تنسيق Prettier

راجع موضع التعليق المهم، لا علامته وحدها

يحتفظ وضع التصغير الافتراضي بالتعليقات على هيئة /*! ... */ في المستوى الأعلى. يحذف التعليقات العادية. وقد يفقد تعليقًا مهمًا داخل قاعدة أو كتلة متداخلة؛ فالخيار لا يضمن الاحتفاظ بكل تعليق يتضمن إشعارًا.

مثلًا قد يبقى التعليق /*! attribution */ في المستوى الأعلى، بينما يضيع التعليق نفسه داخل .a { ... } بعد التصغير. افحص كل إشعار مطلوب قبل استخدام النتيجة. «احذف الكل» يحذف أيضًا التعليقات المهمة التي كانت ستبقى في المستوى الأعلى. أما «نسّق CSS» فتتبع سلوك التنسيق المستقل ولا تستخدم إعداد الحذف هذا.

CSSO: واجهة التصغير وخيارات الضغط

تعطيل إعادة التنظيم لا يجعل التغيير مقتصرًا على الفراغات

تكون إعادة تنظيم القواعد معطلة في البداية. لكن التنظيف والاستبدال بصيغ أقصر يظلان نشطين: قد يتحول اللون #ffffff إلى #fff، والطول الصفري 0px إلى 0. تعطيل إعادة التنظيم لا يعني تعديل المسافات وحدها.

قد يدمج تفعيل إعادة التنظيم القواعد أو يعيد ترتيبها. في مثال تمت ملاحظته، يتحول .a{color:red}.b{color:red} إلى .a,.b{color:red} عند تفعيلها. قارن الناتج واختبر ورقة الأنماط في تطبيقك؛ لا يضمن أي من الوضعين تطابق العرض في كل سياق.

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

CSSO: واجهة التصغير وخيارات الضغط

نسّق للمراجعة، لا لاستعادة ما حُذف

تعيد «نسّق CSS» ترتيب المصدر بمسافتين أو أربع مسافات بادئة. قد تسهّل قراءة ورقة مكثفة، وقد تبقى في الناتج تعليقات عادية أو مهمة موجودة في ذلك الإدخال. لا تسري على هذه العملية خيارات حذف التعليقات أو إعادة تنظيم القواعد.

تنسيق نص سبق تصغيره لا يستعيد التعليقات المحذوفة أو الفراغات الأصلية أو ترتيب القواعد السابق. تقرأ العمليتان الإدخال، لا نتيجة العملية الأخرى. لتنسيق ناتج التصغير عمدًا، استخدم أولًا «استخدم النتيجة كإدخال» واحتفظ بالأصل منفصلًا.

خيارات تنسيق Prettier

حوّل التعشيق والمعالجات المسبقة قبل التصغير

قدّم ورقة أنماط كاملة بلا محددات متداخلة، لا مقطع تصريحات مثل color:red;margin:0; وحده. حوّل Sass وLess وCSS المتداخل في مشروعك قبل «صغّر CSS». لا تحل مساحة العمل الاستيرادات ولا توسّع المتغيرات ولا تجمع ملفات المشروع.

قد يقبل المحللان مصادر مختلفة. يمكن أن تنسّق «نسّق CSS» محددًا متداخلًا مثل .a{color:red;&:hover{color:blue}} بينما ترفضه «صغّر CSS». لذلك لا يثبت نجاح التنسيق دعم التصغير للمصدر نفسه أو جاهزيته للمتصفحات المستهدفة.

W3C CSS Syntax: مقدمة معالجة الأخطاء

الرفض يمنع ناتجًا ناقصًا، لكنه لا يكتشف كل خطأ في CSS

يتوقف المصغّر عند بعض القواعد أو التصريحات التي لا يستطيع تحليلها بأمان، بدل إسقاطها بصمت وإرجاع CSS. يبقى الإدخال ولا تظهر نتيجة جزئية ناجحة. راجع المصدر، وحوّل الصيغ غير المدعومة عند الحاجة إلى CSS بلا محددات متداخلة ثم أعد العملية.

قد يقبل المحلل مدخلات أخرى بتسامح. في حالة تمت ملاحظتها أضاف القوس الختامي المفقود وأنتج نتيجة، وقد تبقى أسماء خصائص أو قيم غير معروفة. اقرأ ملخص الخطأ المحلي وافتح التفاصيل التقنية الأصلية، التي قد تكون بالإنجليزية. تتضمن بعض أخطاء المحلل سطرًا وعمودًا، لكن ليس كل رفض مصحوبًا بموقع.

W3C CSS Syntax: مقدمة معالجة الأخطاء

اقرأ وفورات البايتات بوصفها مقارنة لحجم المصدر

يقارن إشعار الحجم بايتات UTF-8 للإدخال والنتيجة، ويعرض وحدات B أو KB أو MB العشرية ونسبة مقربة إلى عدد صحيح. هذه مقارنة لنص المصدر؛ لا تقيس حجم النقل بعد gzip أو Brotli أو سرعة الصفحة أو أثر التخزين المؤقت.

قد يزيد التنسيق الحجم بإضافة ترتيب مقروء. وقد ينتج عن تصغير قواعد فارغة أو إدخال لا يحوي إلا تعليقًا عاديًا نص فارغ. تظل النتيجة الناجحة ذات الطول الصفري قابلة للتصدير؛ راجع أن الفراغ مقصود بدل الحكم على النجاح من انخفاض الرقم وحده.

اقرأ وفورات البايتات بوصفها مقارنة لحجم المصدر
المعلومة المعروضةمعناهاحدود المقارنة
بايتات الإدخالحجم الإدخال الحالي بترميز UTF-8يختلف عن المحارف المرئية ووحدات UTF-16 للإدخال.
بايتات النتيجةحجم النتيجة كاملة بترميز UTF-8ليس قياسًا للنقل الشبكي المضغوط.
نسبة الانخفاضانخفاض البايتات مقربًالا تضمن سرعة الصفحة أو ثبات سلوكها.
نسبة الزيادةتحتوي النتيجة بايتات UTF-8 أكثرقد يحدث ذلك بعد التنسيق.
ناتج فارغ ناجحلا نص مصدر في النتيجةقد ينتج عن حذف التعليقات أو القواعد الفارغة.

للبايتات والنص المفكوك حدان مستقلان

يقبل الإدخال حتى 1,000,000 وحدة ترميز UTF-16. يختلف ذلك عن بايتات UTF-8 والمحارف المرئية: يشغل محرف إضافي مثل 🌿 وحدتين من UTF-16. يجب أن يستوفي الملف المحلي شرط الحجم بالبايت وأن يظل نصه بعد فك الترميز ضمن الحد المسموح.

قد يتجاوز الناتج حد الإدخال المستقل، خصوصًا عند التنسيق. تبقى النسخة الكاملة والتحميل متاحين، لكن «استخدم النتيجة كإدخال» ترفض الناتج الأكبر من الحد وتحتفظ بالإدخال والنتيجة الحاليين.

للبايتات والنص المفكوك حدان مستقلان
العنصرالحدالسلوك عند الحد
إدخال ملصق أو قيد المعالجة1,000,000 وحدة ترميز UTF-16يُقبل النص عند الحد نفسه ويُرفض ما يزيد عليه.
ملف محليأقل من 4,000,000 بايت حصرًايُرفض ملف حجمه 4,000,000 بايت قبل قراءته.
نص الملف بعد فك الترميز1,000,000 وحدة ترميز UTF-16يجب أن يظل ضمن الحد بعد فك الترميز باستخدام UTF-8.
استخدم النتيجة كإدخال1,000,000 وحدة ترميز UTF-16يبقى الناتج الأكبر متاحًا للتصدير كاملًا.
نص البحث1,000 وحدة ترميز UTF-16لطول نص البحث الحرفي حد مستقل.
نص الاستبدال10,000 وحدة ترميز UTF-16يُرفض التعديل الذي يتجاوز حد الإدخال.
سجل التراجع والإعادةحتى 20 لقطة سابقةتشارك تغييرات الإدخال المقبولة السجل المحدود نفسه.
مجموع نص السجل4,000,000 وحدة ترميز UTF-16لا يشمل الإدخال الحالي؛ ينطبق على اللقطات السابقة المحفوظة.

استورد مصدر ورقة الأنماط كنص UTF-8

يجلب «افتح ملفًا نصيًا» المصدر المحلي إلى الإدخال. يفحص المستورد بايتات الملف أولًا، ثم يفك ترميزها باستخدام UTF-8 عبر طريقة قراءة نص الملف، ثم يتحقق من طول النص المفكوك. لا يوجد اختيار للترميز؛ لا يغيّر اسم الملف أو نوع MIME أو تصريح ترميز CSS طريقة فك الترميز.

حوّل ورقة الأنماط ذات الترميز المختلف إلى UTF-8 في محرر مناسب قبل استيرادها. تقرأ الأداة نصًا محليًا؛ لا تجلب CSS من URL ولا تستخرج CSS من PDF أو Word ولا تحمل الموارد المذكورة في ورقة الأنماط.

W3C File API: فك ترميز نص Blob

انسخ النتيجة كاملة أو نزّلها

يأخذ «انسخ النتيجة» و«تنزيل» النتيجة كلها، لا النص المحدد أو الأسطر الظاهرة فقط. ينشئ التنزيل نص UTF-8 باسم toolmellow-result.css. إذا لم تتوفر الحافظة، حدّد النتيجة وانسخها يدويًا.

يحتوي التنزيل على مصدر ورقة الأنماط. لا يجمع الصور أو الخطوط أو أوراق الأنماط المستوردة أو source map. احتفظ بهذه الموارد ومسارات النشر ضمن مشروعك، وراجع التغييرات قبل استبدال الملف الأصلي.

أعد استخدام النتيجة عمدًا وضمن حد الإدخال

يستبدل «استخدم النتيجة كإدخال» الإدخال بنتيجة ناجحة تقع ضمن الحد. ويمسح النتيجة السابقة، لذا شغّل العملية التالية بعد ذلك. إنشاء نتيجة منفصلة وحده لا يعدّل الإدخال ولا يضيف تعديلًا إلى سجل الإدخال.

في حالة تمت ملاحظتها، جعل التنسيق إدخال تعليق بطول مليون وحدة يبلغ 1,000,001 وحدة بإضافة فاصل سطر أخير. يمكن نسخ النتيجة كاملة أو تنزيلها، لكن إعادة الاستخدام تُرفض مع بقاء الإدخال والنتيجة. هذا لا يعني اقتطاع الناتج المصدّر.

افصل التحرير الحرفي عن التفاف الأسطر والمسح

يبحث البحث والاستبدال في نص الإدخال حرفيًا، مع خيار مطابقة حالة الأحرف. لا يستخدم تعبيرات نمطية ولا يعيد تسمية رمز CSS على مستوى المشروع. يُدرج نص استبدال مثل $& كما هو. راجع المطابقات قبل تعديل محددات متكررة أو سلاسل أو عناوين URL؛ يمسح التعديل المقبول النتيجة السابقة.

يغيّر «التفاف الأسطر» عرض مربعي الإدخال والنتيجة من دون إضافة فواصل أسطر إلى المصدر. لا يغيّر CSS المنسوخ أو المنزّل. يبقى اتجاه الشيفرة من اليسار إلى اليمين حتى مع واجهة من اليمين إلى اليسار.

يتتبع التراجع والإعادة تعديلات الإدخال والاستيراد والاستبدال وإعادة استخدام النتيجة ضمن السجل المتاح. لا يتراجعان عن إنشاء نتيجة منفصلة. يمسح «مسح» الإدخال والنتيجة ونص البحث والسجل، مع بقاء خيارات المعالجة والالتفاف. لا يمكن التراجع عن المسح.

تحتاج المعالجة المحلية أيضًا إلى تحميل المحرك

تعمل المعالجة في عامل داخل المتصفح. يحتفظ المحرران بـ CSS كنص ولا يطبّقانه على صفحة معاينة، لذلك لا يجلبان عناوين الصور أو الخطوط المكتوبة فيه. لا يجعل ذلك أي ناتج عشوائي آمنًا للاستخدام في مكان آخر. قد يتطلب تحميل موارد العامل والمحرك شبكة؛ المعالجة المحلية وحدها لا تضمن التشغيل دون اتصال من أول زيارة.

إذا تعذر تحميل المحرك، احتفظ بالإدخال وأعد المحاولة عند عودة الاتصال. يمكن للإلغاء إيقاف عملية معلقة مع الاحتفاظ بالإدخال. المهلة المضبوطة لبدء التشغيل والمعالجة 60 ثانية؛ الزمن الفعلي يعتمد على المتصفح والمصدر. احفظ نسخة بنفسك بدل اعتبار علامة التبويب نسخة احتياطية.

Prettier: التشغيل في المتصفح

راجع CSS في المشروع الذي سيستخدمه

قارن ورقة الأنماط المصدرة بالأصل، بما في ذلك الإشعارات المطلوبة والقواعد الحساسة للترتيب. شغّل اختبارات المشروع وافحص الصفحات والتخطيطات المتجاوبة وحالات التفاعل المتأثرة. صغر الملف لا يثبت بقاء هذه السلوكيات كما هي.

لا تحدد الأداة المحددات غير المستخدمة من HTML، ولا تعيد كتابة عناوين الموارد للنشر، ولا تختار المتصفحات المستهدفة، ولا تتحقق من إمكانية الوصول. أبقِ هذه المهام في بناء المشروع ومراجعته؛ التصغير أو التنسيق هنا خطوة لتحرير المصدر.

W3C CSS Syntax: مقدمة معالجة الأخطاء

أسئلة شائعة

لماذا قد يضيع تعليق CSS مهم؟

يحتفظ وضع التصغير الافتراضي بتعليقات /*! ... */ في المستوى الأعلى. وقد تضيع التعليقات داخل القواعد أو الكتل المتداخلة. افحص كل إشعار مطلوب في النتيجة قبل استخدامها؛ لا تحدد الأداة الإشعارات التي يلزمك الاحتفاظ بها.

هل يعطّل إيقاف إعادة التنظيم جميع التحسينات؟

لا. يبقى التنظيف والاستبدال بصيغ أقصر نشطين، لذلك قد تتغير القيم والمصدر بما يتجاوز الفراغات. يتحكم الخيار في المرحلة الإضافية التي قد تدمج القواعد أو تعيد ترتيبها. راجع الناتج في الحالتين.

هل يغيّر إعداد التعليقات عملية «نسّق CSS»؟

لا. يخص حذف التعليقات وإعادة تنظيم القواعد عملية «صغّر CSS». تستخدم «نسّق CSS» عملية مستقلة ومسافتين أو أربع مسافات بادئة.

هل يستعيد التنسيق ورقة الأنماط الأصلية؟

لا. قد يسهل قراءة المصدر المكثف، لكنه لا يستعيد التعليقات المحذوفة أو الفراغات الأصلية أو ترتيب القواعد القديم. احتفظ بالأصل منفصلًا. ولتشغيل العملية التالية على النتيجة، اجعلها إدخالًا أولًا.

لماذا قد يُرفض ملف CSS أصغر من 4 MB؟

يجب أن يكون الملف أصغر من 4,000,000 بايت حصرًا، وأن يقع نصه بعد فك الترميز باستخدام UTF-8 ضمن حد الإدخال المستقل البالغ 1,000,000 وحدة UTF-16. حجم البايتات وحده لا يثبت أن النص المفكوك ضمن الحد.

هل يمكن تصغير CSS المحدد وحده؟

لا. تقرأ العمليتان الإدخال كله، ولا يقلّ نطاقهما بالتحديد. لمعالجة جزء منفصل، ضعه كاملًا في إدخال مستقل.

لماذا لا أستطيع استخدام النتيجة كإدخال؟

قد ينتج التنسيق نصًا أكبر من حد الإدخال. إذا تجاوزت النتيجة 1,000,000 وحدة UTF-16 تُرفض إعادة الاستخدام مع بقاء الإدخال والنتيجة. يظل النسخ والتنزيل الكاملان متاحين.

هل يتحقق التصغير من صحة CSS أو يحذف المحددات غير المستخدمة؟

لا. يرفض بعض الصيغ التي لا يستطيع تحليلها بأمان، لكنه قد يقبل صياغة أصلحها المحلل أو خصائص غير معروفة أو قيمًا غير صالحة. لا يفحص صفحاتك أو مشروعك لمعرفة استخدام المحددات. استخدم تحقق المشروع وأدوات تراعي الاستخدام لهذه المهام.

هل يمكن التراجع عن المسح؟

لا. يزيل المسح الإدخال والنتيجة ونص البحث وسجل التراجع والإعادة المحفوظ. قبل المسح يمكن التراجع عن تعديلات الإدخال العادية المقبولة ضمن السجل المتاح فقط.

هل يمكن تصغير تعشيق CSS الأصلي؟

حوّل التعشيق إلى CSS بلا محددات متداخلة قبل «صغّر CSS». قد تُرفض القواعد المتداخلة غير المدعومة. يمكن أن تنسّق «نسّق CSS» المصدر المتداخل، لكنها لا تحوّل التعشيق إلى CSS غير متداخل ولا تثبت دعم المصغّر له.

هل تترجم الأداة Sass أو Less إلى CSS؟

لا. استخدم مترجم مشروعك وإعداداته، ثم قدّم CSS الناتج بلا محددات متداخلة. لا تحل مساحة العمل استيرادات المشروع أو متغيراته أو تبعيات البناء.

هل وفورات البايتات هي وفورات gzip أو Brotli؟

لا. يقارن الإشعار بايتات مصدر UTF-8 مع نسبة مقربة، ولا يقيس النقل المضغوط أو التخزين المؤقت أو سرعة تحميل الصفحة. قد يزيد التنسيق حجم النتيجة.

هل يشمل التنزيل الموارد أو source map؟

لا. يصدّر التنزيل النتيجة كاملة كنص UTF-8 باسم toolmellow-result.css. لا يجمع الصور أو الخطوط أو أوراق الأنماط المستوردة أو source map.

هل تعمل المعالجة المحلية دون اتصال فورًا؟

لا يُضمن التشغيل دون اتصال من أول زيارة. تتم المعالجة في عامل المتصفح، لكن يجب تحميل الصفحة وموارد العامل والمحرك. إن تعذر تحميل المحرك، احتفظ بالإدخال وحاول بعد عودة الاتصال.

المراجع الأساسية

جرّب بنفسك.

أدلة ذات صلة