[css-display] Added a glossary of common terms that'll eventually show up in Block & Inline Layout.

--HG--
extra : rebase_source : 7fb4afdb187ffdd9e0f0bafa0b98660ccf98c1c2

Author: tabatkins

css-display/Overview.bs

@@ -9,7 +9,7 @@ Level: 3
 Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
 Editor: fantasai, Invited Expert, http://fantasai.inkedblade.net/contact
 Abstract: This module contains the features of CSS relating to the 'display' property and other box-generation details.
-Ignored Terms: show, display-model, display-role, table row group box, formatting context, inline-level box
+Ignored Terms: display-model, display-role, table row group box, formatting context
 Link Defaults: css-lists-3 (property) counter-increment
 </pre>
 
@@ -140,15 +140,15 @@ Interacting with Ancestors and Siblings: the 'display-outside' property</h3>
 	<dl dfn-type="value" dfn-for="display-outside">
 		<dt><dfn>block-level</dfn>
 		<dd>
-			The element is block-level,
+			The element generates a <dfn dfn>block-level box</dfn>,
 			and participates in a block formatting context.
 			Other formatting contexts,
 			such as flex formatting contexts,
 			may also work with block-level elements. [[!CSS21]]
 
 		<dt><dfn>inline-level</dfn>
 		<dd>
-			The element is inline-level,
+			The element generates an <dfn dfn>inline-level box</dfn>,
 			and participates in an inline formatting context. [[!CSS21]]
 
 		<dt><dfn>run-in</dfn>
@@ -493,6 +493,75 @@ Run-In Layout</h2>
 	Issue: Should out-of-flow elements get reparented, left behind, or break apart the sequence?
 	<a href="http://lists.w3.org/Archives/Public/www-style/2012Aug/0257.html">See thread.</a>
 
+<h2 id='glossary'>
+Glossary</h2>
+
+	The following terms are defined here for convenience:
+
+	<dl export>
+		<dt><dfn title="inline-level|inline-level content">inline-level</dfn>
+		<dd>
+			Content that participates in inline layout.
+			Specifically, inline-level boxes and text.
+
+		<dt><dfn title="block-level|block-level content">block-level</dfn>
+		<dd>
+			Content that participates in block layout.
+			Specifically, block-level boxes.
+
+		<dt><dfn title="inline|inline box">inline</dfn>
+		<dd>
+			A non-replaced <a>inline-level</a> box whose 'display-inside' is ''auto''.
+			The contents of an inline box participate in the same inline formatting context as the inline box itself.
+
+		<dt><dfn title="atomic inline|atomic inline box">atomic inline</dfn>
+		<dd>
+			An inline-level box that is replaced or that establishes a new formatting context.
+			(An inline-level box whose 'display-inside' is not ''auto'' establishes a new formatting context of the specified type.)
+
+		<dt><dfn title="block container|block container box">block container</dfn>
+		<dd>
+			A box whose contents participate in a block formatting context,
+			i.e. one whose computed 'display-inside' value is ''display-inside/block''.
+
+		<dt><dfn>block box</dfn>
+		<dd>
+			A <a>block-level box</a> that is a <a>block container</a>.
+
+		<dt><dfn>block</dfn>
+		<dd>
+			Used as a shorthand for <a>block box</a>, <a>block-level box</a>, or <a>block container box</a>,
+			where unambiguous.
+
+		<dt><dfn>containing block</dfn>
+		<dd>
+			A rectangle that forms the basis of sizing and positioning
+			for the boxes associated with it
+			(usually the children of the box that generated it).
+			Notably, a containing block is <em>not a box</em>
+			(it is a rectangle),
+			however it is often derived from the dimensions of a box.
+			If properties of a containing block are referenced,
+			they reference the values on the box that generated the containing block.
+			(For the <a>initial containing block</a>, the values are taken from the root element.)
+			See [[CSS21]] <a href="http://www.w3.org/TR/CSS21/visuren.html#containing-block">Section 9.1.2</a>
+			and <a href="http://www.w3.org/TR/CSS21/visudet.html#containing-block-details">Section 10.1</a> for details.
+
+		<dt><dfn>initial containing block</dfn>
+		<dd>
+			The <a>containing block</a> of the root element.
+			See <a href="http://www.w3.org/TR/CSS21/visudet.html#containing-block-details">CSS2.1&sect;10.1</a> for continuous media;
+			and [[!CSS3PAGE]] for paged media.
+
+		<dt><dfn>formatting context</dfn>
+		<dd>
+			Issue: wordsmith this.
+
+			Block and inline formatting contexts are defined in CSS 2.1 Section 9.4.
+	</dl>
+
+	See [[!CSS21]] <a href="http://www.w3.org/TR/CSS21/visuren.html">Chapter 9</a> for a fuller definition of these terms.
+
 <h2 class=no-num id="acknowledgments">
 Acknowledgments</h2>
 

