تحويل النص إلى camelCase أولُ كلمةٍ صغيرة مجاناً عبر الإنترنت آمن

لماذا تحوّل النص إلى camelCase

افتح أي ملف JavaScript تقريباً، أو أي صنف Java، أو أي شيفرة Swift أو Kotlin، وستبدو الأسماء متشابهة: userName وtotalPrice وgetCustomerById وisLoggedIn. الكلمات متلاصقة بلا فراغ ولا فاصل، الأولى صغيرة وكل ما بعدها يبدأ بحرف كبير، حتى إن الحدبات في وسط الكلمة تعطي الأسلوب اسمه. هذا هو camelCase، وهو الشكل الذي استقرت عليه معظم لغات عائلة C للمتغيرات والدوال. وتحويل النص إلى camelCase هو تحويل عبارة كما يكتبها إنسان إلى اسم يقبله برنامج ويتعرف عليه مبرمج.

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

ما يفعله التحويل

قطع، وصغير أولاً، وكبير بعد ذلك، ووصل

تقطّع الصفحة السطر أولاً إلى كلمات. وتبقى الكلمة الأولى صغيرة. وتأخذ كل كلمة بعدها حرفاً كبيراً في البداية، والباقي بحروف صغيرة. ثم تُوصل الكلمات بلا شيء بينها. فالسطر Crème brûlée for 2 — straße 17, fooBar يعود على أنه crèmeBrûléeFor2Straße17FooBar. فالعلامات فوق الحروف تُحفظ، والأرقام تقف كلمات قائمة بذاتها، والشرطة والفاصلة تختفيان، وfooBar، التي تقطعها الصفحة عند حرفها الكبير، أُعيدت إلى شكل FooBar في النهاية.

أين تقع القطوع

حد الكلمة هو فراغ أو علامة ترقيم أو شرطة أو رمز أو الانتقال من حرف صغير إلى كبير داخل كلمة. وعليه فإن customer first name وcustomer-first-name وcustomer_first_name وcustomerFirstName تصبح كلها customerFirstName. ويقبل التحويل أي نقطة بداية تقريباً ويصل دائماً إلى الشكل نفسه، وهذا يجعله خطوة أخيرة موثوقة قبل أن يدخل اسم في الشيفرة.

نسخ النتيجة

يقوم زر بجانب النتيجة بنسخها إلى الحافظة. الصقها في المحرر أو الملف حيث يلزم الاسم.

ما لا يفعله التحويل

لا يحافظ على علامات الترقيم

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

لا يزيل العلامات فوق الحروف

يحتفظ السطر بحروفه المشكولة: crèmeBrûlée. وتسمح لغات كثيرة بها في الأسماء، لكن أدوات وأدلة أسلوب كثيرة لا تسمح. فإذا احتجت إلى حروف سادة، فمرّر العبارة أولاً عبر صفحة slug العنوان، التي تنزع العلامات عن الحروف اللاتينية، ثم حوّل النص إلى camelCase.

لا يتحقق من أن الاسم قانوني

لدى لغات البرمجة قواعدها الخاصة. فقد لا يبدأ الاسم برقم، وقد لا يكون كلمة محجوزة. وعبارة مثل 2 for 1 تصبح 2For1، وترفضها معظم اللغات عند الحرف الأول. وتصنع الصفحة الشكل؛ وأنت تتحقق من الصلاحية.

camelCase وPascalCase

الفكرة نفسها، حرف أول مختلف

حين تبدأ الكلمة الأولى أيضاً بحرف كبير، كما في CustomerFirstName، يسمى الأسلوب PascalCase أو UpperCamelCase أو StudlyCaps. والعرف في معظم اللغات أن يُستخدم PascalCase للأنواع والأصناف وcamelCase للمتغيرات والدوال والأساليب. وتنتج هذه الصفحة الشكل ذا الحرف الأول الصغير. وللحصول على PascalCase حوّل العبارة وارفع الحرف الأول بيدك.

لماذا يهم الحرف الأول

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

اللغة مهمة

كتابات تُكتب بلا فراغات

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

التركية والياء المنقوطة

