Spec-Zone.ru › HTML

Комментарии

HTML-комментарий используется для добавления поясняющих заметок к разметке или для предотвращения интерпретации браузером определённых частей документа.

Комментарии начинаются со строки <!-- и заканчиваются строкой -->, обычно с текстом между ними. Этот текст не может начинаться со строки > или ->, не может содержать строки --> или --!>, и не может заканчиваться строкой <!-, хотя <! разрешено.

Браузер игнорирует комментарии при рендеринге кода. Другими словами, они не видны на странице — только в коде. HTML-комментарии позволяют вам записывать полезные заметки о вашем коде или логике.

Это также верно для комментариев XML. Кроме того, в XML, таком как в SVG или MathML разметке, комментарий не может содержать последовательность символов --.

Комментарии могут занимать одну строку или несколько строк. Они могут использоваться в следующих местах:

  • Перед и после Doctype
  • Перед и после элемента <html>
  • В качестве содержимого большинства элементов, кроме: <script>, <style>, <title>, <textarea>, потому что эти элементы интерпретируют своё содержимое как обычный текст

Примечание: Хотя элементы <script> не должны содержать HTML-комментарии и вместо этого должны использовать комментарии JavaScript, существовала устаревшая практика заключать всё содержимое скрипта в HTML-комментарий, чтобы старые браузеры, не поддерживающие JavaScript, не рендерили его как текст. Сейчас это устаревшая функция JavaScript, и вам не следует полагаться на неё.

Синтаксис

html
<!-- Comment -->

Примеры

html
<!-- A one-line comment -->

<!--
A comment
that stretches
over several
lines
-->

<!-- The comment below disables
   the HTML contained within -->
<!--
<p>
   This content will not be rendered.
</p>
-->

Примечания

HTML-комментарии разрешены только в качестве содержимого. Вы не можете использовать их внутри тега, например, перед атрибутом HTML атрибута.

Как и в большинстве языков программирования, использующих синтаксис комментариев <!-- -->, комментарии нельзя вкладывать. Другими словами, первая встреча --> после <!-- закрывает комментарий.

Хотя комментарии начинаются с < и заканчиваются >, комментарий не является HTML-элементом.

Спецификации

Спецификация
Стандарт HTML
# комментарии

См. также

  • Комментарии в JavaScript
  • Комментарии в CSS
  • Comment API (Comment наследуется от Node)

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Comments

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API