Skip to content

Commit ad20bb8

Browse files
fantasaifantasai
committed
Add some clarifications to table-related stuff
1 parent f82f660 commit ad20bb8

2 files changed

Lines changed: 147 additions & 13 deletions

File tree

‎css3-writing-modes/Overview.html‎

Lines changed: 94 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -264,7 +264,7 @@ <h2 class="no-num no-toc" id=Contents> Table of Contents</h2>
264264

265265
<li><a href="#caption-side"><span class=secno>7.7. </span> Table Caption
266266
Mappings: the &lsquo;<code class=property>caption-side</code>&rsquo;
267-
property</a>
267+
keywords</a>
268268
</ul>
269269

270270
<li><a href="#page-direction"><span class=secno>8. </span> Page Flow: the
@@ -2491,6 +2491,9 @@ <h3 id=logical-direction-layout><span class=secno>7.4. </span>
24912491

24922492
<li>The &lsquo;<code class=property>text-indent</code>&rsquo; property
24932493
indents from the start edge of the line box.
2494+
2495+
<li>For tables, the ordering of columns begins on the start side of the
2496+
table, and the ordering of rows begins on the before side of the table.
24942497
</ul>
24952498

24962499
<h3 id=line-mappings><span class=secno>7.5. </span> Line-Relative Mappings</h3>
@@ -2573,7 +2576,51 @@ <h3 id=physical-only><span class=secno>7.6. </span> Purely Physical
25732576
</ul>
25742577

25752578
<h3 id=caption-side><span class=secno>7.7. </span> Table Caption Mappings:
2576-
the &lsquo;<code class=property>caption-side</code>&rsquo; property</h3>
2579+
the &lsquo;<code class=property>caption-side</code>&rsquo; keywords</h3>
2580+
2581+
<table class=propdef>
2582+
<tbody>
2583+
<tr>
2584+
<th>Property:
2585+
2586+
<td>&lsquo;<code class=property>caption-side</code>&rsquo;
2587+
2588+
<tr>
2589+
<th>New Values:
2590+
2591+
<td>&lsquo;<a href="#before"><code class=css>before</code></a>&rsquo; |
2592+
&lsquo;<a href="#after"><code class=css>after</code></a>&rsquo;
2593+
2594+
<tr>
2595+
<th>Initial:
2596+
2597+
<td>same as CSS2.1
2598+
2599+
<tr>
2600+
<th>Applies to:
2601+
2602+
<td>same as CSS2.1
2603+
2604+
<tr>
2605+
<th>Inherited:
2606+
2607+
<td>same as CSS2.1
2608+
2609+
<tr>
2610+
<th>Percentages:
2611+
2612+
<td>same as CSS2.1
2613+
2614+
<tr>
2615+
<th>Media:
2616+
2617+
<td>same as CSS2.1
2618+
2619+
<tr>
2620+
<th>Computed&#160;value:
2621+
2622+
<td>specified value
2623+
</table>
25772624

25782625
<p>This module introduces two new values to the &lsquo;<code
25792626
class=property>caption-side</code>&rsquo; property: &lsquo;<a
@@ -2587,6 +2634,12 @@ <h3 id=caption-side><span class=secno>7.7. </span> Table Caption Mappings:
25872634
class=css>bottom</code></a>&rsquo; values, respectively. <a href="#CSS21"
25882635
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
25892636

2637+
<p class=note>For implementations that support the &lsquo;<code
2638+
class=property>top-outside</code>&rsquo; and &lsquo;<code
2639+
class=property>bottom-outside</code>&rsquo; model, corresponding
2640+
&lsquo;<code class=property>before-outside</code>&rsquo; and &lsquo;<code
2641+
class=property>after-outside</code>&rsquo; will be similarly introduced.
2642+
25902643
<p>Implementations that support the &lsquo;<a href="#top"><code
25912644
class=css>top</code></a>&rsquo; and &lsquo;<a href="#bottom"><code
25922645
class=css>bottom</code></a>&rsquo; values of the &lsquo;<code
@@ -2601,16 +2654,22 @@ <h3 id=caption-side><span class=secno>7.7. </span> Table Caption Mappings:
26012654

