JavaScript:راهنمای استایل و استانداردهای کدنویسی در جاوااسکریپت
همیشه از یک استاندارد مشابه در تمامی پروژه‌های جاوااسکریپت خود استفاده کنید. [۱]
محتویات
- ۱ استانداردهای کدنویسی در جاوااسکریپت
- ۲ نام متغیرها
- ۳ فضای خالی بین عملگرها
- ۴ Indent یا فاصله اول خطوط در کدنویسی
- ۵ قوانین عبارت‌ها
- ۶ قوانین اشیاء
- ۷ طول هر خط ۸۰>
- ۸ قوانین نامگذاری
- ۹ بارگذاری جاوااسکریپت در HTML
- ۱۰ دسترسی به عناصر HTML
- ۱۱ فرمت فایل‌ها
- ۱۲ از نامگذاری فایل‌ها با حروف کوچک استفاده کنید
- ۱۳ کارایی
- ۱۴ منابع آموزشی
استانداردهای کدنویسی در جاوااسکریپت
استانداردهای کدنویسی شیوه‌های طراحی برای برنامه‌نویسی هستند. آنها به طور معمول شامل موارد زیر می‌شوند:
- نام گذاری و قوانین تعریف کردن متغیرهاو توابع.
- قوانین برای استفاده از فضای خالی، فاصله‌های اول خطوط (به انگلیسی: indentation) و نظرات (به انگلیسی: comments).
- تمرین‌ها و الگوهای برنامه‌نویسی.
استانداردهای کدنویسی موجب افزایش کیفیت می‌شود:
- موجب بهبود خوانایی کد می‌شود.
- فرایند بهبود دادن کدها را آسان‌تر می‌کند.
استانداردهای کدنویسی را می‌توان به صورت سندهایی برای اعضای تیم اجرا کرد که اعضای تیم از آنها تبعیّت کنند یا تمرین برنامه‌نویسی شما باشند.
 | این صفحه شیوه کدنویسی استانداردی که توسط Wikicod استفاده می‌شود را توضیح می‌دهد. شما می‌بایست فصل بعدی را تحت عنوان "Best Practices" یا بهترین تمرینات رابخوانید و بدانید که چگونه از مشکلات در کدنویسی جلوگیری کنید. |
نام متغیرها
در وب سایت wikicod، ما از روش کوهان شتری برای معرفی کننده (نام متغیرها و توابع) استفاده می‌کنیم.
تمامی نام‌ها با یک حرف شروع می‌شوند.
در پایین این صفحه شما مطالب گسترده‌تری را در مورد قوانین نامگذاری خواهید آموخت.
firstName = "John";
lastName = "Doe";
price = 19.90;
tax = 0.20;
fullPrice = price + (price * tax);
فضای خالی بین عملگرها
همیشه دور و اطراف عملگرها(= + - * /)، و بعد از ویرگول‌ها از فضای خالی استفاده کنید:
مثال
var x = y + z;
var values = ["Volvo", "Saab", "Fiat"];
Indent یا فاصله اول خطوط در کدنویسی
همیشه از ۲ فضای خالی SpaceSpace برای indent یا فاصله اول خطوط کد بلاک استفاده کنید:
توابع:
function toCelsius(fahrenheit) {
return (5 / 9) * (fahrenheit - 32);
}
 | از Tab ↹ یا tabulatorها برای indentها استفاده نکنید. ویرایشگرهای مختلف indentها را به صورت‌های مختلف نمایش می‌دهند. |
