diff --git a/css-contain-1/Overview.bs b/css-contain-1/Overview.bs index 3bdb4a08c92c..a975d35769d3 100644 --- a/css-contain-1/Overview.bs +++ b/css-contain-1/Overview.bs @@ -733,6 +733,12 @@ Paint Containment nor does it inhibit the creation of any such mechanism through other properties, such as 'overflow', 'resize', or 'text-overflow'. + Note: The next level of this specification [[CSS-CONTAIN-2]] refines this effect + to apply to the [=overflow clip edge=] rather than the [=padding edge=], + in order to take the new 'overflow-clip-margin' property into account. + For implementations that do not support 'overflow-clip-margin', + the effect is identical. + Note: The behavior is described in this paragraph is equivalent to changing ''overflow-x: visible'' into ''overflow-x: clip'' and diff --git a/css-contain-2/Overview.bs b/css-contain-2/Overview.bs index 3ce0c5f4a5cf..26f49efd1d86 100644 --- a/css-contain-2/Overview.bs +++ b/css-contain-2/Overview.bs @@ -873,14 +873,14 @@ Paint Containment 1. The contents of the element including any [=ink overflow|ink=] or [=scrollable overflow=] - must be clipped to the padding edge of the [=paint containment/containing box=], + must be clipped to the overflow clip edge of the [=paint containment/containing box=], taking corner clipping into account. This does not include the creation of any mechanism to access or indicate the presence of the clipped content; nor does it inhibit the creation of any such mechanism through other properties, such as 'overflow', 'resize', or 'text-overflow'. - This clipping shape respects 'overflow-clip-margin', + Note: This clipping shape respects 'overflow-clip-margin', allowing an element with [=paint containment=] to still slightly overflow its normal bounds. diff --git a/css-overflow-3/Overview.bs b/css-overflow-3/Overview.bs index e8896b15a296..1b5efd508132 100644 --- a/css-overflow-3/Overview.bs +++ b/css-overflow-3/Overview.bs @@ -383,9 +383,8 @@ Scrolling and Clipping Overflow: the 'overflow-x', 'overflow-y', and 'overflow'
clip
- Like ''hidden'', - this value indicates that - the box’s content is clipped to its padding box + This value indicates that + the box’s content is clipped to its [=overflow clip edge=] and that no scrolling user interface should be provided by the UA to view the content outside the clipping region. In addition, unlike ''overflow: hidden'' @@ -511,8 +510,11 @@ Expanding ''overflow:clip'' Bounds: the 'overflow-clip-margin' property the element is allowed to paint before being clipped. - Values are defined as follows: + The overflow clip edge initially coincides with the [=padding edge=], + but can be expanded outwards by 'overflow-clip-margin', + as defined below. + Values are defined as follows:
: <> :: @@ -520,10 +522,8 @@ Expanding ''overflow:clip'' Bounds: the 'overflow-clip-margin' property (or another property defined to respect this property), this property has no effect. - Otherwise, dictates how much the clipping shape is expanded - from its initial shape. - The clipping shape is expanded outward in all directions - by the specified <>, + Otherwise, the specified length dictates + how much the [=overflow clip edge=] is expanded from the [=padding edge=], in exactly the same way as a 'box-shadow' grows due to a positive spread distance (including the effect on rounded corners).