В HTML5: пример квалифицируется как?

Question

Как правильно указать что-то вроде примера с приведенным списком определений?

В следующем примере (хах) я использую

<aside><h4>Example:</h4><code>

, чтобы указать, чтоВыделенный курсивом текст является примером, это самый синтаксически точный способ сделать это?

(Кроме того, я знаю, что должен использовать тег dl, но это еще один шаг)

<ul>
    <li>
        <h3>Recipients</h3>
        <p>Comma-delimited list of the roles that will receive notification emails</p>
        <aside><h4>Example:</h4><code>bz,zba,admin,readonly,dept_zoning</code></aside>
    </li>
    <li>
        <h3>Trigger</h3>
        <code>Can be null</code>
        <p>Relative-pathed Url that initiates the notification action with bracketed parameters</p>
        <aside><h4>Example:</h4><code>/permits/SetApproval/{id}?approved={approvalstate}</code></aside>
    </li>
    <li>
        <h3>Message</h3>
        <p>The message that recipients will receive upon notification action.  Bracketed dynamic parameters will exist as specified in the trigger condition</p>
        <aside><h4>Example:</h4><code>This notification has been sent to inform you that Case Number: {id} has been {approvalstate}</code></aside>
    </li>
</ul>

Answer 1

Строго, нет, хотя это не будет худшим использованием <aside>.

В спецификации говорится об элементе <aside>:

Элемент asideпредставляет раздел страницы, который состоит из контента, который тангенциально связан с контентом вокруг элемента aside, и который может рассматриваться как отдельный от этого контента.

Ключевые слова "тангенциально связаны" и«считается отдельным», ни один из которых не подходит для примеров определения, которое предшествует этому в документе.

Я бы предположил, что элемент <figure> будет наиболее подходящим.

Элемент figure представляет некоторое содержимое потока, необязательно с заголовком, которое является автономным и на которое обычно ссылаются как на единое целое из основного потока документа.

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

Answer 2

Я думаю, это было бы приемлемо. spec гласит:

Элемент aside представляет собой раздел страницы, состоящий из контента, который тангенциально связан с контентом вокруг элемента aside и который можно рассматривать как отдельныйиз этого контента.Такие разделы часто представлены как боковые панели в печатной типографии.

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

Другими словами, оно используется для вторичного содержимого, которое имеет отношение к контексту, в котором оно находится, но может быть удалено из потока, не нарушая контекст.Если он используется в статье, он может быть «бонусной информацией», связанной с этой статьей, и если он используется снаружи, он представляет контент, который не имеет решающего значения для остальной части самого контента.

HTML5doctor также отличная статья в стороне.

РЕДАКТИРОВАТЬ: При этом я лично не большой поклонник просто собирать много тегов вокруг вещи, когда это строго не нужнобыть в своем собственном контейнере.Для целого блока контента, который должен быть стилизован по-другому, тогда да, но если это может быть отдельный заголовок или что-то похожее, что может стоять в одиночку, то я бы оставил это так.