diff --git a/css-overflow-4/Overview.bs b/css-overflow-4/Overview.bs index 6dc3db0d26c..56013f5f97d 100644 --- a/css-overflow-4/Overview.bs +++ b/css-overflow-4/Overview.bs @@ -707,12 +707,15 @@ Indicating Block-Axis Overflow: the 'block-ellipsis' property This property allows inserting content into the last line box - before a (forced or unforced) region break - to indicate the continuity of truncated/interrupted content. + before a (forced or unforced) region break or a [=clamp point=] + to indicate the continuity of truncated / interrupted content. It only affects line boxes contained directly by the block container itself, but as it inherits, will have an effect on descendants’ line boxes unless overridden. - If the box contains no line box immediately preceding a region break, - then this property has no effect. + + This property only affects a line box if it immediately precedes + eiher a [=region break=] or a [=clamp point=] in the [=block formatting context=]. + If the [=clamp point=] is placed at the end of the [=line-clamp container=], then the line will + not be affected. Note: See [[css-overflow-4#fragmentation]] for a way to generate boxes with such a [=region break=]. @@ -777,10 +780,12 @@ Indicating Block-Axis Overflow: the 'block-ellipsis' property The [=block overflow ellipsis=] must not be included in either the ''::first-letter'' nor the ''::first-line'' pseudo-elements. - If there is a subsequent fragmentation container in the [=fragmentation context=] + If the [=block overflow ellipsis=] is placed before a [=region break=] and + there is a subsequent fragmentation container in the [=fragmentation context=] that would receive subsequent content, then the content displaced by the block overflow ellipsis - must be pushed to that fragmentation container. + must be pushed to that fragmentation container. If it is placed before a [=clamp point=], + then the displaced content must be pushed to the remainder of the [=inline formatting context=]. The UA must treat the block overflow ellipsis as an unbreakable string, If any part of the [=block overflow ellipsis=] overflows, @@ -844,7 +849,7 @@ Limiting Visible Lines: the 'line-clamp' shorthand property
Name: -webkit-line-clamp @@ -912,17 +917,17 @@ Legacy compatibility- This property only has an effect on boxes that are [=fragmentation containers=] that capture [=region breaks=]. + If the value of 'max-lines' is not none, then, where + N is the computed value of 'max-lines': + + - If the box is a [=fragmentation container=] that captures [=region breaks=], + a region break or + is forced after its Nth + descendant in-flow line box. + If fewer than N line boxes exist, + then 'max-lines' introduces no region break. + - If the box is a [=line-clamp container=], its [=clamp point=] is set after its Nth + descendant in-flow line box. + If fewer than N line boxes exist, then the clamp point is set to the end of the + line-clamp container. - Also, if the value of 'max-lines' is not none, - a region break - is forced after its Nth - descendant in-flow line box, - where N is the specified value of 'max-lines'. - Only lines boxes in the same Block Formatting Context + + Only line boxes in the same Block Formatting Context are counted: the contents of descendants that establish independent formatting contexts are skipped over while counting line boxes. - If fewer than N line boxes exist, - then 'max-lines' introduces no region break. - Note: This implies that 'max-lines' has no effect when applied to [=multi-column containers=], since any line box they contain are nested into [=independent formatting contexts=]. @@ -1004,7 +1014,7 @@ Fragmentation of Overflow: the 'continue' propertyName: continue - New Values: -webkit-discard + New Values: -webkit-collapseLike 'line-clamp', '-webkit-line-clamp' is a shorthand of 'max-lines', 'continue', and 'block-ellipsis', except that: * its syntax is ''line-clamp/none'' | <> - * it sets 'continue' to ''-webkit-discard'' instead of ''discard'' + * it sets 'continue' to ''-webkit-collapse'' instead of ''collapse'' * it unconditionally sets 'block-ellipsis' to ''block-ellipsis/auto'' - The -webkit-discard value behaves identically to ''discard'', + The -webkit-collapse value behaves identically to ''collapse'', except that it only takes effect if the [=specified value=] of the 'display' property is ''-webkit-box'' or ''-webkit-inline-box'' @@ -947,28 +952,33 @@ Forcing a Break After a Set Number of Lines: the 'max-lines' property Name: max-lines Value: ''none'' | < > Initial: ''none'' - Applies to: block containers which are also [=fragmentation containers=] that capture [=region breaks=] + Applies to: block containers which are also either [=fragmentation containers=] that capture [=region breaks=] or [=line-clamp containers=] Inherited: no Percentages: N/A Computed value: the keyword ''max-lines/none'' or an integer Animation type: by computed value type
Name: continue - Value: auto | discard + Value: auto | discard | collapse Initial: ''continue/auto'' Applies to: [=block containers=] and [=multicol containers=] Inherited: no @@ -1014,10 +1024,11 @@ Fragmentation of Overflow: the 'continue' propertyThe 'continue' property gives authors the ability - to turn a box into a [=fragmentation container=] (see [[!CSS-BREAK-3]]) - and to specify that content after the [=fragmentation break=] must be discarded. + to truncate/interrupt the content inside a box, by either visually hiding + the remaining content, or by turning the box into a [=fragmentation container=] (see [[!CSS-BREAK-3]]) + and discarding the content after the [=fragmentation break=]. - Issue: This property is meant to generalize and replace the
region-fragment
property from [[CSS-REGIONS-1]].
+ Issue: ''continue: discard'' is meant to generalize and replace the region-fragment
property from [[CSS-REGIONS-1]].
Once it is sufficiently stable in this specification,
region-fragment
should be removed from the regions specification in favor of this.
@@ -1048,6 +1059,15 @@ Fragmentation of Overflow: the 'continue' property
Breaks applying to other [=fragmentation contexts=]
(such as pagination of this box itself)
do not cause any content to be discarded.
+
+