[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