قوانین عبارت‌ها
قوانین اصلی برای عبارتهای برنامه‌نویسی ساده عبارتند از:
- همیشه یک عبارت ساده با نقطه ویرگول یا سمی کالن به پایان می‌رسد.
مثال
var values = ["Volvo", "Saab", "Fiat"];
var person = {
firstName: "John",
lastName: "Doe",
age: 50,
eyeColor: "blue"
};
قوانین اصلی برای عبارتهای پیچیده (ترکیبی) عبارتند از:
- بازکردن براکت در انتهای خط اول {.
- استفاده از یک Space قبل از بازکردن براکت
- بستن براکت } بدون استفاده از فضای خالی خاص.
- به پایان نبردن یک عبارت پیچیده با استفاده از ; یا سمیکالن
توابع:
function toCelsius(fahrenheit) {
return (5 / 9) * (fahrenheit - 32);
}
حلقه‌ها:
for (i = 0; i < 5; i++) {
x += i;
}
جملات شرطی:
if (time < 20) {
greeting = "Good day";
} else {
greeting = "Good evening";
}
قوانین اشیاء
قوانین اصلی برای تعریف اشیاء عبارتند از:
- باز کردن براکت { در خط مشترک با نام شیء.
- استفاده از فاصله Space بین هر ویژگی و مقدار آنها.
- استفاده از علامت کوتیشن ' برای مقدار رشته‌ای، نه برای مقادیر عددی.
- اضافه نکردن ویرگول بعد از آخرین جفت ویژگی–مقدار.
- قرار دادن براکت بسته } دریک خط جدید بدون استفاده از فضای خالی خاصی.
- همیشه به پایان بردن تعریف شی با نقطه ویرگول یا سمیکالن ;.
مثال
var person = {
firstName: "John",
lastName: "Doe",
age: 50,
eyeColor: "blue"
};
اشیاء کوتاه را می‌توان به صورت فشرده در یک خط با استفاده از فضای خالی فقط بین ویژگی‌ها نوشت، همانند مثال زیر:
var person = {firstName:"John", lastName:"Doe", age:50, eyeColor:"blue"};
طول هر خط ۸۰>
برای خوانایی بیشتر کدتان سعی کنید، از نوشتن بیش از ۸۰ کاراکتر در هر خط بپرهیزید.
اگر یک عبارت جاوااسکریپت در یک خط جا نگرفت، بهترین مکان برای ایجاد فاصله و رفتن به خط بعدی، بعد یک عملگر یا یک ویرگول است.
مثال
document.getElementById("demo").innerHTML =
"Hello Dolly.";
قوانین نامگذاری
همیشه از قوانین نامگذاری مشابهی در تمام کدهایتان استفاده کنید. برای مثال:
- نام متغیرها و توابع را به روش کوهان شتری بنویسید.
- متغیرهای کلی (به انگلیسی: global) را با حروف تمام بزرگ بنویسید. (ما این روش را استفاده نمی‌کنیم اما این روش در بین برنامه‌نویسان رواج دارد)
- ثابت‌ها (همانند PI) را نیز با حروف تمام بزرگ بنویسید.
آیا لازم است که شما از روش خط‌تیره –، کوهان شتری یا زیرخط _ در نام متغیرها استفاده کنید؟
این سؤالی است که معمولاً برنامه‌نویسان در مورد آن بحث می‌کنند. نتیجه این سؤال به شخصی که شما از آن این سؤال را می‌پرسید بستگی دارد:
خط تیره – در HTML و CSS:
ویژگی‌های (به انگلیسی: attributes) HTML5 می‌توانند با -data همانند (data-quantity و data-prrice) شروع شوند.
Css از خط تیره در نام – ویژگی استفاده می‌کند همانند (font-size).
| خط تیره می‌تواند – با علامت منها - اشتباه گرفته شود. خط تیره در نام‌ها در جاوااسکریپت قابل استفاده نیست. |
زیرخط _:
بسیاری از برنامه نویسان ترجیح می‌دهند از علامت زیر خط (همانند date_of_birth) به خصوص در دیتابیس SQL استفاده کنند.
Underscores are often used in PHP documentation.
علامت زیرخط _ معمولا در سند سازی‌های php نیز استفاده می‌شود.
روش نامگذاری پاسکال:
روش پاسکال معمولاً توسط برنامه نویسان زبان سی استفاده می‌شود.
روش کوهان شتری:
روش کوهان شتری توسط خود جاوااسکریپت، جی کوئری و سایر کتابخانه‌های جاوااسکریپت استفاده می‌شود.
| نام‌ها را با علامت $ شروع نکنید. این کار برای شما موجب بروز مشکل با بسیاری از کتابخانه‌های جاوااسکریپت می‌شود. |
بارگذاری جاوااسکریپت در HTML
از شیوه نوشتار (به انگلیسی: syntax) زیر برای بارگذاری اسکریپتهای خارجی (به انگلیسی: External) استفاده کنید. (ویژگی type ضروری نیست):
<script src="myscript.js"></script>
دسترسی به عناصر HTML
در نتیجه استفاده مرتب از سبک‌های (به انگلیسی: styles) HTML ، ممکن است منجر به خطاهای JavaScript شود.
این دو عبارت جاوااسکریپت موجب تولید دو نتیجه متفاوت می‌شود:
var obj = getElementById("Demo")
var obj = getElementById("demo")
در صورت امکان، از قوانین نامگذاری (همانند جاوااسکریپت) در HTML نیز استفاده کنید.
Visit the HTML Style Guide.
مشاهده راهنمای استایل‌ها در HTML.
فرمت فایل‌ها
فایل‌های HTML فرمت html. دارند (نه فرمت htm.)
فایل‌های CSS معمولاً فرمت css. دارند.
فایل‌های JavaScript، فرمت js. دارند.
از نامگذاری فایل‌ها با حروف کوچک استفاده کنید
بسیاری از وب سرورها (آپاچی، یونیکس) درمورد نام فایل‌ها حساس به حروف کوچک و بزرگ هستند:
فایل london با فایل London.jpg را نمی‌توان به یک روش مشابه دسترسی داشت.
سایر وب سرورها (ماکروسافت، IIS) حساس به حروف کوچک و بزرگ نیست.
به فایل london.jpg می‌توان همانند فایل‌های London.jpg یا london.jpg دسترسی داشت.
اگر شما حروف کوچک و بزرگ را با یکدیگر در نام فایل‌ها ترکیب کنید، شما می‌بایست نام فایل را به صورت دقیق بنویسید.
اگر شما از وب سرور غیرحساس به حروف کوچک و بزرگ، به یک سرور حساس به حروف کوچک و بزرگ انتقال پیدا کنید، حتی خطاهای کوچک می‌تواند موجب خرابی وب سایت شما شود.
برای جلوگیری از این مشکلات، همیشه از حروف کوچک (در صورت امکان) در نامگذاری آن استفاده کنید.
کارایی
قوانین کدنویسی توسط رایانه‌ها استفاده نمی‌شود. بیشتر قوانین تأثیر اندکی روی اجرای برنامه‌ها دارند.
فاصله از ابتدای خطوط و فواصل اضافی در اسکریپتهای کوچک مهم نیستند.
برای کد در حال توسعه، خوانا بودن کد باید رعایت باشد. اسکریپتهای بزرگ می‌بایست کوچکتر شوند.
منابع آموزشی