css-overflow/Overview.bs

changeset 15277
ec3666d1e63d
parent 15207
ea07ee919097
child 15278
79f716a8ad8f
     1.1 --- a/css-overflow/Overview.bs	Tue Mar 03 21:51:56 2015 -0800
     1.2 +++ b/css-overflow/Overview.bs	Tue Feb 24 14:42:29 2015 +0900
     1.3 @@ -380,7 +380,7 @@
     1.4  
     1.5  	<pre class=propdef>
     1.6  		Name: overflow-x, overflow-y
     1.7 -		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto'' | ''paged-x'' | ''paged-y'' | ''paged-x-controls'' | ''paged-y-controls'' | ''fragments''
     1.8 +		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto''
     1.9  		Initial: ''visible''
    1.10  		Applies to: block containers [[!CSS21]], flex containers [[!CSS3-FLEXBOX]], and grid containers [[!CSS3-GRID-LAYOUT]]
    1.11  		Inherited: no
    1.12 @@ -399,7 +399,7 @@
    1.13  
    1.14  	<pre class=propdef>
    1.15  		Name: overflow
    1.16 -		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto'' | ''paged-x'' | ''paged-y'' | ''paged-x-controls'' | ''paged-y-controls'' | ''fragments''
    1.17 +		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto''
    1.18  		Initial: see individual properties
    1.19  		Applies to: block containers [[!CSS21]], flex containers [[!CSS3-FLEXBOX]], and grid containers [[!CSS3-GRID-LAYOUT]]
    1.20  		Inherited: no
    1.21 @@ -410,6 +410,24 @@
    1.22  		Canonical order: <abbr title="follows order of property value definition">per grammar</abbr>
    1.23  	</pre>
    1.24  
    1.25 +	<div id="overflow-computed-values">
    1.26 +		<p>The computed values of 'overflow-x' and 'overflow-y'
    1.27 +		are determined from the cascaded values [[!CSS3CASCADE]]
    1.28 +		based on the following rules:</p>
    1.29 +
    1.30 +		<ol>
    1.31 +			<li>
    1.32 +				If one cascaded values is ''overflow/visible''
    1.33 +				and the other is not,
    1.34 +				then computed values are the cascaded values
    1.35 +				with ''overflow/visible'' changed to ''overflow/auto''.
    1.36 +			</li>
    1.37 +			<li>
    1.38 +				Otherwise, the computed values are as specified.
    1.39 +			</li>
    1.40 +		</ol>
    1.41 +	</div>
    1.42 +
    1.43  	<p>The values of these properties are:</p>
    1.44  
    1.45  	<dl dfn-for="overflow" dfn-type="value">
    1.46 @@ -422,10 +440,41 @@
    1.47  		<dt><dfn>scroll</dfn>
    1.48  		<dt><dfn>auto</dfn>
    1.49  		<dd>
    1.50 -			These values are collectively the <dfn dfn>scrolling values</dfn>;
    1.51 -			they are defined in the section on
    1.52 -			<a href="#scrolling-overflow">scrolling and hidden overflow</a>.
    1.53 +			<p class="issue">
    1.54 +			Move material from [[CSS21]] and [[CSS3BOX]] here.
    1.55 +			</p>
    1.56  		</dd>
    1.57 +	</dl>
    1.58 +
    1.59 +	<p class="issue">
    1.60 +		Explain which directions allow scrolling and which don't,
    1.61 +		as a function of 'direction'
    1.62 +		(including propagation of 'direction' to the ICB).
    1.63 +	</p>
    1.64 +
    1.65 +
    1.66 +	<p class="issue">
    1.67 +		[[CSS3-MARQUEE]] describes an 'overflow-style' property,
    1.68 +		but it has not picked up implementation experience
    1.69 +		that the working group is aware of.
    1.70 +		Should this document treat 'overflow-style' as a defunct proposal,
    1.71 +		or should this document describe the 'overflow-style' property
    1.72 +		and attempt to revive it,
    1.73 +		despite that implementations have implemented
    1.74 +		'overflow-x' and 'overflow-y' instead?
    1.75 +	</p>
    1.76 +
    1.77 +<h2 id="fragmentation-properties">Fragmentation properties</h2>
    1.78 +
    1.79 +Issue: This section is a WIP, and currently just holds bits of information that need to be massaged into proper form.
    1.80 +
    1.81 + | ''paged-x'' | ''paged-y'' | ''paged-x-controls'' | ''paged-y-controls'' | ''fragments''
    1.82 +
    1.83 +	<p class="issue">
    1.84 +		Are all 4 of the ''paged-*'' values really needed?
    1.85 +	</p>
    1.86 +
    1.87 +	<dl>
    1.88  		<dt><dfn>paged-x</dfn>
    1.89  		<dt><dfn>paged-y</dfn>
    1.90  		<dt><dfn>paged-x-controls</dfn>
    1.91 @@ -439,77 +488,10 @@
    1.92  		</dd>
    1.93  	</dl>
    1.94  
    1.95 -	<div id="overflow-computed-values">
    1.96 -		<p>The computed values of 'overflow-x' and 'overflow-y'
    1.97 -		are determined from the cascaded values [[!CSS3CASCADE]]
    1.98 -		based on the following rules:</p>
    1.99 +	<div class="issue">
   1.100 +		Having split the overflow and fragmentation properties, this issue is no longer relevant, but there are
   1.101 +		useful bits of information in the thread, so I am leaving it here for now.
   1.102  
   1.103 -		<ol>
   1.104 -			<li>
   1.105 -				If one or both of the cascaded values are
   1.106 -				<a>fragmenting values</a>, then:
   1.107 -				<ol>
   1.108 -					<li>
   1.109 -						If one of the cascaded values is one of the
   1.110 -						<a>fragmenting values</a>
   1.111 -						and the other is not,
   1.112 -						then the computed values are
   1.113 -						the same as the cascaded values.
   1.114 -					</li>
   1.115 -					<li>
   1.116 -						If both of the cascaded values are <a>fragmenting values</a>, then:
   1.117 -						<ol>
   1.118 -							<li>
   1.119 -								for horizontal writing mode [[!CSS3-WRITING-MODES]],
   1.120 -								the computed value for 'overflow-y' is the cascaded value
   1.121 -								and the computed value for 'overflow-x' is ''overflow/hidden'', or
   1.122 -							</li>
   1.123 -							<li>
   1.124 -								for vertical writing mode [[!CSS3-WRITING-MODES]],
   1.125 -								the computed value for 'overflow-x' is the cascaded value
   1.126 -								and the computed value for 'overflow-y' is ''overflow/hidden''.
   1.127 -							</li>
   1.128 -						</ol>
   1.129 -					</li>
   1.130 -				</ol>
   1.131 -			</li>
   1.132 -			<li>
   1.133 -				Otherwise, if one cascaded values is
   1.134 -				one of the <a>scrolling values</a>
   1.135 -				and the other is ''overflow/visible'',
   1.136 -				then computed values are the cascaded values
   1.137 -				with ''overflow/visible'' changed to ''overflow/auto''.
   1.138 -			</li>
   1.139 -			<li>
   1.140 -				Otherwise, the computed values are as specified.
   1.141 -			</li>
   1.142 -		</ol>
   1.143 -	</div>
   1.144 -
   1.145 -	<p class="issue">
   1.146 -		Are all 4 of the ''paged-*'' values really needed?
   1.147 -	</p>
   1.148 -
   1.149 -	<p>
   1.150 -		When the <a>fragmenting values</a> are used,
   1.151 -		the overflow from the fragments themselves
   1.152 -		treats the fragmenting value as ''overflow/hidden''.
   1.153 -		<span class="issue">Is this the right behavior?</span>
   1.154 -		<span class="issue">Give example.</span>
   1.155 -	</p>
   1.156 -
   1.157 -	<p class="issue">
   1.158 -		[[CSS3-MARQUEE]] describes an 'overflow-style' property,
   1.159 -		but it has not picked up implementation experience
   1.160 -		that the working group is aware of.
   1.161 -		Should this document treat 'overflow-style' as a defunct proposal,
   1.162 -		or should this document describe the 'overflow-style' property
   1.163 -		and attempt to revive it,
   1.164 -		despite that implementations have implemented
   1.165 -		'overflow-x' and 'overflow-y' instead?
   1.166 -	</p>
   1.167 -
   1.168 -	<p class="issue">
   1.169  		There are <a href="http://lists.w3.org/Archives/Public/www-style/2012May/1197.html">discussions</a>
   1.170  		about how overflow, overflow-style, overflow-x and overflow-y
   1.171  		should work and interact with each other.
   1.172 @@ -517,19 +499,8 @@
   1.173  		it is not completely clear which of these
   1.174  		should be used for
   1.175  		paged-x | paged-y | paged-x-controls | paged-y-controls | fragments
   1.176 -	</p>
   1.177 +	</div>
   1.178  
   1.179 -<h2 id="scrolling-overflow">Scrolling and hidden overflow</h2>
   1.180 -
   1.181 -	<p class="issue">
   1.182 -		Move material from [[CSS21]] and [[CSS3BOX]] here.
   1.183 -	</p>
   1.184 -
   1.185 -	<p class="issue">
   1.186 -		Explain which directions allow scrolling and which don't,
   1.187 -		as a function of 'direction'
   1.188 -		(including propagation of 'direction' to the ICB).
   1.189 -	</p>
   1.190  
   1.191  <h2 id="paginated-overflow">Paginated overflow</h2>
   1.192  

mercurial