رفع الحرف الأول من كل كلمة يتبع قواعد لغة الصفحة. ففي التركية، الكبير للحرف i هو İ والكبير للحرف ı هو I. والمحوّل الذي يطبق القواعد الإنجليزية يغيّر الكلمات. وتتبع هذه الصفحة اللغة التي كُتبت بها.

الألمانية وحرف s الحاد

يبقى الحرف الألماني ß في وسط كلمة كما هو، كما في straße. أما STRASSE بالحروف الكبيرة فتعود strasse، بحرف s مزدوج.

كتابات بلا حروف كبيرة

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

أين يكون camelCase هو العرف

JavaScript وTypeScript

تُكتب المتغيرات والدوال وخصائص الكائنات بـ camelCase، وكذلك خصائص كائنات JSON في معظم واجهات الويب. والعبارة التي تحوّل النص إلى camelCase من أجلها متجهة على الأرجح إلى أحدها.

Java وKotlin وSwift وC# وDart

العادة نفسها تسري على المتغيرات المحلية والأساليب، مع استخدام PascalCase للأصناف، وفي C# للأساليب والخصائص أيضاً. ودليل أسلوب الفريق يحسم التفاصيل.

JSON من خدمات الويب

ترسل واجهات برمجة كثيرة مفاتيح مثل firstName وorderTotal. وإذا بدأت بياناتك جدولاً، فإن من CSV إلى JSON يحوّل صف الرأس إلى مفاتيح، والرؤوس التي حُوّلت إلى camelCase تصبح مفاتيح تستطيع الشيفرة قراءتها دون أقواس وعلامات اقتباس. وفي الاتجاه المعاكس، يكتب من JSON إلى CSV المفاتيح مرة أخرى رأساً.

الوسوم والمعرّفات

خارج البرمجة يُستخدم camel case للوسوم مثل #SpringGardenTips، لأن الحروف الكبيرة تعلّم حدود الكلمات للعين. وهو أفضل أيضاً لإمكانية الوصول: فقارئات الشاشة تقرأ وسماً بحروف كبيرة ككلمات منفصلة، وسلسلة من الحروف الصغيرة ككلمة واحدة غريبة.

أين لا يكون هو العرف

Python وRuby وقواعد البيانات

تفضل هذه الشرطات السفلية. ولها تكون snake_case هي الأداة.

CSS وعناوين الويب

تستخدم أسماء الأصناف والخصائص المخصصة والعناوين الواصلات. انظر kebab-case.

النثر والعناوين

camelCase للأسماء، لا للقراءة. وعنوان أو جملة به ثقيل على العين. وللعنوان فكّر في Title Case.

كيف تحوّل النص إلى camelCase هنا

الصق نصك أو اكتبه

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

افحص القطوع والمختصرات

انظر أين قُسمت الكلمات، وكيف عُوملت المختصرات. فاسم مثل parseHtmlString وآخر مثل parseHTMLString عرفان مختلفان، وتطبق الصفحة قاعدة واحدة في كل مكان.

انسخها

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

السطر نفسه في الكتابات السبع كلها

جدول بالأشكال

تحت المحوّل يعرض جدول سطر المثال بالأشكال السبعة كلها التي يقدمها الموقع: حروف كبيرة، وحروف صغيرة، وTitle Case، وsnake_case، وkebab-case، وcamelCase، وslug عنوان. وهي طريقة سريعة لترى كيف تبدو الكلمات نفسها في كل منها.

من أين تأتي هذه الأشكال

أبجديتان

كانت الحروف الكبيرة والصغيرة يوماً أبجديتين مختلفتين. فالكبيرة رومانية، نُحتت في الحجر بإزميل؛ والصغيرة تنحدر من الحروف الصغيرة الكارولنجية، التي شكّلها قلم يتحرك بسرعة على الرق. وأبقى الطباعون الاثنتين في درجين منفصلين، الدرج العلوي والدرج السفلي (upper case وlower case)، وبقيت التسميتان طويلاً بعد زوال الدرجين.

أسماء بلا فراغات

