تحويل camelCase إلى kebab-case!

نص السلسلة
النتيجة

تحويل camelCase إلى kebab-case!

هل تسميات متغيرات الكود المنسوخة من مصادر أخرى غير متوافقة مع كودك؟ لا داعي للقلق! قم بتحويل المتغيرات إلى التنسيق المطلوب!

يحوّل الأسماء من camelCase إلى kebab-case: backgroundColor → background-color، dryRun → dry-run. الكلمات الصغيرة الموصولة بشرطات هي ما تستخدمه خصائص CSS وسمات HTML وslugs الروابط ومعظم خيارات سطر الأوامر.

تظهر فائدته أكثر عند التنقل بين JavaScript والـ markup أو الـ shell: إعادة كائن style مضمّن في React إلى ملف أنماط، أو تحويل props في Vue/Angular المكتوبة في السكربت إلى صيغة سمات القالب، أو أسماء الخيارات من إعدادات JS إلى --long-flags.

طريقة الاستخدام

  1. أبقِ camelCase على اليسار وkebab-case على اليمين.
  2. الصق تعريفات الأنماط أو أسماء props أو أسماء الخيارات في خانة نص السلسلة.
  3. انسخ النص المحوَّل من النتيجة. إذا غيّرت أيًّا من القائمتين المنسدلتين يتغير العنوان أيضًا، فيمكنك حفظ الزوج الذي تستخدمه أكثر في المفضلة.

مثال

المدخلات (camelCase)
backgroundColor: #fff;
borderRadius: 8px;
boxShadow: 0 1px 2px #0002;
--dryRun --outputDir dist
المخرجات (kebab-case)
background-color: #fff;
border-radius: 8px;
box-shadow: 0 1px 2px #0002;
--dry-run --output-dir dist

أسماء الخصائص في كائن style الخاص بـ React تصبح أسماء خصائص CSS حقيقية، ويُحوَّل جزء camelCase من --dryRun مع الإبقاء على -- في البداية. القيم مثل #fff و8px لا تُمس.

الميزات المدعومة

  • كل حرف كبير يصبح شرطة يليها الحرف نفسه صغيرًا: boxShadow → box-shadow.
  • تُحفظ البادئات مثل -- أو . أمام الاسم لأن الاستبدال يطال كلمة camelCase نفسها فقط.
  • تبقى الأرقام مع كلمتها: grid2Columns → grid2-columns.

حالات الاستخدام

من الأنماط المضمّنة إلى CSS

عندما يكبر style={{ ... }} في أحد المكونات وتنقله إلى ملف .css أو .module.css، يوفّر عليك تحويل أسماء الخصائص إعادة كتابة marginTop وzIndex وtextAlign يدويًا. لكن ما زال عليك إضافة الفواصل المنقوطة وحذف علامات الاقتباس حول القيم.

الـ props في قوالب DOM الخاصة بـ Vue

يسمح لك Vue بتعريف itemCount في السكربت لكنه يتوقع item-count عندما يُكتب القالب بـ HTML عادي. الصق قائمة الـ props لتحصل على أسماء السمات.

خيارات CLI من كائنات الخيارات

الأداة التي تُضبط بـ { outputDir, dryRun } عادةً ما توفّر --output-dir و--dry-run في سطر الأوامر.

ملاحظات وقيود

  • تُقرأ سلسلة الأحرف الكبيرة المتتالية كاختصار واحد، فيصبح innerHTML هو inner-html وgetHTTPResponse هو get-http-response. أما اختصاران متلاصقان (parseXMLHTTPRequest) فلا يمكن التمييز بينهما ويخرجان على شكل parse-xmlhttp-request.
  • أسماء JS ذات بادئات المتصفحات مثل WebkitTransform تبدأ بحرف كبير، فهي ليست camelCase وتبقى دون تغيير؛ حوّلها على حدة.

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

هل يحوّل قيم CSS-in-JS أو يضيف الوحدات؟

لا. المعرّفات وحدها تتغير. قيمة مثل fontSize: 14 تبقى 14؛ أضف px بنفسك عند النقل إلى CSS.

هل يمكنني استخدام النتيجة مباشرة كـ slug للرابط؟

بالنسبة للمعرّفات، نعم: orderHistory تصبح order-history. أما النص الحر الذي يحوي مسافات أو أحرفًا غير ASCII فاستخدم له محوّل حالة النصوص، لأن هذه الصفحة لا تعيد كتابة إلا كلمات camelCase.