٪۴۰ تخفیف تابستانه شروع شد! بزرگترین حراج سال ما

به ما بپیوندید

آموزش سبک جاوا اسکریپت

همیشه برای همه پروژه های JavaScript خود از قراردادهای کدگذاری یکسان استفاده کنید. کنوانسیون های کدگذاری جاوا اسکریپت قراردادهای برنامه نویسی ، دستورالعمل های سبک برنامه نویسی هستند . آنها به طور معمول پوشش می دهند: قوانین نامگذاری و اعلام برای متغیرها و…

محمد یوسفی

23 جولای 2021

همیشه برای همه پروژه های JavaScript خود از قراردادهای کدگذاری یکسان استفاده کنید.


کنوانسیون های کدگذاری جاوا اسکریپت

قراردادهای برنامه نویسی ، دستورالعمل های سبک برنامه نویسی هستند . آنها به طور معمول پوشش می دهند:

  • قوانین نامگذاری و اعلام برای متغیرها و توابع.
  • قوانینی برای استفاده از فضای سفید ، تورفتگی و نظرات.
  • شیوه ها و اصول برنامه نویسی

قراردادهای برنامه نویسی کیفیت مطمئن را دارند :

  • خوانایی کد را بهبود می بخشد
  • تعمیر و نگهداری کد را آسان تر کنید

قراردادهای برنامه نویسی می توانند قوانینی مستند برای تیم ها باشند که از آنها پیروی می کنند ، یا فقط عمل کدگذاری فردی شما هستند.

در این صفحه قراردادهای عمومی کد JavaScript که توسط W3S Schools استفاده می شود ، توصیف می شود.
همچنین باید فصل بعدی “بهترین روشها” را بخوانید ، و یاد بگیرید که چگونه از مشکلات کدگذاری جلوگیری کنید.


نامهای متغیر

در W3schools ما از camelCase برای شناسایی نام (متغیرها و توابع) استفاده می کنیم.

همه نام ها با یک حرف شروع می شوند .

در پایین این صفحه ، بحث گسترده تری درباره قوانین نامگذاری پیدا خواهید کرد.

firstName = "John";
lastName = "Doe";

price = 19.90;
tax = 0.20;

fullPrice = price + (price * tax);

فضاهای اطراف اپراتورها

همیشه فضاهای اطراف اپراتورها (= + – * /) و بعد از ویرگول قرار دهید:

مثال ها:

let x = y + z;
const myArray = ["Volvo", "Saab", "Fiat"];


تورفتگی کد

همیشه از 2 فاصله برای تورفتگی بلوک های کد استفاده کنید:

کارکرد

function toCelsius(fahrenheit) {
  return (5 / 9) * (fahrenheit - 32);
}

برای ایجاد تورفتگی از زبانه ها (جدول بندی ها) استفاده نکنید. ویراستاران مختلف برگه ها را متفاوت تفسیر می کنند.


قوانین بیانیه

قوانین کلی برای عبارات ساده:

  • همیشه یک جمله ساده را با یک نقطه ویرگول خاتمه دهید.

مثال ها:

const cars = ["Volvo", "Saab", "Fiat"];

const person = {
  firstName: "John",
  lastName: "Doe",
  age: 50,
  eyeColor: "blue"
};

قوانین کلی برای عبارات پیچیده (مرکب):

  • براکت باز را در انتهای خط اول قرار دهید.
  • قبل از براکت باز از یک فاصله استفاده کنید.
  • بدون در نظر گرفتن فضاهای جلو ، براکت بسته را روی یک خط جدید قرار دهید.
  • یک جمله پیچیده را با نقطه ویرگول پایان ندهید.

کارکرد:

function toCelsius(fahrenheit) {
  return (5 / 9) * (fahrenheit - 32);
}

حلقه ها:

for (let i = 0; i < 5; i++) {
  x += i;
}

شرطی:

if (time < 20) {
  greeting = "Good day";
} else {
  greeting = "Good evening";
}

قوانین شی

قوانین کلی برای تعاریف شی:

  • براکت باز را در همان خط نام شی قرار دهید.
  • بین هر خاصیت و مقدار آن از دو نقطه به اضافه یک فاصله استفاده کنید.
  • از نقل قول ها در اطراف مقادیر رشته استفاده کنید ، نه در مورد مقادیر عددی.
  • بعد از آخرین جفت-مقدار خاصیت ویرگول اضافه نکنید.
  • بدون در نظر گرفتن فضاهای جلو ، براکت بسته را روی یک خط جدید قرار دهید.
  • همیشه تعریف شی object را با نقطه ویرگول خاتمه دهید.

مثال

const person = {
  firstName: "John",
  lastName: "Doe",
  age: 50,
  eyeColor: "blue"
};