css-display/Overview.html

@@ -126,6 +126,7 @@ <h2 class="no-num no-toc no-ref heading settled" id=contents><span class=content
 		<li><a href=#transformations><span class=secno>2.5</span>  Automatic Box Type Transformations</a></ul>
 	<li><a href=#box-suppress><span class=secno>3</span>  Controlling box generation: the <span class=property data-link-type=propdesc title=box-suppress>box-suppress</span> property</a>
 	<li><a href=#run-in><span class=secno>4</span>  Run-In Layout</a>
+	<li><a href=#glossary><span class=secno>5</span>  Glossary</a>
 	<li><a href=#acknowledgments><span class=secno></span>  Acknowledgments</a>
 	<li><a href=#conformance><span class=secno></span>  Conformance</a>
 		<ul class=toc>
@@ -254,15 +255,15 @@ <h3 class="heading settled" data-level=2.2 id=the-display-outside><span class=se
 	<dl data-dfn-for=display-outside data-dfn-type=value>
 		<dt><dfn class=css data-dfn-for=display-outside data-dfn-type=value data-export="" id=valdef-display-outside-block-level>block-level<a class=self-link href=#valdef-display-outside-block-level></a></dfn>
 		<dd>
-			The element is block-level,
+			The element generates a <dfn data-dfn-type=dfn data-noexport="" id=block-level-box>block-level box<a class=self-link href=#block-level-box></a></dfn>,
 			and participates in a block formatting context.
 			Other formatting contexts,
 			such as flex formatting contexts,
 			may also work with block-level elements. <a data-biblio-type=normative data-link-type=biblio href=#biblio-css21 title=biblio-CSS21>[CSS21]</a>
 
 		<dt><dfn class=css data-dfn-for=display-outside data-dfn-type=value data-export="" id=valdef-display-outside-inline-level>inline-level<a class=self-link href=#valdef-display-outside-inline-level></a></dfn>
 		<dd>
-			The element is inline-level,
+			The element generates an <dfn data-dfn-type=dfn data-noexport="" id=inline-level-box>inline-level box<a class=self-link href=#inline-level-box></a></dfn>,
 			and participates in an inline formatting context. <a data-biblio-type=normative data-link-type=biblio href=#biblio-css21 title=biblio-CSS21>[CSS21]</a>
 
 		<dt><dfn class=css data-dfn-for=display-outside data-dfn-type=value data-export="" id=valdef-display-outside-run-in>run-in<a class=self-link href=#valdef-display-outside-run-in></a></dfn>
@@ -547,12 +548,12 @@ <h2 class="heading settled" data-level=4 id=run-in><span class=secno>4 </span><s
 </pre>
 	</div>
 
-<p>A <a data-link-type=dfn href=#run-in-box title="run-in box">run-in box</a> behaves exactly as an <a data-link-type=dfn title="inline-level box">inline-level box</a>, except:</p>
+<p>A <a data-link-type=dfn href=#run-in-box title="run-in box">run-in box</a> behaves exactly as an <a data-link-type=dfn href=#inline-level-box title="inline-level box">inline-level box</a>, except:</p>
 
 	<ul>
 		<li>
 			If a <a data-link-type=dfn href=#run-in-sequence title="run-in sequence">run-in sequence</a> is immediately followed by a block box
-			that does not establish a new <a data-link-type=dfn title="formatting context">formatting context</a>,
+			that does not establish a new <a data-link-type=dfn href=#formatting-context title="formatting context">formatting context</a>,
 			it is inserted as direct children of the block box
 			after its <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-lists-3/#selectordef-marker title=::marker>::marker</a> pseudo-element’s boxes (if any),
 			but preceding any other boxes generates by the contents of the block
