[html5] r8326 - [a] (2) Elaborate on <strong>'s semantics, add new examples. Affected topics: HTML
whatwg at whatwg.org
whatwg at whatwg.org
Mon Dec 2 17:22:19 PST 2013
Author: ianh
Date: 2013-12-02 17:22:17 -0800 (Mon, 02 Dec 2013)
New Revision: 8326
Modified:
complete.html
index
source
Log:
[a] (2) Elaborate on <strong>'s semantics, add new examples.
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2013-12-03 00:25:27 UTC (rev 8325)
+++ complete.html 2013-12-03 01:22:17 UTC (rev 8326)
@@ -17712,8 +17712,24 @@
<dd><a href=#global-attributes>Global attributes</a></dd>
<dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
- </dl><!--TOPIC:HTML--><p>The <code><a href=#the-strong-element>strong</a></code> element <a href=#represents>represents</a> strong importance for its contents.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-strong-element>strong</a></code> element <a href=#represents>represents</a> strong importance, seriousness, or
+ urgency for its contents.</p>
+ <p><strong>Importance</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used in a heading, caption,
+ or paragraph to distinguish the part that really matters from other parts of the that might be
+ more detailed, more jovial, or merely boilerplate. (This is distinct from marking up subheadings,
+ for which the <code><a href=#the-hgroup-element>hgroup</a></code> element is appropriate.)</p>
+
+ <p class=example>For example, the first word of the previous paragraph is marked up with
+ <code><a href=#the-strong-element>strong</a></code> to distinguish it from the more detailed text in the rest of the
+ paragraph.</p>
+
+ <p><strong>Seriousness</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used to mark up a warning
+ or caution notice.</p>
+
+ <p><strong>Urgency</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used to denote contents that
+ the user needs to see sooner than other parts of the document.</p>
+
<p>The relative level of importance of a piece of content is given by its number of ancestor
<code><a href=#the-strong-element>strong</a></code> elements; each <code><a href=#the-strong-element>strong</a></code> element increases the importance of its
contents.</p>
@@ -17722,6 +17738,28 @@
the meaning of the sentence.</p>
<div class=example>
+
+ <p>Here, the word "chapter" and the actual chapter number are mere boilerplate, and the actual
+ name of the chapter is marked up with <code><a href=#the-strong-element>strong</a></code>:</p>
+
+ <pre><h1>Chapter 1: <strong>The Praxis</strong></h1></pre>
+
+ <p>In the following example, the name of the diagram in the caption is marked up with
+ <code><a href=#the-strong-element>strong</a></code>, to distinguish it from boilerplate text (before) and the description
+ (after):</p>
+
+ <pre><figcaption>Figure 1. <strong>Ant colony dynamics</strong>. The ants in this colony are
+affected by the heat source (upper left) and the food source (lower right).</figcaption></pre>
+
+ <p>In this example, the heading is really "Flowers, Bees, and Honey", but the author has added a
+ light-hearted addition to the heading. The <code><a href=#the-strong-element>strong</a></code> element is thus used to mark up
+ the first part to distinguish it from the latter part.</p>
+
+ <pre><h1><strong>Flowers, Bees, and Honey</strong> and other things I don't understand</h1></pre>
+
+ </div>
+
+ <div class=example>
<p>Here is an example of a warning notice in a game, with the
various parts marked up according to how important they are:</p>
<!-- DO NOT REFLOW THIS EXAMPLE it has been carefully balanced -->
@@ -17732,7 +17770,22 @@
ten meters.</strong></strong> You have been warned.</p></pre>
</div>
+ <div class=example>
+ <p>In this example, the <code><a href=#the-strong-element>strong</a></code> element is used to denote the part of the text that
+ the user is intended to read first.</p>
+
+ <pre><p>Welcome to Remy, the reminder system.</p>
+<p>Your tasks for today:</p>
+<ul>
+ <li><p><strong>Turn off the oven.</strong></p></li>
+ <li><p>Put out the trash.</p></li>
+ <li><p>Do the laundry.</p></li>
+</ul></pre>
+
+ </div>
+
+
<h4 id=the-small-element><span class=secno>4.5.4 </span>The <dfn><code>small</code></dfn> element</h4>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
@@ -102054,6 +102107,7 @@
Michael Powers,
Michael Rakowski,
Michael(tm) Smith,
+ Michael Walmsley,
Michal Zalewski,
Michel Fortin,
Michelangelo De Simone,
Modified: index
===================================================================
--- index 2013-12-03 00:25:27 UTC (rev 8325)
+++ index 2013-12-03 01:22:17 UTC (rev 8326)
@@ -17712,8 +17712,24 @@
<dd><a href=#global-attributes>Global attributes</a></dd>
<dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
- </dl><!--TOPIC:HTML--><p>The <code><a href=#the-strong-element>strong</a></code> element <a href=#represents>represents</a> strong importance for its contents.</p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-strong-element>strong</a></code> element <a href=#represents>represents</a> strong importance, seriousness, or
+ urgency for its contents.</p>
+ <p><strong>Importance</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used in a heading, caption,
+ or paragraph to distinguish the part that really matters from other parts of the that might be
+ more detailed, more jovial, or merely boilerplate. (This is distinct from marking up subheadings,
+ for which the <code><a href=#the-hgroup-element>hgroup</a></code> element is appropriate.)</p>
+
+ <p class=example>For example, the first word of the previous paragraph is marked up with
+ <code><a href=#the-strong-element>strong</a></code> to distinguish it from the more detailed text in the rest of the
+ paragraph.</p>
+
+ <p><strong>Seriousness</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used to mark up a warning
+ or caution notice.</p>
+
+ <p><strong>Urgency</strong>: The <code><a href=#the-strong-element>strong</a></code> element can be used to denote contents that
+ the user needs to see sooner than other parts of the document.</p>
+
<p>The relative level of importance of a piece of content is given by its number of ancestor
<code><a href=#the-strong-element>strong</a></code> elements; each <code><a href=#the-strong-element>strong</a></code> element increases the importance of its
contents.</p>
@@ -17722,6 +17738,28 @@
the meaning of the sentence.</p>
<div class=example>
+
+ <p>Here, the word "chapter" and the actual chapter number are mere boilerplate, and the actual
+ name of the chapter is marked up with <code><a href=#the-strong-element>strong</a></code>:</p>
+
+ <pre><h1>Chapter 1: <strong>The Praxis</strong></h1></pre>
+
+ <p>In the following example, the name of the diagram in the caption is marked up with
+ <code><a href=#the-strong-element>strong</a></code>, to distinguish it from boilerplate text (before) and the description
+ (after):</p>
+
+ <pre><figcaption>Figure 1. <strong>Ant colony dynamics</strong>. The ants in this colony are
+affected by the heat source (upper left) and the food source (lower right).</figcaption></pre>
+
+ <p>In this example, the heading is really "Flowers, Bees, and Honey", but the author has added a
+ light-hearted addition to the heading. The <code><a href=#the-strong-element>strong</a></code> element is thus used to mark up
+ the first part to distinguish it from the latter part.</p>
+
+ <pre><h1><strong>Flowers, Bees, and Honey</strong> and other things I don't understand</h1></pre>
+
+ </div>
+
+ <div class=example>
<p>Here is an example of a warning notice in a game, with the
various parts marked up according to how important they are:</p>
<!-- DO NOT REFLOW THIS EXAMPLE it has been carefully balanced -->
@@ -17732,7 +17770,22 @@
ten meters.</strong></strong> You have been warned.</p></pre>
</div>
+ <div class=example>
+ <p>In this example, the <code><a href=#the-strong-element>strong</a></code> element is used to denote the part of the text that
+ the user is intended to read first.</p>
+
+ <pre><p>Welcome to Remy, the reminder system.</p>
+<p>Your tasks for today:</p>
+<ul>
+ <li><p><strong>Turn off the oven.</strong></p></li>
+ <li><p>Put out the trash.</p></li>
+ <li><p>Do the laundry.</p></li>
+</ul></pre>
+
+ </div>
+
+
<h4 id=the-small-element><span class=secno>4.5.4 </span>The <dfn><code>small</code></dfn> element</h4>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
@@ -102054,6 +102107,7 @@
Michael Powers,
Michael Rakowski,
Michael(tm) Smith,
+ Michael Walmsley,
Michal Zalewski,
Michel Fortin,
Michelangelo De Simone,
Modified: source
===================================================================
--- source 2013-12-03 00:25:27 UTC (rev 8325)
+++ source 2013-12-03 01:22:17 UTC (rev 8326)
@@ -18459,8 +18459,24 @@
<dd>Uses <code>HTMLElement</code>.</dd>
</dl><!--TOPIC:HTML-->
- <p>The <code>strong</code> element <span>represents</span> strong importance for its contents.</p>
+ <p>The <code>strong</code> element <span>represents</span> strong importance, seriousness, or
+ urgency for its contents.</p>
+ <p><strong>Importance</strong>: The <code>strong</code> element can be used in a heading, caption,
+ or paragraph to distinguish the part that really matters from other parts of the that might be
+ more detailed, more jovial, or merely boilerplate. (This is distinct from marking up subheadings,
+ for which the <code>hgroup</code> element is appropriate.)</p>
+
+ <p class="example">For example, the first word of the previous paragraph is marked up with
+ <code>strong</code> to distinguish it from the more detailed text in the rest of the
+ paragraph.</p>
+
+ <p><strong>Seriousness</strong>: The <code>strong</code> element can be used to mark up a warning
+ or caution notice.</p>
+
+ <p><strong>Urgency</strong>: The <code>strong</code> element can be used to denote contents that
+ the user needs to see sooner than other parts of the document.</p>
+
<p>The relative level of importance of a piece of content is given by its number of ancestor
<code>strong</code> elements; each <code>strong</code> element increases the importance of its
contents.</p>
@@ -18469,6 +18485,28 @@
the meaning of the sentence.</p>
<div class="example">
+
+ <p>Here, the word "chapter" and the actual chapter number are mere boilerplate, and the actual
+ name of the chapter is marked up with <code>strong</code>:</p>
+
+ <pre><h1>Chapter 1: <strong>The Praxis</strong></h1></pre>
+
+ <p>In the following example, the name of the diagram in the caption is marked up with
+ <code>strong</code>, to distinguish it from boilerplate text (before) and the description
+ (after):</p>
+
+ <pre><figcaption>Figure 1. <strong>Ant colony dynamics</strong>. The ants in this colony are
+affected by the heat source (upper left) and the food source (lower right).</figcaption></pre>
+
+ <p>In this example, the heading is really "Flowers, Bees, and Honey", but the author has added a
+ light-hearted addition to the heading. The <code>strong</code> element is thus used to mark up
+ the first part to distinguish it from the latter part.</p>
+
+ <pre><h1><strong>Flowers, Bees, and Honey</strong> and other things I don't understand</h1></pre>
+
+ </div>
+
+ <div class="example">
<p>Here is an example of a warning notice in a game, with the
various parts marked up according to how important they are:</p>
<!-- DO NOT REFLOW THIS EXAMPLE it has been carefully balanced -->
@@ -18479,7 +18517,22 @@
ten meters.</strong></strong> You have been warned.</p></pre>
</div>
+ <div class="example">
+ <p>In this example, the <code>strong</code> element is used to denote the part of the text that
+ the user is intended to read first.</p>
+
+ <pre><p>Welcome to Remy, the reminder system.</p>
+<p>Your tasks for today:</p>
+<ul>
+ <li><p><strong>Turn off the oven.</strong></p></li>
+ <li><p>Put out the trash.</p></li>
+ <li><p>Do the laundry.</p></li>
+</ul></pre>
+
+ </div>
+
+
<h4>The <dfn><code>small</code></dfn> element</h4>
<dl class="element">
@@ -113998,6 +114051,7 @@
Michael Powers,
Michael Rakowski,
Michael(tm) Smith,
+ Michael Walmsley,
Michal Zalewski,
Michel Fortin,
Michelangelo De Simone,
More information about the Commit-Watchers
mailing list