Сборка от 17 марта 2017 г

Правила именования

• Правило 1.

Никакого транслита. Только английский.

Неприемлемы:

var moiTovari; var cena;

var ssilka;

Подойдут:

var myGoods; var price; var link;

Чем плох транслит?

Во‑первых, среди разработчиков всего мира принято использовать английский язык для имён переменных. И если ваш код потом попадёт к кому‑то другому, например вы будете в команде больше чем из одного человека, то велик шанс, что транслит ему не понравится.

Во‑вторых, русский транслит хуже читается и длиннее, чем названия на английском.

В‑третьих, в проектах вы наверняка будете применять библиотеки, написанные другими людьми. Многое уже готово, в распоряжении современного разработчика есть масса инструментов, все они используют названия переменных и функций на английском языке, и вы, конечно, будете их использовать. А от кода, где транслит перемешан с английским – волосы могут встать дыбом, и не только на голове.

Если вы вдруг не знаете английский – самое время выучить.

• Правило 2.

Использовать короткие имена только для переменных «местного значения».

Называть переменные именами, не несущими смысловой нагрузки, например a , e , p , mg – можно только в том случае, если они используются в небольшом фрагменте кода и их применение очевидно.

Вообще же, название переменной должно быть понятным. Иногда для этого нужно использовать несколько слов.

• Правило 3.

Переменные из нескольких слов пишутся вместеВотТак .

Например:

var borderLeftWidth;

Этот способ записи называется «верблюжьей нотацией» или, по‑английски, «camelCase». Существует альтернативный стандарт, когда несколько слов пишутся через знак подчеркивания '_' :

var border_left_width;

Преимущественно в JavaScript используется вариант borderLeftWidth , в частности во встроенных языковых и браузерных функциях. Поэтому целесообразно остановиться на нём.
Ещё одна причина выбрать «верблюжью нотацию» – запись в ней немного короче, чем с подчеркиванием, т.к. не нужно вставлять '_' .

• Правило последнее, главное.