Комментарии в Less

Комментарии делают ваш код удобнее и понятнее, особенно если вы работаете в команде или периодически возвращаетесь к редактированию. К тому же число самих комментариев никак не оказывает влияние на объём конечного файла CSS, потому что комментарии при компиляции удаляются и видны только в исходном документе. Так что не бойтесь комментировать много и часто, это повышает читаемость.

Less поддерживает два типа комментариев: многострочные и однострочные.

Многострочные комментарии

Чтобы закомментировать блок кода поместите его между /* и */.

/* 
  style.less
  Версия 1.0
*/

Однострочные комментарии

Однострочные комментарии начинаются с // и всё, что идёт после этих символов Less игнорирует. Так что эта форма иногда применяется для быстрого отключения отдельных свойств.

@size: 200px; // Ширина и высота элемента

Вложенные комментарии

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

/* 
  // style.less
  // Версия 1.0
*/
// Используйте /* */ для комментирования

Однако одинаковый тип комментария внутри другого не допустим. Ниже показан пример, который приведёт к ошибке.

/* 
/* Так делать нельзя! */
*/

Специальные комментарии

Любые комментарии в итоговом CSS-файле удаляются, но иногда комментарий нужно оставить, например, информацию об авторских правах или важное пояснение. Для таких комментариев применяется специальная форма /*! !*/.

/*! Этот комментарий будет сохранён. !*/
/* А этот нет. */

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

Автор: Влад Мержевич
Последнее изменение: 19.02.2024