8000 [css-display] Rename box tree’s “text run” to “text sequence”. #7768 · w3c/csswg-drafts@e0f9cb9 · GitHub
Skip to content

Commit e0f9cb9

Browse files
fantasaifantasai
committed
[css-display] Rename box tree’s “text run” to “text sequence”. #7768 
1 parent 3dd5b4e commit e0f9cb9

10 files changed

Lines changed: 45 additions & 43 deletions

File tree

‎css-display-3/Overview.bs‎

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -94,8 +94,8 @@ Introduction</h2>
9494
Each <dfn id="box" oldids="css-box" export for=CSS>box</dfn> in the <a>box tree</a>
9595
represents its corresponding [=CSS/element=] (or <a>pseudo-element</a>)
9696
in space and/or time on the canvas,
97-
while each <dfn id="text-run" oldids="css-text-run" export for=CSS>text run</dfn> in the <a>box tree</a>
98-
likewise represents the contents of its corresponding <a>text nodes</a>.
97+
while each <dfn oldids="css-text-run,text-run" export for=CSS>text sequence</dfn> in the <a>box tree</a>
98+
likewise represents the corresponding contents of its <a>text nodes</a>.
9999

100100
To create the <a>box tree</a>,
101101
CSS first uses <a href="https://www.w3.org/TR/css-cascade/">cascading and inheritance</a>,
@@ -136,10 +136,10 @@ Introduction</h2>
136136
for each property,
137137
the value from the box to which that property was applied.
138138

139-
Similarly, each contiguous sequence of sibling <a>text nodes</a> generates a <a>text run</a>
139+
Similarly, each contiguous sequence of sibling <a>text nodes</a> generates a <a>text sequence</a>
140140
containing their text contents,
141141
which is assigned the same styles as the generating <a>text nodes</a>.
142-
If the sequence contains no text, however, it does not generate a <a>text run</a>.
142+
If the sequence contains no text, however, it does not generate a <a>text sequence</a>.
143143

144144
In constructing the box tree,
145145
boxes generated by an element are descendants of
@@ -168,8 +168,8 @@ Introduction</h2>
168168
<a href="https://www.w3.org/TR/css-cascade/#inheriting">inherit</a> through their <a>box tree</a> parentage.
169169

170170
In the course of layout,
171-
<a>boxes</a> and <a>text runs</a> can be broken into multiple <a>fragments</a>.
172-
This happens, for example, when an <a>inline box</a> and/or <a>text run</a>
171+
<a>boxes</a> and <a>text sequences</a> can be broken into multiple <a>fragments</a>.
172+
This happens, for example, when an <a>inline box</a> and/or <a>text sequence</a>
173173
is broken across lines,
174174
or when a <a>block box</a> is broken across pages or columns,
175175
in a process called <a>fragmentation</a>.
@@ -182,7 +182,7 @@ Introduction</h2>
182182
or <a href="https://www.w3.org/TR/css-multicol-1/#spanning-columns">column-spanner-in-block</a> splitting
183183
(see <a href="https://www.w3.org/TR/css-multicol-1/#spanning-columns">CSS Multi-column Layout</a>).
184184
A <a>box</a> therefore consists of one or more <a>box fragments</a>,
185-
and a <a>text run</a> consists of one or more <a lt=fragment>text fragments</a>.
185+
and a <a>text sequence</a> consists of one or more <a lt=fragment>text fragments</a>.
186186
See [[CSS-BREAK-3]] for more information on <a>fragmentation</a>.
187187

188188
Note: Many of the CSS specs were written before this terminology was ironed out,
@@ -252,7 +252,7 @@ Box Layout Modes: the 'display' property</h2>
252252
* the <dfn export local-lt="outer">outer display type</dfn>,
253253
which dictates how the [=principal box=] itself participates in <a>flow layout</a>.
254254

255-
<a>Text runs</a> have no <a>display type</a> 7292 .
255+
[=Text sequences=] have no [=display type=].
256256

