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

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

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

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

يحوّل PascalCase إلى kebab-case: SearchResultList → search-result-list. أسماء المكونات في الكود تكون بصيغة PascalCase، لكن الأسماء الموجّهة إلى HTML تكون موصولة بشرطات: مكونات Vue المستخدمة في قوالب DOM، ووسوم العناصر المخصصة، وأسماء أصناف CSS في BEM، وأسماء الملفات في كثير من أدلة الأسلوب.

الصق مواضع استخدام المكونات أو أسماء الأصناف أو قائمة exports لتحصل على أسماء الوسوم أو الملفات أو الأصناف على جانب الـ markup.

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

  1. اضبط المصدر على PascalCase والهدف على kebab-case.
  2. الصق markup القالب أو أسماء المكونات أو الـ exports في نص السلسلة.
  3. انسخ الناتج من النتيجة.

مثال

المدخلات (PascalCase)
<DatePicker />
<UserCard :user="user" />
<SearchResultList />
المخرجات (kebab-case)
<date-picker />
<user-card :user="user" />
<search-result-list />

تصبح وسوم المكونات موصولة بشرطات، وهي الصيغة التي يشترطها Vue حين تُكتب القوالب مباشرة في ملف HTML. أما الربط :user="user" فبأحرف صغيرة ولا يتغير.

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

  • يضع شرطة قبل كل حرف كبير بعد الأول ويصغّر الاسم: UserCard → user-card.
  • يترك الـ markup المحيط مثل < و/> والسمات كما هو.
  • تبقى الأرقام ملتصقة: Step2Form → step2-form.

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

مكونات Vue في القوالب داخل DOM

لغة HTML لا تميّز حالة الأحرف، لذا يجب أن يصبح <DatePicker> المكتوب داخل صفحة .html على شكل <date-picker>. تحويل الـ markup يفعل ذلك لكل مكوّن متعدد الكلمات دفعة واحدة.

أسماء الملفات وأصناف CSS من المكونات

أدلة الأسلوب التي تسمّي الملفات date-picker.tsx أو تستخدم صنف block مثل .search-result-list يمكنها اشتقاق الاثنين من اسم المكوّن.

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

  • تبقى الاختصارات قطعة واحدة: XMLParser → xml-parser، UIButtonGroup → ui-button-group.
  • المكونات المكوّنة من كلمة واحدة (Modal، Button) لا يُتعرّف عليها وتبقى بحرف كبير، فعدّلها يدويًا.

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

هل هكذا تُسمّى محدِّدات Angular؟

محدِّدات Angular بصيغة kebab-case مع بادئة، مثل app-user-card لـ UserCardComponent. حوّل الاسم وأضف البادئة بنفسك.

لماذا لم يتغير <Modal />؟

لا تُعامل كـ PascalCase إلا الأسماء التي فيها حرفان كبيران على الأقل، لذا تُتخطى المكونات المكوّنة من كلمة واحدة.