أشكال البرمجة أحدث بكثير وابتُكرت لحل مشكلة واحدة: لا يمكن أن يحتوي اسم على فراغ. فقد جاء snake_case من لغة C المبكرة، وcamelCase من Smalltalk، وkebab-case من Lisp، وslug العنوان من الحاجة إلى وضع عنوان بشري في عنوان لا تُسمح فيه الفراغات والعلامات فوق الحروف. وفي camelCase تقوم الحروف الكبيرة بالعمل الذي تقوم به الشرطة السفلية أو الواصلة في مكان آخر، فتعلّم أين تنتهي كلمة وتبدأ التالية.

camelCase في سير العمل الأوسع

من مواصفات إلى شيفرة

تُكتب وثائق المتطلبات جملاً، وتُكتب الشيفرة أسماء. وبينهما على أحدهم أن يترجم كل اسم وفعل إلى معرّف. وفعل ذلك يدوياً بطيء ويدعو إلى عدم الاتساق: يكتب مطور customerName ويكتب آخر clientName للشيء نفسه. وإذا اتفق الفريق على أن يحوّل النص إلى camelCase من الصياغة الدقيقة للمواصفات، تتبع الأسماء الكلمات، ويستطيع أي شخص أن يجد الشيفرة التي يشير إليها متطلب بالبحث عن العبارة.

من رأس جدول إلى مفتاح كائن

في جداول البيانات رؤوس مثل First Name وOrder Total وDate Of Birth. وحين تصبح البيانات سجلات في برنامج، تصبح هذه الرؤوس مفاتيح. وتحويل كل رأس إلى camelCase يعطي firstName وorderTotal وdateOfBirth، التي تستطيع الشيفرة قراءتها خصائص دون علامات اقتباس أو أقواس. وإذا كان على البيانات أن تعود إلى جدول بيانات، فإن من JSON إلى XLSX يكتب المفاتيح صفاً أول، وتُغلق الحلقة.

من ملف تصميم إلى مكوّن

تسمي أدوات التصميم الطبقات بكلمات عادية: Primary Button وCard Title. وحين يبني المطورون المكونات تصبح هذه الأسماء معرّفات مثل primaryButton وcardTitle، أو أسماء الأصناف primary-button وcard-title. وجعل التطابق واضحاً يجعل التسليم أسلس. وللمقاسات والألوان المرافقة للطبقات، يحوّل من px إلى rem ومن HEX إلى RGB القيم التي تقف خلف الأسماء.

البحث عما سميته

الأسلوب المتسق يجعل البحث فعالاً. فإذا كانت كل خاصية بـ camelCase، فإن بحثاً عن orderTotal يجد كل الاستخدامات، وبحثاً عن ordertotal أو order_total لا يجد شيئاً، وهذا بحد ذاته مفيد. أما الأساليب المختلطة فتبعثر الفكرة نفسها عبر تهجئات وتخفيها عن البحث.

إعادة التسمية بأمان

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

اختبر بضعة أسماء في المكان الذي ستعيش فيه

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

أسماء تُقرأ جيداً

ابدأ بفعل للدوال

الدالة فعل، وينبغي أن يقول اسمها ذلك: getUserName وcalculateTotal وisValid. وحين تحوّل النص إلى camelCase لدالة، ابدأ العبارة بالفعل.

استخدم أسماء للقيم

المتغير يحمل شيئاً: userName وtotalPrice وorderList. والقيم المنطقية تُقرأ أفضل أسئلة: isActive وhasAccess وcanEdit.

كن متسقاً في المختصرات

بعض الفرق تكتب parseHTML وبعضها parseHtml. وكلاهما جيد؛ والخلط ليس جيداً. اختر واحداً وطبقه على كل اسم، وستكون شيفرتك أسهل بحثاً.

أبقِ الأسماء قابلة للنطق

اسم تستطيع قراءته بصوت عالٍ هو اسم تستطيع مناقشته. وcustFnDt ليس كذلك، وcustomerFirstDate كذلك. والتحويل يحفظ ما تكتبه، فاكتب شيئاً يستحق الحفظ.

أفخاخ عند تحويل النص إلى camelCase

اسم يبدأ برقم

ترفضه معظم اللغات. ضع كلمة أو حرفاً في المقدمة.

الكلمات المحجوزة

عبارة مثل class أو new أو default هي كلمة مفتاحية في لغات كثيرة. والصفحة لا تعرف أيها. افحص قبل أن تستخدم الاسم.

