Комментарии
HTML-комментарий используется для добавления поясняющих заметок к разметке или для предотвращения интерпретации браузером определённых частей документа.
Комментарии начинаются со строки <!-- и заканчиваются строкой -->, обычно с текстом между ними. Этот текст не может начинаться со строки > или ->, не может содержать строки --> или --!>, и не может заканчиваться строкой <!-, хотя <! разрешено.
Браузер игнорирует комментарии при рендеринге кода. Другими словами, они не видны на странице — только в коде. HTML-комментарии позволяют вам записывать полезные заметки о вашем коде или логике.
Это также верно для комментариев XML. Кроме того, в XML, таком как в SVG или MathML разметке, комментарий не может содержать последовательность символов --.
Комментарии могут занимать одну строку или несколько строк. Они могут использоваться в следующих местах:
- Перед и после Doctype
- Перед и после элемента
<html> - В качестве содержимого большинства элементов, кроме:
<script>,<style>,<title>,<textarea>, потому что эти элементы интерпретируют своё содержимое как обычный текст
Примечание: Хотя элементы <script> не должны содержать HTML-комментарии и вместо этого должны использовать комментарии JavaScript, существовала устаревшая практика заключать всё содержимое скрипта в HTML-комментарий, чтобы старые браузеры, не поддерживающие JavaScript, не рендерили его как текст. Сейчас это устаревшая функция JavaScript, и вам не следует полагаться на неё.
Синтаксис
<!-- Comment -->
Примеры
<!-- 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
-
CommentAPI (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