ProgrammerBook.ru: Обратите внимание, что

  1. данный документ является переводом документа «Admonishments»;
  2. данный документ может содержать неточности, опечатки и ошибки перевода;
  3. официальным документом по данной тематике является оригинальный документ на английском языке, расположенный на сайте W3C.

Замечания

Допустимый Контекст: %body.content, %flow, %block
Модель Содержимого: %body.content

Элемент NOTE предназначен для указания замечаний, таких как примечания, предостережения или предупреждения, как это обычно используется в технической документации. Атрибут CLASS определяет тип элемента и, как правило, добавляет различную графику, такую как предупреждающий знак правил дорожного движения. Изображение может быть указано с помощью атрибута SRC.

Например:

    <NOTE CLASS=WARNING>Пожалуйста, свяжитесь с местной
    метеослужбой, перед началом своего восхождения. Горная
    погода подвержена быстрому изменению. Крайне важно
    иметь при себе хорошую карту и компас.</NOTE>

В качестве имён классов для стандартных замечаний рекомендуется использовать следующие имена: NOTE, CAUTION и WARNING. При отсутствии атрибута CLASS, элемент NOTE, как правило, представляется с отступом, без сопутствующей графики.

Допустимые Атрибуты

ID
SGML-идентификатор используется в качестве цели для гипертекстовых ссылок или для именования отдельных элементов в присоединённых таблицах стилей. Идентификаторы NAME лексем должны быть уникальными в рамках текущего документа.
LANG
Это одна из кратких меток ISO стандарта языка, например «en.uk» для варианта английского языка используемого в Соединённом Королевстве. Он может быть использован обработчиками при выборе конкретного языкового варианта кавычек, лигатур, правил переноса и так далее. Атрибут языка состоит из двухбуквенного кода языка, соответствующего стандарту ISO 639, в случае необходимости, за которым следует точка и двухбуквенный код страны, соответствующий стандарту ISO 3166.
CLASS
Это разделённый пробелами список SGML NAME лексем, которые используются для именования подклассов тега. По соглашению, имена классов интерпретируются иерархически, с самого общего класса слева до наиболее специфичного справа, где классы разделены точкой. Атрибут CLASS чаще всего используется для прикрепления другого стиля к некоторому элементу, но это является рекомендацией, чтобы практические имена классов были выбраны на основе семантики элемента, так как это позволит использование для других целей, таких как ограничение поиска по документам путём сопоставления имён классов элемента. Кроме значений предложенных выше, соглашения по выбору имён классов выходят за рамки данной спецификации.
CLEAR
Этот атрибут является общим для всех блочных элементов. Когда текст обтекает рисунок или таблицу вокруг поля, вы иногда хотите начать примечание под рисунком, а не рядом с ним. Атрибут CLEAR позволяет перемещаться вниз без всяких условий:

clear=left
запрещает обтекание слева
clear=right
запрещает обтекание справа
clear=all
запрещает обтекание как слева, так и справа

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

clear="40 en"
запрещает обтекание до тех пор пока смежное горизонтальное пространство не станет более 40 en
clear="100 pixels"
запрещает обтекание до тех пор пока смежное горизонтальное пространство не станет более 100 пикселей

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

SRC
Определяет изображение, которое отображается перед примечанием. Изображение представляется в виде URI. Этот атрибут может появляться вместе с атрибутом MD.
MD
Определяет сообщение дайджеста или криптографическую контрольную сумму для соответствующей графики, определённой в атрибуте SRC. Он используется, когда вы хотите быть уверены в том, что прикреплённый объект действительно является тем самым, который был задуман автором, и не был изменён каким-либо образом. Например, MD="md5:jV2OfH+nnXHU8bnkPAad/mSQlTDZ", определяет контрольную сумму MD5, закодированную в виде base64 строки символов. Атрибут MD, как правило, допускается для всех элементов, которые поддерживают ссылки с использованием URI.