257257
Some 'display' values have additional side-effects:
258258
such as ''list-item'', which also generates a ''::marker'' pseudo-element,
@@ -696,7 +696,7 @@ Box Generation: the ''display/none'' and ''display/contents'' keywords</h3>
696696
<dt><dfn>contents</dfn>
697697
<dd>
698698
The element itself does not generate any boxes,
699-
but its children and pseudo-elements still generate <a>boxes</a> and <a>text runs</a> as normal.
699+
but its children and pseudo-elements still generate <a>boxes</a> and <a>text sequences</a> as normal.
700700
For the purposes of box generation and layout,
701701
the element must be treated as if it had been replaced in the [=element tree=]
702702
by its contents
@@ -729,10 +729,10 @@ Box Generation: the ''display/none'' and ''display/contents'' keywords</h3>
729729

730730
<dt><dfn>none</dfn>
731731
<dd>
732-
The [=CSS/element=] and its descendants generate no <a>boxes</a> or <a>text runs</a>.
732+
The [=CSS/element=] and its descendants generate no <a>boxes</a> or <a>text sequences</a& 992E gt;.
733733

734734
Similarly, if a <a>text node</a> is defined to behave as ''display: none'',
735-
it generates no <a>text runs</a>.
735+
it generates no <a>text sequences</a>.
736736
</dl>
737737

738738
Elements with either of these values do not have <a>inner</a> or <a>outer display types</a>,
@@ -1416,7 +1416,7 @@ Appendix A: Glossary</h2>
14161416
<dt><dfn lt="inline-level|inline-level content">inline-level</dfn>
14171417
<dd>
14181418
Content that participates in inline layout.
1419-
Specifically, inline-level boxes and [=text runs=].
1419+
Specifically, inline-level boxes and [=text sequences=].
14201420

14211421
<dt><dfn lt="block-level|block-level content">block-level</dfn>
14221422
<dd>
@@ -1885,7 +1885,7 @@ Appendix C: Box Construction Guidelines for Spec Authors</h2>
18851885
and thus determines the type of its <a>principal box</a>.
18861886
* Boxes which <a>blockify</a> their contents
18871887
can't directly contain <a>inline-level</a> content;
1888-
any boxes or text runs generated within such an element
1888+
any boxes or text sequences generated within such an element
18891889
must be <a>blockified</a>
18901890
or wrapped in an <a>anonymous</a> <a>block container</a>.
18911891
* Boxes which <a>inlinify</a> their contents
@@ -1941,6 +1941,8 @@ Changes Since 2020 Candidate Recommendation</h3>
19411941
include:
19421942