اشیا Short کوتاه را می توان به صورت فشرده ، روی یک خط ، فقط با استفاده از فاصله بین ویژگی ها نوشت ، مانند این:

const person = {firstName:"John", lastName:"Doe", age:50, eyeColor:"blue"};

طول خط <80

برای خوانایی ، از خطوط طولانی تر از 80 نویسه خودداری کنید.

اگر یک عبارت JavaScript در یک خط قرار ندارد ، بهترین مکان برای شکستن آن ، بعد از یک عملگر یا یک ویرگول است.

مثال

document.getElementById("demo").innerHTML =
"Hello Dolly.";

نامگذاری کنوانسیون ها

همیشه برای همه کدهای خود از نامگذاری یکسان استفاده کنید. مثلا:

  • نام متغیر و عملکرد به عنوان camelCase نوشته شده است
  • متغیرهای سراسری نوشته شده در حروف بزرگ (ما نیست، اما آن را کاملا مشترک)
  • ثابت ها (مانند PI) با بزرگنمایی

آیا باید از نام های متغیر از hyp-hens ، camelCase یا under_scores استفاده کنید؟

این سوالی است که برنامه نویسان اغلب در مورد آن بحث می کنند. پاسخ بستگی به این دارد که از چه کسی بپرسید:

خط فاصله در HTML و CSS:

ویژگی های HTML5 می توانند با داده- (کمیت داده ، قیمت داده) شروع شوند.

CSS از خط فاصله در نام خاصیت (اندازه قلم) استفاده می کند.

خط فاصله را می توان به عنوان تلاش برای تفریق اشتباه گرفت. خط تیره در نام های جاوا اسکریپت مجاز نیست.

زیرمجموعه ها:

بسیاری از برنامه نویسان ترجیح می دهند از زیرخط (تاریخ_ تولد) به ویژه در پایگاه های داده SQL استفاده کنند.

Underscores اغلب در اسناد PHP استفاده می شود.

PascalCase:

PascalCase اغلب توسط برنامه نویسان C ترجیح داده می شود.

مورد شتر:

camelCase توسط خود JavaScript ، توسط jQuery و سایر کتابخانه های JavaScript استفاده می شود.

نامها را با علامت $ شروع نکنید. این امر شما را در تضاد با بسیاری از نام های کتابخانه JavaScript قرار می دهد.


JavaScript در HTML بارگیری می شود

برای بارگذاری اسکریپت های خارجی از نحو ساده استفاده کنید (ویژگی type ضروری نیست):

<script src="myscript.js"></script>

دسترسی به عناصر HTML

نتیجه استفاده از سبکهای “نامرتب” HTML ممکن است منجر به خطاهای JavaScript شود.

این دو عبارت JavaScript نتایج متفاوتی را ایجاد می کنند:

const obj = getElementById("Demo")

const obj = getElementById("demo")

در صورت امکان ، از همان قرارداد نامگذاری (به عنوان JavaScript) در HTML استفاده کنید.


پسوندهای پرونده

پرونده های HTML باید پسوند html داشته باشند ( .htm مجاز است).

پرونده های CSS باید پسوند css داشته باشند .

پرونده های جاوا اسکریپت باید پسوند .js داشته باشند .


از نام پرونده های کوچک استفاده کنید

بیشتر سرورهای وب (Apache ، Unix) در مورد نام پرونده ها به حروف کوچک و بزرگ حساس هستند:

london.jpg به عنوان London.jpg قابل دسترسی نیست.

وب سرورهای دیگر (Microsoft ، IIS) به حروف کوچک و بزرگ حساس نیستند:

london.jpg به عنوان London.jpg یا london.jpg قابل دسترسی است.

اگر از ترکیبی از حروف بزرگ و کوچک استفاده می کنید ، باید بسیار سازگار باشید.

اگر از یک مورد کوچک به یک سرور حساس به حروف کوچک و بزرگ بروید ، حتی خطاهای کوچک می توانند وب سایت شما را خراب کنند.

برای جلوگیری از این مشکلات ، همیشه از نام پرونده های کوچک (در صورت امکان) استفاده کنید.


کارایی

قراردادهای رمزگذاری توسط رایانه ها استفاده نمی شود. اکثر قوانین تأثیر کمی در اجرای برنامه ها دارند.

تورفتگی و فضاهای اضافی در متن های کوچک قابل توجه نیستند.

برای کد در حال توسعه ، خوانایی باید ترجیح داده شود. اسکریپت های تولید بزرگتر باید کوچک شوند.

منبع

مطالب مرتبط

0 0 رای ها
امتیازدهی به مقاله
اشتراک در
اطلاع از
guest
0 نظرات
بازخورد (Feedback) های اینلاین
مشاهده همه دیدگاه ها