26022655
<p>For implementations that do support side captions (i.e. the &lsquo;<a
26032656
href="#left"><code class=css>left</code></a>&rsquo; and &lsquo;<a
2604-
href="#right"><code class=css>right</code></a>&rsquo; values), this module
2605-
also introduces the &lsquo;<a href="#start"><code
2606-
class=css>start</code></a>&rsquo; and &lsquo;<a href="#end"><code
2607-
class=css>end</code></a>&rsquo; values, which behave similarly and which
2608-
position the caption on the start and end sides of the table box,
2609-
calculated with respect to the writing mode of the table element. For such
2610-
implementations, the &lsquo;<a href="#top"><code
2657+
href="#right"><code class=css>right</code></a>&rsquo; values from the
2658+
obsolete CSS&nbsp;2.0 specification <a href="#CSS2"
2659+
rel=biblioentry>[CSS2]<!--{{CSS2}}--></a>), this module also introduces
2660+
the &lsquo;<a href="#start"><code class=css>start</code></a>&rsquo; and
2661+
&lsquo;<a href="#end"><code class=css>end</code></a>&rsquo; values, which
2662+
behave similarly and which position the caption on the start and end sides
2663+
of the table box, calculated with respect to the writing mode of the table
2664+
element. For such implementations, the &lsquo;<a href="#top"><code
26112665
class=css>top</code></a>&rsquo; and &lsquo;<a href="#bottom"><code
26122666
class=css>bottom</code></a>&rsquo; values must place the caption on the
2613-
top and bottom sides of the table box, respectively. <!--
2667+
top and bottom sides of the table box, respectively.
2668+
2669+
<p class=note>The CSS2.0 side caption model had some <a
2670+
href="http://lists.w3.org/Archives/Public/www-style/2002Dec/0142.html">problems</a>
2671+
and will likely have a different definition in CSS3.</p>
2672+
<!--
26142673
<h3 id="html-attributes">HTML Attributes</h3>
26152674
26162675
<p>This section defines the mapping of HTML presentational attributes
@@ -2671,7 +2730,6 @@ <h4 id="spacing-attributes">Spacing Attributes</h4>
26712730
<li>marginheight</li>
26722731
</ul>
26732732
-->
2674-
26752733

26762734
<h2 id=page-direction><span class=secno>8. </span> Page Flow: the page
26772735
progression direction</h2>
@@ -3310,6 +3368,16 @@ <h3 class=no-num id=other-references> Other references</h3>
33103368
<dt style="display: none"><!-- keeps the doc valid if the DL is empty -->
33113369
<!---->
33123370

3371+
<dt id=CSS2>[CSS2]
3372+
3373+
<dd>Ian Jacobs; et al. <a
3374+
href="http://www.w3.org/TR/2008/REC-CSS2-20080411"><cite>Cascading Style
3375+
Sheets, level 2 (CSS2) Specification.</cite></a> 11 April 2008. W3C
3376+
Recommendation. URL: <a
3377+
href="http://www.w3.org/TR/2008/REC-CSS2-20080411">http://www.w3.org/TR/2008/REC-CSS2-20080411</a>
3378+
</dd>
3379+
<!---->
3380+
33133381
<dt id=CSS3BG>[CSS3BG]
33143382

33153383
<dd>Bert Bos; Elika J. Etemad; Brad Kemper. <a
@@ -3405,6 +3473,21 @@ <h2 class=no-num id=property-index> Property Index</h2>
34053473

34063474
<td>visual
34073475

3476+
<tr valign=baseline>
3477+
<td><span class=property>&lsquo;caption-side&rsquo;</span>
3478+
3479+
<td>&lsquo;before&rsquo; | &lsquo;after&rsquo;
3480+
3481+
<td>same as CSS2.1
3482+
3483+
<td>same as CSS2.1
3484+
3485+
<td>same as CSS2.1
3486+
3487+
<td>same as CSS2.1
3488+
3489+
<td>same as CSS2.1
3490+
34083491
<tr valign=baseline>
34093492
<td><span class=property>&lsquo;column-width&rsquo;</span>
34103493

