Skip to content

Commit 2a2356d

Browse files
committed
[css-contain] Terminology clean up: **establish** a formatting context
Closes w3c#1457
1 parent 656d63d commit 2a2356d

File tree

3 files changed

+12
-22
lines changed

3 files changed

+12
-22
lines changed

css-contain-1/Overview.bs

Lines changed: 7 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Previous Version: https://www.w3.org/TR/2017/WD-css-contain-1-20170221/
1212
Editor: Tab Atkins, Google, http://xanthir.com/contact/, w3cid 42199
1313
Editor: Florian Rivoal, On behalf of Bloomberg, https://florian.rivoal.net/, w3cid 43241
1414
Abstract: This CSS module describes the 'contain' property, which indicates that the element's subtree is independent of the rest of the page. This enables heavy optimizations by user agents when used well.
15-
Ignored Terms: scrollWidth, scrollHeight, clientWidth, clientHeight, formatting context
15+
Ignored Terms: scrollWidth, scrollHeight, clientWidth, clientHeight
1616
Link Defaults: css-lists-3 (property) counter-increment
1717
</pre>
1818
<pre class="anchors">
@@ -213,10 +213,11 @@ Layout Containment</h3>
213213
If the element does not generate a <a>principal box</a> (as is the case with ''display: contents'' or ''display: none''),
214214
or if the element is an <a spec="css-display-3">internal table element</a> other than ''display: table-cell'',
215215
or if the element is an <a spec="css-display-3">internal ruby element</a>,
216+
or if the element's <a>principal box</a> is a <a spec="css-display-3" lt="atomic inline">non-atomic</a> <a spec="css-display-3">inline-level</a> box,
216217
layout containment has no effect.
217218
Otherwise, giving an element <dfn export>layout containment</dfn> has the following effects:
218219

219-
1. The element <a>becomes a formatting context root</a>.
220+
1. The element <a>establishes a formatting context</a>.
220221

221222
2. If a <a>fragmentation context</a> participates in <a>layout containment</a>,
222223
the first element with <a>layout containment</a>
@@ -338,6 +339,7 @@ Paint Containment</h3>
338339
If the element does not generate a <a>principal box</a> (as is the case with ''display: contents'' or ''display: none''),
339340
or if the element is an <a spec="css-display-3">internal table element</a> other than ''display: table-cell'',
340341
or if the element is an <a spec="css-display-3">internal ruby element</a>,
342+
or if the element's <a>principal box</a> is a <a spec="css-display-3" lt="atomic inline">non-atomic</a> <a spec="css-display-3">inline-level</a> box,
341343
paint containment has no effect.
342344
Otherwise, giving an element <dfn export>paint containment</dfn> has the following effects:
343345

@@ -352,7 +354,7 @@ Paint Containment</h3>
352354
<span class=note>This is as if to ''overflow: visible'' was changed to ''overflow: clip'' at used value.</span>
353355
2. The element acts as a containing block for absolutely positioned and fixed positioned descendants.
354356
3. The element creates a <a>stacking context</a>.
355-
4. The element <a>becomes a formatting context root</a>.
357+
4. The element <a>establishes a formatting context</a>.
356358

357359
Possible optimizations that can be enabled by <a>paint containment</a> include (but are not limited to):
358360

@@ -372,19 +374,6 @@ Paint Containment</h3>
372374
3. Because they are guaranteed to be stacking contexts,
373375
scrolling elements can be painted into a single GPU layer.
374376

375-
<h2 id="becoming-formatting-context">Becoming a formatting context root</h2>
376-
377-
In some some types of containment,
378-
a box may need to <dfn export lt='become a formatting context root|becomes a formatting context root|becoming a formatting context root'>become a <a>formatting context</a> root</dfn>.
379-
If the box already establishes a <a>formatting context</a> of any kind other than an <a>inline formatting context</a>,
380-
this condition is satisfied.
381-
Otherwise, it is made to establish a <a>BFC</a> by changing its <a>inner display type</a> to ''flow-root''.
382-
This change happens at <a>used value</a> time,
383-
and does not affect the <a>computed value</a> of the 'display' property.
384-
385-
Issue: What should we do about boxes that establish <a>ruby formatting contexts</a>?
386-
See some discussion here: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-319996309
387-
388377

389378
Privacy and Security Considerations {#privsec}
390379
==============================================
@@ -461,20 +450,19 @@ This appendix is <em>informative</em>.
461450
<a href="https://www.w3.org/TR/2017/CR-css-contain-1-20170808/">Candidate Recommendation of 8 August 2017</a></h3>
462451

463452
<ul>
464-
<li>Move the definition of "Becoming a formatting context" back to this specification
465-
<li>Rename "Becoming a formatting context" to "Becoming a formatting context root".
466453
<li>Clarify to which box paint containment clips.
467454
<li>Move the interaction between containment and the <code>bookmark-*</code> and <code>string-set</code> properties to [[CSS-CONTENT-3]]
468455
<li>Remove the effects of style containment on the "break-*" properties.
469456
<li>Move the description of the effects of containement on regions from this specification to [[CSS-REGIONS-1]].
470457
<li>Clarify the effects of style scoping on counter-set and counter-increment
471458
<li>Size layout and paint containment don't apply to internal ruby elements
472-
<li>Size containment does not apply to non-atomic inlines
459+
<li>Layout, Paint, and size containments do not apply to non-atomic inlines
473460
<li>Align paint containment's behavior with overflow:clip
474461
<li>Elements with size containment are monolithic
475462
<li>Forced breaks area allowed in elements with layout containments, but do not propagate
476463
<li>Clarify the effects of scoping to a subtree
477464
<li>Clarify the effects of scoping on counters
465+
<li>Editorial clarification: replace "Becoming a formatting context" (aka "Becoming a formatting context root") with "Establish a FC"
478466
</ul>
479467

480468
<h3 id="2017-04-19-changes">Changes from the

css-contain-1/issues-2017-cr.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ <h1>CSS Contain Level 1 Disposition of Comments for 2017-02-21 WD</h1>
3131
<p>An issue can be closed as <code>Accepted</code>, <code>OutOfScope</code>,
3232
<code>Invalid</code>, <code>Rejected</code>, or <code>Retracted</code>.
3333
<code>Verified</code> indicates commentor's acceptance of the response.</p>
34-
<pre class=' open' id='issue-1'>
34+
<pre class='a' id='issue-1'>
3535
Issue 1. <a href='#issue-1'>#</a>
3636
Summary: Definition of Becoming a Formating Context needs work
3737
From: Oriol Brufau
@@ -45,7 +45,8 @@ <h1>CSS Contain Level 1 Disposition of Comments for 2017-02-21 WD</h1>
4545
Comment: <a href='https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-374818996'>https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-374818996</a>
4646
Comment: <a href='https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-375105710'>https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-375105710</a>
4747
Comment: <a href='https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-379156461'>https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-379156461</a>
48-
Open</pre>
48+
Closed: Accepted
49+
Resolved: <a href='https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-380357179'>https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-380357179</a></pre>
4950
<pre class='a' id='issue-2'>
5051
Issue 2. <a href='#issue-2'>#</a>
5152
Summary: Rename Becoming a Formating Context

css-contain-1/issues-2017-cr.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@ Comment: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-320523481
1515
Comment: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-374818996
1616
Comment: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-375105710
1717
Comment: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-379156461
18-
Open
18+
Closed: Accepted
19+
Resolved: https://github.com/w3c/csswg-drafts/issues/1457#issuecomment-380357179
1920
----
2021
Issue 2.
2122
Summary: Rename Becoming a Formating Context

0 commit comments

Comments
 (0)