المختصرات وسلاسل الحروف الكبيرة

قد تفاجئك القطوع حول سلسلة من الحروف الكبيرة. اقرأ النتيجة وقارنها بعرفك.

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

مسموحة في بعض اللغات ولا في أخرى. وإذا كان الاسم سيمر عبر أدوات أقدم، فأزل العلامات أولاً.

أسئلة يطرحها الناس قبل التحويل

ماذا يحدث لعلامات الترقيم؟

تُعامل حداً بين الكلمات ولا تُنقل.

هل تُحفظ الأرقام؟

نعم، ككلمات قائمة بذاتها، موصولة بالباقي.

هل يتعامل مع مدخل مكتوب أصلاً بـ snake_case أو kebab-case؟

نعم. فالشرطات السفلية والواصلات حدود، ولذلك يصبح my_variable_name هو myVariableName.

كيف أحصل على PascalCase؟

حوّل، ثم ارفع الحرف الأول بيدك.

هل يُرفع نصي؟

لا. ما تكتبه هنا لا يُرسل أبداً إلى أي مكان، فمسودة أو كلمة مرور أو اسم عميل آمن هنا كما في محرر نصوص.

كيف أحصل على شرطات سفلية أو واصلات بدلاً من ذلك؟

باستخدام حوّل النص إلى snake_case أو حوّل النص إلى kebab-case.

مثال محلول

لنفترض أنك تكتب سكربتاً صغيراً لحساب رسم توصيل، وتسمي المواصفات القيم delivery fee per kilometre وfree delivery threshold وis express order. تحوّل كلاً بدوره وتقرأ deliveryFeePerKilometre وfreeDeliveryThreshold وisExpressOrder. يبدأ الأول باسم، وهذا صحيح لقيمة؛ ويبدأ الأخير بـ is، التي تعلّم راية نعم أو لا. تلصق الثلاثة في السكربت أسماء متغيرات، فتستخدم المواصفات والشيفرة الآن الكلمات نفسها بالترتيب نفسه، وهذا يجعل المراجعة سهلة.

قائمة تحقق قصيرة

قبل التحويل

اكتب العبارة بكلمات عادية. وابدأ الدوال بفعل والرايات بـ is أو has. وافحص اللغة المستهدفة بحثاً عن كلمات محجوزة.

أثناء التحويل

الصق العبارة، وانظر إلى القطوع، وتأكد من أن الاسم يبدأ بحرف.

بعد التحويل

افحص الطول والمختصرات، واستخدم الاسم نفسه في كل مكان يلزم فيه.

أخطاء شائعة

استخدام camelCase لنص سيقرؤه الناس

إنه للأسماء، لا للنثر.

خلط الأعراف في مشروع واحد

اختر camelCase أو snake_case أو kebab-case لكل طبقة، والتزم به.

نسيان ما تسمح به الوجهة

الأرقام في البداية والعلامات فوق الحروف والكلمات المحجوزة تختلف بين اللغات.

نصك يبقى على جهازك

يجري التحويل محلياً. يعالج متصفحك نصك ولا يُرسل شيء إلى أي مكان. ولا شيء يُحذف بعد ذلك ولا حساب يُنشأ. هذه هي الطريقة البسيطة لتحويل النص إلى camelCase.

الخلاصة

لتحويل النص إلى camelCase هنا، الصق سطراً واقرأه مرة أخرى بالكلمات مقطّعة، والأولى صغيرة، والحرف الأول من كل لاحقة مرفوعاً، وكل شيء موصولاً بلا شيء بينه. والسطر المكتوب أصلاً بـ snake_case أو kebab-case يُقطّع عند فواصله. ولا تحافظ الصفحة على علامات الترقيم: فالفواصل والنقاط والشرطات حدود بين الكلمات، لا حروف تُنقل، وهذا ما تريده لاسم متغير ولا تريده لنثر. والقطع إلى كلمات يحتاج إلى حدود، ولذلك تعود الصينية واليابانية، المكتوبتان بلا فراغات، كلمة واحدة. ورفع الحرف الأول يتبع لغة الصفحة، فتصبح i التركية İ. ولا يُرفع شيء.