‎css3-writing-modes/Overview.src.html‎

Lines changed: 53 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1846,6 +1846,9 @@ <h3 id="logical-direction-layout">
18461846
aligns to the start edge of the line box.
18471847
<li>The 'text-indent' property indents from the start
18481848
edge of the line box.
1849+
<li>For tables, the ordering of columns begins on the start
1850+
side of the table, and the ordering of rows begins on the
1851+
before side of the table.
18491852
</ul>
18501853

18511854
<h3 id="line-mappings">
@@ -1910,27 +1913,75 @@ <h3 id="physical-only">
19101913
</ul>
19111914

19121915
<h3 id="caption-side">
1913-
Table Caption Mappings: the 'caption-side' property</h3>
1916+
Table Caption Mappings: the 'caption-side' keywords</h3>
1917+
1918+
<table class="propdef">
1919+
<tbody>
1920+
<tr>
1921+
<th>Property:</th>
1922+
<td>'caption-side'</td>
1923+
</tr>
1924+
<tr>
1925+
<th>New Values:</th>
1926+
<td>''before'' | ''after''</td>
1927+
</tr>
1928+
<tr>
1929+
<th>Initial:</th>
1930+
<td>same as CSS2.1</td>
1931+
</tr>
1932+
<tr>
1933+
<th>Applies to:</th>
1934+
<td>same as CSS2.1</td>
1935+
</tr>
1936+
<tr>
1937+
<th>Inherited:</th>
1938+
<td>same as CSS2.1</td>
1939+
</tr>
1940+
<tr>
1941+
<th>Percentages:</th>
1942+
<td>same as CSS2.1</td>
1943+
</tr>
1944+
<tr>
1945+
<th>Media:</th>
1946+
<td>same as CSS2.1</td>
1947+
</tr>
1948+
<tr>
1949+
<th>Computed&#160;value:</th>
1950+
<td>specified value</td>
1951+
</tr>
1952+
</tbody>
1953+
</table>
1954+
19141955

19151956
<p>This module introduces two new values to the 'caption-side' property:
19161957
''before'' and ''after'', which position the caption before and
19171958
after the table box, respectively. For tables with ''horizontal-tb''
19181959
writing mode, they are equivalent to the existing ''top'' and
19191960
''bottom'' values, respectively. [[!CSS21]]
19201961

1962+
<p class='note'>For implementations that support the 'top-outside'
1963+
and 'bottom-outside' model, corresponding 'before-outside' and
1964+
'after-outside' will be similarly introduced.
1965+
19211966
<p>Implementations that support the ''top'' and ''bottom'' values
19221967
of the 'caption-side' property but do not support side captions
19231968
(i.e. ''left'' and ''right'' captions in horizontal writing modes)
19241969
must treat ''top'' and ''bottom'' as ''before'', when the table
19251970
is in a vertical writing mode.
19261971

19271972
<p>For implementations that do support side captions (i.e. the ''left''
1928-
and ''right'' values), this module also introduces the ''start''
1973+
and ''right'' values from the obsolete CSS&nbsp;2.0 specification
1974+
[[CSS2]]), this module also introduces the ''start''
19291975
and ''end'' values, which behave similarly and which position the
19301976
caption on the start and end sides of the table box, calculated
19311977
with respect to the writing mode of the table element. For such
19321978
implementations, the ''top'' and ''bottom'' values must place the
19331979
caption on the top and bottom sides of the table box, respectively.
1980+
1981+
<p class="note">The CSS2.0 side caption model had some
1982+
<a href="http://lists.w3.org/Archives/Public/www-style/2002Dec/0142.html">problems</a>
1983+
and will likely have a different definition in CSS3.</p>
1984+
19341985
<!--
19351986
<h3 id="html-attributes">HTML Attributes</h3>
19361987

0 commit comments

Comments
 (0)