Skip to content

Commit 73f8ffc

Browse files
committed
[css-display] Add 'principal box' and 'replaced element' to the glossary.
1 parent 82d19df commit 73f8ffc

1 file changed

Lines changed: 38 additions & 1 deletion

File tree

css-display/Overview.bs

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -738,12 +738,27 @@ Run-In Layout</h2>
738738

739739
Note: This run-in model is slightly different from the one proposed in earlier revisions of [[!CSS2]].
740740

741-
<h2 id='glossary'>
741+
<h2 id='glossary' class=no-num>
742742
Appendix A: Glossary</h2>
743743

744744
The following terms are defined here for convenience:
745745

746746
<dl export>
747+
<dt><dfn>principal box</dfn>
748+
<dd>
749+
When an [=element=] generates one or more [=boxes=],
750+
one of them is the [=principal box=],
751+
which contains its descendant boxes and generated content,
752+
and is also the box involved in any positioning scheme.
753+
754+
Some elements may generate additional boxes in addition to the principal box
755+
(such as ''display/list-item'' elements,
756+
which generate an additional marker box,
757+
or ''display/table'' elements,
758+
which generate a [=principal box|principal=] [=table wrapper box=]
759+
and an additional [=table box=].
760+
These additional boxes are placed with respect to the principal box.
761+
747762
<dt><dfn lt="inline-level|inline-level content">inline-level</dfn>
748763
<dd>
749764
Content that participates in inline layout.
@@ -781,6 +796,28 @@ Appendix A: Glossary</h2>
781796
Used as a shorthand for <a>block box</a>, <a>block-level box</a>, or <a>block container box</a>,
782797
where unambiguous.
783798

799+
<dt><dfn>replaced element</dfn>
800+
<dd>
801+
An element whose content is outside the scope of the CSS formatting model,
802+
such as an image, embedded document, or applet.
803+
<span class=non-normative>
804+
For example, the content of the HTML <{img}> element
805+
is often replaced by the image that its <{img/src}> attribute designates.
806+
</span>
807+
Replaced elements often have intrinsic dimensions:
808+
an intrinsic width, an intrinsic height, and an intrinsic ratio.
809+
For example, a bitmap image has an intrinsic width and an intrinsic height specified in absolute units
810+
(from which the intrinsic ratio can obviously be determined).
811+
On the other hand, other documents may not have any intrinsic dimensions
812+
(for example, a blank HTML document).
813+
814+
User agents may consider a replaced element to not have any intrinsic dimensions
815+
if it is believed that those dimensions could leak sensitive information to a third party.
816+
For example, if an HTML document changed intrinsic size depending on the user's bank balance,
817+
then the UA might want to act as if that resource had no intrinsic dimensions.
818+
819+
The content of replaced elements is not considered in the CSS rendering model.
820+
784821
<dt><dfn>containing block</dfn>
785822
<dd>
786823
A rectangle that forms the basis of sizing and positioning

0 commit comments

Comments
 (0)