HTML5 Specification audio Part 48


Covers the dl element.


Have you ever wanted to read the HTML5 specification, but couldn't find the time? Well, I was in the same boat, but I decided to read it piecemeal and record myself so others could listen to it instead of reading it. Listening is convenient for tho commuter crowd because it turns an otherwise barren timespan, say, the morning metro ride to the swimming pool, to a more productive session. I don't recommend tuning out the world or being anti-social through these recordings. Specifically, I consider jogging in high-risk areas, such as metropolitan cities, or non-highway driving, or biking in the city to be incompatible with listening to a recording such as this; unless you are going to put the volume way down and listen to it as background noise for subconscience processing, which I believe may be not insignificant. However you decide to use these recordings, I hope you ejnoy them and not be put off by my lack of skill in recording audios. This is my first project of it's kind, that is human text to speech to manually convert text to audio. Though, I hope through your feedback that it can be the start of a longer trend. Thank you for visiting and I appreciate your spunk.






4.4.8 The dl element


Flow content.

If the element's children include at least one name-value group: Palpable content.

Contexts in which this element can be used:

Where flow content is expected.

Content model:

Zero or more groups each consisting of one or more dt elements followed by one or more dd elements, optionally intermixed with script-supporting elements.

Content attributes:

Global attributes

Tag omission in text/html:

Neither tag is omissible

Allowed ARIA role attribute values:

Any role value.

Allowed ARIA state and property attributes:

Global aria-* attributes

Any aria-* attributes applicable to the allowed roles.

DOM interface:

interface HTMLDListElement : HTMLElement {};

The dl element represents an association list consisting of zero or more name-value groups (a description list). A name-value group consists of one or more names (dt elements) followed by one or more values (dd elements), ignoring any nodes other than dt and dd elements. Within a single dl element, there should not be more than one dt element for each name.

Name-value groups may be terms and definitions, metadata topics and values, questions and answers, or any other groups of name-value data.

The values within a group are alternatives; multiple paragraphs forming part of the same value must all be given within the same dd element.

The order of the list of groups, and of the names and values within each group, may be significant.

In the following example, one entry ("Authors") is linked to two values ("John" and "Luke").

<dt> Authors
<dd> John
<dd> Luke
<dt> Editor
<dd> Frank

In the following example, one definition is linked to two terms.

<dt lang="en-US"> <dfn>color</dfn> </dt>
<dt lang="en-GB"> <dfn>colour</dfn> </dt>
<dd> A sensation which (in humans) derives from the ability of
the fine structure of the eye to distinguish three differently
filtered analyses of a view. </dd>

The following example illustrates the use of the dl element to mark up metadata of sorts. At the end of the example, one group has two metadata labels ("Authors" and "Editors") and two values ("Robert Rothman" and "Daniel Jackson").

<dt> Last modified time </dt>
<dd> 2004-12-23T23:33Z </dd>
<dt> Recommended update interval </dt>
<dd> 60s </dd>
<dt> Authors </dt>
<dt> Editors </dt>
<dd> Robert Rothman </dd>
<dd> Daniel Jackson </dd>

The following example shows the dl element used to give a set of instructions. The order of the instructions here is important (in the other examples, the order of the blocks was not important).

<p>Determine the victory points as follows (use the
first matching case):</p>
<dt> If you have exactly five gold coins </dt>
<dd> You get five victory points </dd>
<dt> If you have one or more gold coins, and you have one or more silver coins </dt>
<dd> You get two victory points </dd>
<dt> If you have one or more silver coins </dt>
<dd> You get one victory point </dd>
<dt> Otherwise </dt>
<dd> You get no victory points </dd>

The following snippet shows a dl element being used as a glossary. Note the use of dfn to indicate the word being defined.

<dt><dfn>Apartment</dfn>, n.</dt>
<dd>An execution context grouping one or more threads with one or
more COM objects.</dd>
<dt><dfn>Flat</dfn>, n.</dt>
<dd>A deflated tire.</dd>
<dt><dfn>Home</dfn>, n.</dt>
<dd>The user's login directory.</dd>

The dl element is inappropriate for marking up dialogue. Examples of how to mark up dialogue are shown below.


More Blog Entries

HTML5 Specification audio Part 47

  Be a listener of Part 47, sections 4.4.7 of the HTML5 spec Summary: ...

Liferay 7 GA1 Doxygen

Doxygen Output for Liferay 7 CE GA1 Visualize Liferay Classes, Methods; with the help of UML...