css-overflow/Overview.bs

changeset 15496
49f014586321
parent 15446
bd644ac63c36
child 15497
cc8044604ac7
     1.1 --- a/css-overflow/Overview.bs	Wed Apr 29 21:56:47 2015 +0200
     1.2 +++ b/css-overflow/Overview.bs	Thu Apr 30 00:19:39 2015 +0200
     1.3 @@ -377,7 +377,7 @@
     1.4  
     1.5  	<pre class=propdef>
     1.6  		Name: overflow-x, overflow-y
     1.7 -		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto''
     1.8 +		Value: ''visible'' | ''hidden'' | ''clipped'' | ''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 @@ -396,7 +396,7 @@
    1.13  
    1.14  	<pre class=propdef>
    1.15  		Name: overflow
    1.16 -		Value: ''visible'' | ''hidden'' | ''scroll'' | ''auto''
    1.17 +		Value: ''visible'' | ''hidden'' | ''clipped'' | ''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 @@ -434,15 +434,66 @@
    1.22  			may be rendered outside the block container.
    1.23  		</dd>
    1.24  		<dt><dfn>hidden</dfn>
    1.25 +		<dd>This value indicates that
    1.26 +		the content is clipped and that no scrolling user interface should be provided by the UA
    1.27 +		to view the content outside the clipping region.
    1.28 +		However, the content may still be scrolled programatically,
    1.29 +		for example using the mechanisms defined in [[CSSOM-VIEW]].
    1.30 +		<dt><dfn>clipped</dfn>
    1.31 +		<dd>Like ''hidden'',
    1.32 +		this value indicates that
    1.33 +		the content is clipped
    1.34 +		and that no scrolling user interface should be provided by the UA
    1.35 +		to view the content outside the clipping region.
    1.36 +		In addition, unlike ''overflow: hidden''
    1.37 +		which still allows programmatic scrolling,
    1.38 +		''overflow: clipped'' forbids scrolling entirely,
    1.39 +		through any mechanism.
    1.40 +		
    1.41 +		Issue: Mozilla implements -moz-hidden-unscrollable,
    1.42 +		which is similar to ''clipped'',
    1.43 +		except that it does not cause the element to establish a BFC.
    1.44 +		Should we match that?
    1.45  		<dt><dfn>scroll</dfn>
    1.46 +		<dd>This value indicates that the content is clipped
    1.47 +		and that if the user agent uses a scrolling mechanism
    1.48 +		that is visible on the screen (such as a scroll bar or a panner),
    1.49 +		that mechanism should be displayed for a box
    1.50 +		whether or not any of its content is clipped.
    1.51 +		This avoids any problem with scrollbars appearing
    1.52 +		and disappearing in a dynamic environment.
    1.53 +		When this value is specified and the target medium is ''print'',
    1.54 +		overflowing content may be printed. 
    1.55  		<dt><dfn>auto</dfn>
    1.56 -		<dd>
    1.57 -			<p class="issue">
    1.58 -			Move material from [[CSS21]] and [[CSS3BOX]] here.
    1.59 -			</p>
    1.60 -		</dd>
    1.61 +		<dd>The behavior of the ''overflow/auto'' value is user agent-dependent,
    1.62 +		but should cause a scrolling mechanism to be provided for overflowing boxes. 
    1.63  	</dl>
    1.64  
    1.65 +	Even if 'overflow' is set to ''overflow/visible'',
    1.66 +	content may be clipped to a UA's document window by the native operating environment. 
    1.67 +
    1.68 +	If the computed value of 'overflow' is not ''overflow/visible'',
    1.69 +	the element creates a block formatting context.
    1.70 +
    1.71 +	UAs must apply the 'overflow' property
    1.72 +	set on the root element to the viewport.
    1.73 +	HTML UAs must instead apply the ‘overflow’ property
    1.74 +	from the <{body}> element to the viewport
    1.75 +	if the value on the root element is ''visible''.
    1.76 +	The ''visible'' value when used for the viewport
    1.77 +	must be interpreted as ''overflow/auto''.
    1.78 +	The element from which the value is propagated
    1.79 +	must have a used value for 'overflow' of ''visible''.
    1.80 +
    1.81 +	In the case of a scrollbar being placed on an edge of the element's box,
    1.82 +	it should be inserted between the inner border edge
    1.83 +	and the outer padding edge.
    1.84 +	Any space taken up by the scrollbars should be
    1.85 +	taken out of (subtracted from the dimensions of)
    1.86 +	the containing block formed by the element with the scrollbars. 
    1.87 +
    1.88 +	Issue: import examples from [[CSS3-BOX]].
    1.89 +
    1.90  	<p class="issue">
    1.91  		Explain which directions allow scrolling and which don't,
    1.92  		as a function of 'direction'

mercurial