Артём Мáлков

Комментарии в HTML-, CSS-, JS- и PHP-коде

21 авг2 комм

Эту статью я начну с того, для чего нужны комментарии. Предположим, что вы разрабатываете модуль со сложной структурой. Или делаете верстку с множеством вложений элементов. В таких случаях некоторые участки кода лучше всего как-то помечать – для этого и существуют комментарии.

Сейчас я подробно покажу четыре типа комментариев, точнее, все их виды для четырех разных кодов.

Комментарии в HTML-разметке

Для того чтобы добавить комментарий в HTML-разметку, используем:

<!-- Текст, код или прочее -->

Все, что стоит в этих тегах, не видно на экране, но доступно для просмотра в исходном коде.

Комментарии в CSS-стилях

Для того чтобы добавить комментарий в CSS-стили, используем:

/* Текст, код или прочее */ 

Все, что стоит в этих тегах, не учитывается при формировании стилей, но доступно для просмотра в самом файле стилей.

Комментарии в JavaScript-коде

Для добавления комментариев в JavaScript существуют два их типа.

Первый тип:

// Текст, код или прочее

Второй тип:

/* Текст, код или прочее */ 

Все, что стоит в этих тегах, не учитывается при выполнении скрипта, но доступно для просмотра в самом файле JavaScript.

Комментарии в PHP-коде

Этот язык программирования, в отличие от предыдущих, имеет 3 типа комментариев.

Первый тип:

// Текст, код или прочее 

Второй тип:

/* Текст, код или прочее */

И третий тип:

# Текст, код или прочее

Все, что стоит в этих тегах, не учитывается при выполнении скрипта и видно только в самом файле PHP.

Обратите внимание!

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

/* /* Мой код */ */ 

выведет вам ошибку.

2. Комментарии, которые пишутся через /* */ и <!-- -->, могут писаться в несколько строк:

/* 
Это 
Мой 
Код 
*/ 

В остальных же случаях для каждой строки нужно писать специальный символ комментария, например:

// Это 
// Мой 
// Код 

В противном случае вы также обнаружите ошибку.

Рекомендуем к просмотру
Добавляем виджет для комментариев от «ВКонтакте» на свой сайт
Социальные сети и мессенджеры
Минификация (сжатие) исходного кода (HTML) в WordPress на PHP
Посты
Удаляем все комментарии, ожидающие проверки, в три клика на DLE
Хаки
2
комментария
Форма комментирования этого поста скрыта. Авторизуйтесь, чтобы расширить привилегии гостевого посещения и получить необходимую помощь от сообщества Pandoge.
    • 2
    766
      •  Гости
    4 дек в 22:25

    Всем здравия. ПОКАЗАТЕЛИ В GOOGLE SPEED МОЕГО САЙТА 100/100

    Давно занялся тестированием. Какие только методы и приемы не применял, долгие пробы и ошибки и приятный результат в виде бонуса ;). Тематика сайта очень востребована: Как начать бизнес? И Профилактика и лечение заболеваний! Натуральный ЭКО продукт!

    Добро пожаловать на просмотр показателей! Если что обращайтесь, чем смогу помогу, только учтите, я всего лишь любитель с большим опытом! Всем респект!

    • 1
    766
      •  Гости
    23 авг в 19:46

    У меня эти комментарии и документации в коде PHP увеличивают некоторые файлы почти в 2 раза. Удаляю их, они мне не нужны. Когда что-то нужно будет изменить в коде, то комментарии можно прочитать с резервных копий. Их в сети полно.

Подняться наверх
«Pandoge» - помощник вебмастера