@@ -578,6 +579,75 @@ <h2 class="heading settled" data-level=4 id=run-in><span class=secno>4 </span><s
 <p class=issue id=issue-0c2c54c6><a class=self-link href=#issue-0c2c54c6></a>Should out-of-flow elements get reparented, left behind, or break apart the sequence?
 	<a href=http://lists.w3.org/Archives/Public/www-style/2012Aug/0257.html>See thread.</a></p>
 
+<h2 class="heading settled" data-level=5 id=glossary><span class=secno>5 </span><span class=content>
+Glossary</span><a class=self-link href=#glossary></a></h2>
+
+<p>The following terms are defined here for convenience:</p>
+
+	<dl data-export="">
+		<dt><dfn data-dfn-type=dfn data-export="" id=inline-level title="inline-level|inline-level content">inline-level<a class=self-link href=#inline-level></a></dfn>
+		<dd>
+			Content that participates in inline layout.
+			Specifically, inline-level boxes and text.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=block-level title="block-level|block-level content">block-level<a class=self-link href=#block-level></a></dfn>
+		<dd>
+			Content that participates in block layout.
+			Specifically, block-level boxes.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=inline title="inline|inline box">inline<a class=self-link href=#inline></a></dfn>
+		<dd>
+			A non-replaced <a data-link-type=dfn href=#inline-level title=inline-level>inline-level</a> box whose <a class=property data-link-type=propdesc href=#propdef-display-inside title=display-inside>display-inside</a> is <a class=css data-link-type=maybe href=#valdef-display-inside-auto title=auto>auto</a>.
+			The contents of an inline box participate in the same inline formatting context as the inline box itself.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=atomic-inline title="atomic inline|atomic inline box">atomic inline<a class=self-link href=#atomic-inline></a></dfn>
+		<dd>
+			An inline-level box that is replaced or that establishes a new formatting context.
+			(An inline-level box whose <a class=property data-link-type=propdesc href=#propdef-display-inside title=display-inside>display-inside</a> is not <a class=css data-link-type=maybe href=#valdef-display-inside-auto title=auto>auto</a> establishes a new formatting context of the specified type.)
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=block-container title="block container|block container box">block container<a class=self-link href=#block-container></a></dfn>
+		<dd>
+			A box whose contents participate in a block formatting context,
+			i.e. one whose computed <a class=property data-link-type=propdesc href=#propdef-display-inside title=display-inside>display-inside</a> value is <a class=css data-link-for=display-inside data-link-type=maybe href=#valdef-display-inside-block title=block>block</a>.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=block-box>block box<a class=self-link href=#block-box></a></dfn>
+		<dd>
+			A <a data-link-type=dfn href=#block-level-box title="block-level box">block-level box</a> that is a <a data-link-type=dfn href=#block-container title="block container">block container</a>.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=block>block<a class=self-link href=#block></a></dfn>
+		<dd>
+			Used as a shorthand for <a data-link-type=dfn href=#block-box title="block box">block box</a>, <a data-link-type=dfn href=#block-level-box title="block-level box">block-level box</a>, or <a data-link-type=dfn href=#block-container title="block container box">block container box</a>,
+			where unambiguous.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=containing-block>containing block<a class=self-link href=#containing-block></a></dfn>
+		<dd>
+			A rectangle that forms the basis of sizing and positioning
+			for the boxes associated with it
+			(usually the children of the box that generated it).
+			Notably, a containing block is <em>not a box</em>
+			(it is a rectangle),
+			however it is often derived from the dimensions of a box.
+			If properties of a containing block are referenced,
+			they reference the values on the box that generated the containing block.
+			(For the <a data-link-type=dfn href=#initial-containing-block title="initial containing block">initial containing block</a>, the values are taken from the root element.)
+			See <a data-biblio-type=informative data-link-type=biblio href=#biblio-css21 title=biblio-CSS21>[CSS21]</a> <a href=http://www.w3.org/TR/CSS21/visuren.html#containing-block>Section 9.1.2</a>
+			and <a href=http://www.w3.org/TR/CSS21/visudet.html#containing-block-details>Section 10.1</a> for details.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=initial-containing-block>initial containing block<a class=self-link href=#initial-containing-block></a></dfn>
+		<dd>
+			The <a data-link-type=dfn href=#containing-block title="containing block">containing block</a> of the root element.
+			See <a href=http://www.w3.org/TR/CSS21/visudet.html#containing-block-details>CSS2.1§10.1</a> for continuous media;
+			and <a data-biblio-type=normative data-link-type=biblio href=#biblio-css3page title=biblio-CSS3PAGE>[CSS3PAGE]</a> for paged media.
+
+		<dt><dfn data-dfn-type=dfn data-export="" id=formatting-context>formatting context<a class=self-link href=#formatting-context></a></dfn>
+		<dd>
+			Issue: wordsmith this.
+
+<p>Block and inline formatting contexts are defined in CSS 2.1 Section 9.4.</p>
+	</dl>
+
+<p>See <a data-biblio-type=normative data-link-type=biblio href=#biblio-css21 title=biblio-CSS21>[CSS21]</a> <a href=http://www.w3.org/TR/CSS21/visuren.html>Chapter 9</a> for a fuller definition of these terms.</p>
+
 <h2 class="no-num heading settled" id=acknowledgments><span class=content>
 Acknowledgments</span><a class=self-link href=#acknowledgments></a></h2>
 
@@ -727,6 +797,7 @@ <h3 class="no-num no-ref heading settled" id=normative><span class=content>
 <dt id=biblio-css21 title=CSS21><a class=self-link href=#biblio-css21></a>[CSS21]<dd>Bert Bos; et al. <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a>. 7 June 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>http://www.w3.org/TR/2011/REC-CSS2-20110607</a></dd>
 <dt id=biblio-css3-flexbox title=CSS3-FLEXBOX><a class=self-link href=#biblio-css3-flexbox></a>[CSS3-FLEXBOX]<dd>Tab Atkins Jr.; Elika J. Etemad; Alex Mogilevsky. <a href=http://www.w3.org/TR/2012/CR-css3-flexbox-20120918/>CSS Flexible Box Layout Module</a>. 18 September 2012. W3C Candidate Recommendation. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/CR-css3-flexbox-20120918/>http://www.w3.org/TR/2012/CR-css3-flexbox-20120918/</a></dd>
 <dt id=biblio-css3-grid-layout title=CSS3-GRID-LAYOUT><a class=self-link href=#biblio-css3-grid-layout></a>[CSS3-GRID-LAYOUT]<dd>Tab Atkins Jr.; Elika J. Etemad; Rossen Atanassov. <a href=http://www.w3.org/TR/2013/WD-css3-grid-layout-20130402/>CSS Grid Layout</a>. 2 April 2013. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2013/WD-css3-grid-layout-20130402/>http://www.w3.org/TR/2013/WD-css3-grid-layout-20130402/</a></dd>
+<dt id=biblio-css3page title=CSS3PAGE><a class=self-link href=#biblio-css3page></a>[CSS3PAGE]<dd>Melinda Grant; et al. <a href=http://www.w3.org/TR/2013/WD-css3-page-20130314/>CSS Paged Media Module Level 3</a>. 14 March 2013. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2013/WD-css3-page-20130314/>http://www.w3.org/TR/2013/WD-css3-page-20130314/</a></dd>
 <dt id=biblio-css3ruby title=CSS3RUBY><a class=self-link href=#biblio-css3ruby></a>[CSS3RUBY]<dd>Elika J. Etemad; Koji Ishii; Richard Ishida. <a href=http://www.w3.org/TR/2013/WD-css3-ruby-20130919/>CSS3 Ruby Module</a>. 19 September 2013. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2013/WD-css3-ruby-20130919/>http://www.w3.org/TR/2013/WD-css3-ruby-20130919/</a></dd>
 <dt id=biblio-rfc2119 title=RFC2119><a class=self-link href=#biblio-rfc2119></a>[RFC2119]<dd>S. Bradner. <a href=http://www.ietf.org/rfc/rfc2119.txt>Key words for use in RFCs to Indicate Requirement Levels</a>. URL: <a href=http://www.ietf.org/rfc/rfc2119.txt>http://www.ietf.org/rfc/rfc2119.txt</a></dd>
 </dl></div>
@@ -739,13 +810,23 @@ <h3 class="no-num no-ref heading settled" id=informative><span class=content>
 <h2 class="no-num no-ref heading settled" id=index><span class=content>
 Index</span><a class=self-link href=#index></a></h2>
 <div data-fill-with=index><ul class=indexlist>
+<li>atomic inline, <a href=#atomic-inline title="section 5">5</a>
+<li>atomic inline box, <a href=#atomic-inline title="section 5">5</a>
 <li>auto, <a href=#valdef-display-inside-auto title="section 2.1">2.1</a>
 <li>block<ul><li>value for display-inside, <a href=#valdef-display-inside-block title="section 2.1">2.1</a>
 <li>value for display, <a href=#valdef-display-block title="section 2.4">2.4</a>
-</ul><li>blockification, <a href=#blockify title="section 2.5">2.5</a>
+<li>definition of, <a href=#block title="section 5">5</a>
+</ul><li>block box, <a href=#block-box title="section 5">5</a>
+<li>block container, <a href=#block-container title="section 5">5</a>
+<li>block container box, <a href=#block-container title="section 5">5</a>
+<li>blockification, <a href=#blockify title="section 2.5">2.5</a>
 <li>blockify, <a href=#blockify title="section 2.5">2.5</a>
-<li>block-level, <a href=#valdef-display-outside-block-level title="section 2.2">2.2</a>
+<li>block-level<ul><li>value for display-outside, <a href=#valdef-display-outside-block-level title="section 2.2">2.2</a>
+<li>definition of, <a href=#block-level title="section 5">5</a>
+</ul><li>block-level box, <a href=#block-level-box title="section 2.2">2.2</a>
+<li>block-level content, <a href=#block-level title="section 5">5</a>
 <li>box-suppress, <a href=#propdef-box-suppress title="section 3">3</a>
+<li>containing block, <a href=#containing-block title="section 5">5</a>
 <li>contents<ul><li>value for display-outside, <a href=#valdef-display-outside-contents title="section 2.2">2.2</a>
 <li>value for display, <a href=#valdef-display-contents title="section 2.4">2.4</a>
 </ul><li>discard, <a href=#valdef-box-suppress-discard title="section 3">3</a>
@@ -755,14 +836,21 @@ <h2 class="no-num no-ref heading settled" id=index><span class=content>
 <li>display-outside, <a href=#propdef-display-outside title="section 2.2">2.2</a>
 <li>flex<ul><li>value for display-inside, <a href=#valdef-display-inside-flex title="section 2.1">2.1</a>
 <li>value for display, <a href=#valdef-display-flex title="section 2.4">2.4</a>
-</ul><li>grid<ul><li>value for display-inside, <a href=#valdef-display-inside-grid title="section 2.1">2.1</a>
+</ul><li>formatting context, <a href=#formatting-context title="section 5">5</a>
+<li>grid<ul><li>value for display-inside, <a href=#valdef-display-inside-grid title="section 2.1">2.1</a>
 <li>value for display, <a href=#valdef-display-grid title="section 2.4">2.4</a>
 </ul><li>hide, <a href=#valdef-box-suppress-hide title="section 3">3</a>
-<li>inline, <a href=#valdef-display-inline title="section 2.4">2.4</a>
-<li>inline-block, <a href=#valdef-display-inline-block title="section 2.4">2.4</a>
+<li>initial containing block, <a href=#initial-containing-block title="section 5">5</a>
+<li>inline<ul><li>value for display, <a href=#valdef-display-inline title="section 2.4">2.4</a>
+<li>definition of, <a href=#inline title="section 5">5</a>
+</ul><li>inline-block, <a href=#valdef-display-inline-block title="section 2.4">2.4</a>
+<li>inline box, <a href=#inline title="section 5">5</a>
 <li>inline-flex, <a href=#valdef-display-inline-flex title="section 2.4">2.4</a>
 <li>inline-grid, <a href=#valdef-display-inline-grid title="section 2.4">2.4</a>
-<li>inline-level, <a href=#valdef-display-outside-inline-level title="section 2.2">2.2</a>
+<li>inline-level<ul><li>value for display-outside, <a href=#valdef-display-outside-inline-level title="section 2.2">2.2</a>
+<li>definition of, <a href=#inline-level title="section 5">5</a>
+</ul><li>inline-level box, <a href=#inline-level-box title="section 2.2">2.2</a>
+<li>inline-level content, <a href=#inline-level title="section 5">5</a>
 <li>inline-list-item, <a href=#valdef-display-inline-list-item title="section 2.4">2.4</a>
 <li>inline-table, <a href=#valdef-display-inline-table title="section 2.4">2.4</a>
 <li>inlinification, <a href=#inlinify title="section 2.5">2.5</a>