اشتباهات رایج در نامگذاری

اشتباهات رایج در نامگذاری کلاس‌ها و شناسه‌ها در HTML

نامگذاری صحیح کلاس‌ها و شناسه‌ها (IDs) در HTML یکی از مهارت‌های اساسی برای توسعه‌دهندگان وب است. با این حال، بسیاری از برنامه‌نویسان، به‌ویژه تازه‌کارها، مرتکب اشتباهاتی می‌شوند که می‌تواند مشکلاتی در نگهداری کد، سازگاری و سئو ایجاد کند.

۱. استفاده از کاراکترهای غیرمجاز

برخی از نمادها و کاراکترها در نام کلاس‌ها و شناسه‌ها مجاز نیستند. برای مثال:

  • استفاده از فاصله (space) به جای خط تیره یا زیرخط
  • به کار بردن کاراکترهای خاص مانند !@#$%^&*()
  • شروع نام با عدد (اگرچه در CSS مجاز است، اما در برخی جاوااسکریپت‌ها مشکل ایجاد می‌کند)
نام اشتباه نام صحیح
header 1 header-1 یا header_1
1section section-1

۲. نام‌های غیرتوصیفی

استفاده از نام‌های کلی مانند box1، div2 یا right باعث می‌شود:

  1. درک هدف المان برای دیگر توسعه‌دهندگان سخت شود
  2. نگهداری کد در پروژه‌های بزرگ دشوار گردد
  3. تغییرات آینده زمان‌بر شود
برای یادگیری اصول صحیح نامگذاری، می‌توانید مشاهده کنید.

۳. ترکیب نام‌گذاری انگلیسی و فارسی

در پروژه‌های فارسی‌زبان، گاهی ترکیب ناهمگونی از واژه‌های انگلیسی و فارسی دیده می‌شود:

مثال اشتباه: class="nav-اصلی" یا id="منو-main"

مثال صحیح: class="main-nav" یا id="primary-menu"


۴. استفاده نادرست از حروف بزرگ

اگرچه HTML به حروف بزرگ و کوچک حساس نیست، اما رعایت یک الگوی ثابت مهم است:

  • استایل camelCase: mainHeader
  • استایل kebab-case: main-header
  • استایل snake_case: main_header

مهم این است که در کل پروژه از یک روش ثابت استفاده شود. تغییر مداوم بین این روش‌ها باعث بی‌نظمی کد می‌شود.

۵. نام‌های خیلی طولانی یا خیلی کوتاه

تعادل در طول نام‌ها اهمیت زیادی دارد:

اشتباه توضیح پیشنهاد
btn خیلی کلی submit-btn
user-profile-card-container-wrapper خیلی طولانی profile-card

با رعایت این اصول ساده اما حیاتی، می‌توانید کدهای تمیزتر، قابل‌نگهداری‌تر و حرفه‌ای‌تری تولید کنید. برای جزئیات بیشتر درباره تفاوت class و id در HTML، پیشنهاد می‌کنیم مشاهده کنید.