19431943
<ul>
1944+
<li id="change-text-run-sequence">
1945+
Renamed “text run” to “[=text sequence=]”
19441946
<li id="change-root-layout">
19451947
Defined [=root element=] and clarified its layout as a [=block-level=]
19461948
in [[#root]] and the definition of [=initial containing block=].
@@ -2098,7 +2100,7 @@ Changes Prior to Candidate Recommendation Status</h3>
20982100

20992101
* Remove <css>inline-list-item</css> value that is equivalent to ''inline list-item''.
21002102
* Added the notion of “<a>text nodes</a>” to the <a>element tree</a>,
2101-
and “<a>text runs</a>” to the <a>box tree</a>
2103+
and “[=text sequence|text runs=]” to the <a>box tree</a>
21022104
to define behavior in the context of ''display: contents''.
21032105
(<a href="https://drafts.csswg.org/css-display-3/issues-wd-2017#issue-19">Issue 19</a>,
21042106
<a href="https://drafts.csswg.org/css-display-3/issues-wd-2017#issue-32">Issue 32</a>)

‎css-display-4/Overview.bs‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,8 @@ Introduction</h2>
8181
Each <dfn id="box" oldids="css-box" export for=CSS>box</dfn> in the <a>box tree</a>
8282
represents its corresponding [=CSS/element=] (or <a>pseudo-element</a>)
8383
in space and/or time on the canvas,
84-
while each <dfn id="text-run" oldids="css-text-run" export for=CSS>text run</dfn> in the <a>box tree</a>
85-
likewise represents the contents of its corresponding <a>text nodes</a>.
84+
while each <dfn oldids="css-text-sequence" export for=CSS>text sequence</dfn> in the <a>box tree</a>
85+
likewise represents the corresponding contents of its <a>text nodes</a>.
8686

8787
To create the <a>box tree</a>,
8888
CSS first uses <a href="https://www.w3.org/TR/css-cascade/">cascading and inheritance</a>,
@@ -123,10 +123,10 @@ Introduction</h2>
123123
for each property,
124124
the value from the box to which that property was applied.
125125

126-
Similarly, each contiguous sequence of sibling <a>text nodes</a> generates a <a>text run</a>
126+
Similarly, each contiguous sequence of sibling <a>text nodes</a> generates a <a>text sequence</a>
127127
containing their text contents,
128128
which is assigned the same styles as the generating <a>text nodes</a>.
129-
If the sequence contains no text, however, it does not generate a <a>text run</a>.
129+
If the sequence contains no text, however, it does not generate a <a>text sequence</a>.
130130

131131
In constructing the box tree,
132132
boxes generated by an element are descendants of
@@ -155,8 +155,8 @@ Introduction</h2>
155155
<a href="https://www.w3.org/TR/css-cascade/#inheriting">inherit</a> through their <a>box tree</a> parentage.
156156

157157
In the course of layout,
158-
<a>boxes</a> and <a>text runs</a> can be broken into multiple <a>fragments</a>.
159-
This happens, for example, when an <a>inline box</a> and/or <a>text run</a>
158+
<a>boxes</a> and <a>text sequences</a> can be broken into multiple <a>fragments</a>.
159+
This happens, for example, when an <a>inline box</a> and/or <a>text sequence</a>
160160
is broken across lines,
161161
or when a <a>block box</a> is broken across pages or columns,
162162
in a process called <a>fragmentation</a>.
@@ -169,7 +169,7 @@ Introduction</h2>
169169
or <a href="https://www.w3.org/TR/css-multicol-1/#spanning-columns">column-spanner-in-block</a> splitting
170170
(see <a href="https://www.w3.org/TR/css-multicol-1/#spanning-columns">CSS Multi-column Layout</a>).
171171
A <a>box</a> therefore consists of one or more <a>box fragments</a>,
172-
and a <a>text run</a> consists of one or more <a lt=fragment>text fragments</a>.
172+
and a <a>text sequence</a> consists of one or more <a lt=fragment>text fragments</a>.
173173
See [[CSS-BREAK-3]] for more information on <a>fragmentation</a>.
174174

175175
Note: Many of the CSS specs were written before this terminology was ironed out,
@@ -239,7 +239,7 @@ Box Layout Modes: the 'display' property</h2>
239239
* the <dfn export local-lt="outer">outer display type</dfn>,
240240
which dictates how the [=principal box=] itself participates in <a>flow layout</a>.
241241

242-
<a>Text runs</a> have no <a>display type</a>.
242+
[=Text sequences=] have no [=display type=].
243243

244244
Some 'display' values have additional side-effects:
245245
such as ''list-item'', which also generates a ''::marker'' pseudo-element,
@@ -683,7 +683,7 @@ Box Generation: the ''display/none'' and ''display/contents'' keywords</h3>
683683
<dt><dfn>contents</dfn>
684684
<dd>
685685
The element itself does not generate any boxes,
686-
but its children and pseudo-elements still generate <a>boxes</a> and <a>text runs</a> as normal.
686+
but its children and pseudo-elements still generate <a>boxes</a> and <a>text sequences</a> as normal.
687687
For the purposes of box generation and layout,
688688
the element must be treated as if it had been replaced in the [=element tree=]
689689
by its contents
@@ -716,10 +716,10 @@ Box Generation: the ''display/none'' and ''display/contents'' keywords</h3>
716716

717717
<dt><dfn>none</dfn>
718718
<dd>
719-
The [=CSS/element=] and its descendants generate no <a>boxes</a> or <a>text runs</a>.
719+
The [=CSS/element=] and its descendants generate no <a>boxes</a> or <a>text sequences</a>.
720720

721721
Similarly, if a <a>text node</a> is defined to behave as ''display: none'',
722-
it generates no <a>text runs</a>.
722+
it generates no <a>text sequences</a>.
723723
</dl>
724724

725725
Elements with either of these values do not have <a>inner</a> or <a>outer display types</a>,
@@ -1591,7 +1591,7 @@ Appendix A: Glossary</h2>
15911591
<dt><dfn lt="inline-level|inline-level content">inline-level</dfn>
15921592
<dd>
15931593
Content that participates in inline layout.
1594-
Specifically, inline-level boxes and [=text runs=].
1594+
Specifically, inline-level boxes and [=text sequences=].
15951595

15961596
<dt><dfn lt="block-level|block-level content">block-level</dfn>
15971597
<dd>
@@ -2060,7 +2060,7 @@ Appendix C: Box Construction Guidelines for Spec Authors</h2>
20602060
and thus determines the type of its <a>principal box</a>.
20612061
* Boxes which <a>blockify</a> their contents
20622062
can't directly contain <a>inline-level</a> content;
2063-
any boxes or text runs generated within such an element
2063+
any boxes or text sequences generated within such an element
20642064
must be <a>blockified</a>
20652065
or wrapped in an <a>anonymous</a> <a>block container</a>.
20662066
* Boxes which <a>inlinify</a> their contents

‎css-flexbox-1/Overview.bs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -613,9 +613,9 @@ Flex Items</h2>
613613

614614
Each in-flow child of a <a>flex container</a>
615615
becomes a <a>flex item</a>,
616-
and each contiguous sequence of child <a>text runs</a>
616+
and each contiguous sequence of child <a>text sequences</a>
617617
is wrapped in an <a>anonymous</a> <a>block container</a> <a>flex item</a>.
618-
However, if the entire sequence of child <a>text runs</a> contains only
618+
However, if the entire sequence of child <a>text sequences</a> contains only
619619
[=document white space characters=]
620620
(i.e. characters that can be affected by the 'white-space' property)
621621
it is instead not rendered (just as if its <a>text nodes</a> were ''display:none'').

‎css-grid-1/Overview.bs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1019,9 +1019,9 @@ Grid Items</h2>
10191019

10201020
Each in-flow child of a <a>grid container</a>
10211021
becomes a <a>grid item</a>,
1022-
and each contiguous sequence of child <a>text runs</a>
1022+
and each child <a>text sequence</a>
10231023
is wrapped in an <a>anonymous</a> <a>block container</a> <a>grid item</a>.
1024-
However, if the entire sequence of child <a>text runs</a> contains only
1024+
However, if the <a>text sequence</a> contains only
10251025
<a href="https://www.w3.org/TR/CSS2/text.html#white-space-prop">white space</a>
10261026
(i.e. characters that can be affected by the 'white-space' property)
10271027
it is instead not rendered (just as if its <a>text nodes</a> were ''display:none'').

‎css-grid-2/Overview.bs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1067,9 +1067,9 @@ Grid Items</h2>
10671067

10681068
Each in-flow child of a <a>grid container</a>
10691069
becomes a <a>grid item</a>,
1070-
and each contiguous sequence of child <a>text runs</a>
1070+
and each child <a>text sequence</a>
10711071
is wrapped in an <a>anonymous</a> <a>block container</a> <a>grid item</a>.
1072-
However, if the entire sequence of child <a>text runs</a> contains only
1072+
However, if the <a>text sequence</a> contains only
10731073
<a href="https://www.w3.org/TR/CSS2/text.html#white-space-prop">white space</a>
10741074
(i.e. characters that can be affected by the 'white-space' property)
10751075
it is instead not rendered (just as if its <a>text nodes</a> were ''display:none'').

‎css-inline-3/Overview.bs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ Inline Layout Model</h2>
9393

9494
Any [=block container=] that directly contains
9595
[=inline-level=] content--
96-
such as [=inline boxes=], [=atomic inlines=], and [=text runs=]--
96+
such as [=inline boxes=], [=atomic inlines=], and [=text sequences=]--
9797
establishes an [=inline formatting context=]
9898
to lay out its contents using [=inline layout=].
9999
The [=block container=]’s [=content edges=] form the [=containing block=]

‎css-lists-3/Overview.bs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -290,12 +290,12 @@ Generating Marker Contents</h3>
290290
The <a>marker box</a> contains
291291
an <a>anonymous</a> <a>inline</a> <a>replaced element</a>
292292
representing the specified [=marker image=],
293-
followed by a <a>text run</a> consisting of a single space (U+0020 SPACE).
293+
followed by a <a>text sequence</a> consisting of a single space (U+0020 SPACE).
294294

295295
<dt>'list-style-type' on the [=originating element=] defines a [=marker string=]
296296
<dd>
297297
The <a>marker box</a> contains
298-
a [=text run=] consisting of the specified [=marker string=].
298+
a [=text sequence=] consisting of the specified [=marker string=].
299299

300300
<dt>otherwise
301301
<dd>

‎css-ruby-1/Overview.bs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -148,10 +148,10 @@ Diagram conventions</h3>
148148
<dl>
149149
<dt><img alt="Symbolic wide-cell glyph representation" width="39" height="39" src="images/fullwidth.gif">
150150
<dd>
151-
Wide-cell glyph (e.g. Han) that is the <var>n</var>th character in the text run.
151+
Wide-cell glyph (e.g. Han) that is the <var>n</var>th character in the text sequence.
152152
They are typically sized to 50% when used as annotations.
153153
<dt><img alt="Symbolic narrow-cell glyph representation" width="19" height="39" src="images/halfwidth.gif">
154-
<dd>Narrow-cell glyph (e.g. Roman) which is the <var>n</var>th glyph in the text run.
154+
<dd>Narrow-cell glyph (e.g. Roman) which is the <var>n</var>th glyph in the text sequence.
155155
</dl>
156156

157157
The orientation which the above symbols assume in the diagrams

‎css-sizing-3/Overview.bs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1002,7 +1002,7 @@ are defined below:
10021002
(the <l spec=html>[=raw value=]</l> in the case of <{textarea}>,
10031003
or the <a href="https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#concept-fe-value">value</a> in the case of <{input}>),
10041004
possibly transformed to a more human-readable and/or localized display format,
1005-
which is then treated as child <a>text runs</a> of the input control,
1005+
which is then treated as child <a>text sequences</a> of the input control,
10061006
allowing <a>soft wrap opportunities</a>
10071007
only where the input control would actually allow wrapping
10081008
(whether keyed off of CSS properties or other, UA-internal constraints).

‎css-text-4/Overview.bs‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1174,7 +1174,7 @@ Detecting Word Boundaries: the 'word-boundary-detection' property</h4>
11741174
Otherwise,
11751175
the user agent must insert a [=virtual word boundary=]
11761176
at each detected word boundary
1177-
within the [=text run=] children of this element.
1177+
within the [=text sequence=] children of this element.
11781178
Within the constraints set by this specification,
11791179
the specific algorithm used is UA-dependent.
11801180

@@ -1448,7 +1448,7 @@ Making Word Boundaries Visible: the 'word-boundary-expansion' property</h4>
14481448
<dt><dfn>space</dfn>
14491449
<dd>
14501450
Instances of U+200B ZERO WIDTH SPACE
1451-
within the [=text run=] children of this element
1451+
within the child [=text sequence|text=] of this element
14521452
are replaced by U+0020 SPACE.
14531453

14541454
<wpt>
@@ -1466,7 +1466,7 @@ Making Word Boundaries Visible: the 'word-boundary-expansion' property</h4>
14661466
<dt><dfn>ideographic-space</dfn>
14671467
<dd>
14681468
Instances of U+200B ZERO WIDTH SPACE
1469-
within the [=text run=] children of this element
1469+
within the child [=text sequence|text=] of this element
14701470
are replaced by U+3000 IDEOGRAPHIC SPACE.
14711471

14721472
<wpt>
@@ -7959,7 +7959,7 @@ Line Start/End Padding: the 'line-padding' property</h3>
79597959
at the start/end of the line box,
79607960
and is inserted between that <a>inline box</a>’s content edge
79617961
and the adjacent <a>inline-level</a> content
7962-
(text run <em>or</em> <a>atomic inline</a>).
7962+
([=text sequence|text=] <em>or</em> <a>atomic inline</a>).
79637963
This extra space is not a <a>justification opportunity</a>.
79647964

79657965
<div class="example">

0 commit comments

Comments
 (0)
1261