contain-intrinsic-inline-size
The contain-intrinsic-inline-size
CSS logical property defines the inline-size of an element that a browser can use for layout when the element is subject to size containment.
Inline-size is the size of the element in the dimension parallel to the flow of text within a line. In a horizontal writing mode like standard English, inline size is the horizontal dimension (width); for a vertical writing mode, inline size is the vertical dimension.
Syntax
css
/* Keyword values */
contain-intrinsic-inline-size: none;
/* <length> values */
contain-intrinsic-inline-size: 1000px;
contain-intrinsic-inline-size: 10rem;
/* auto <length> */
contain-intrinsic-inline-size: auto 300px;
/* Global values */
contain-intrinsic-inline-size: inherit;
contain-intrinsic-inline-size: initial;
contain-intrinsic-inline-size: revert;
contain-intrinsic-inline-size: revert-layer;
contain-intrinsic-inline-size: unset;
Values
The following values can be specified for the intrinsic inline size of an element:
none
-
The element has no intrinsic inline-size.
<length>
-
The element has the specified inline-size (
<length>
). auto <length>
-
When the element is in size containment and skipping its contents (for example, when it is offscreen and
content-visibility: auto
is set) the inline size is remembered from the actual size of the element when it was last able to render its child elements. If the element has never rendered its child elements and hence has no remembered value for the normally rendered element size, or if it is not skipping its contents, the inline size is the specified<length>
.
Description
The property is commonly applied alongside elements that can trigger size containment, such as contain: size
and content-visibility
.
Size containment allows a user agent to lay out an element as though it had a fixed size, preventing unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
By default, size containment treats elements as though they had no contents, and may collapse the layout in the same way as if the contents had no width or height.
The contain-intrinsic-inline-size
property allows authors to specify an appropriate value to be used as the inline-size for layout.
The auto <length>
value allows the inline-size of the element to be stored if the element is ever "normally rendered" (with its child elements), and then used instead of the specified value when the element is skipping its contents.
This allows offscreen elements with content-visibility: auto
to benefit from size containment without developers having to be as precise in their estimates of element size.
The remembered value is not used if the child elements are being rendered (if size containment is enabled, the <length>
will be used).
Formal definition
Initial value | none |
---|---|
Applies to | elements for which size containment can apply |
Inherited | no |
Computed value | as specified, with <length>s values computed |
Animation type | by computed value type |
Formal syntax
Examples
Setting the intrinsic inline size
The HTML below defines an element "contained_element" that will be subject to size constraint, and which contains a child element.
html
<div id="contained_element">
<div class="child_element"></div>
</div>
The CSS below sets the content-visibility
of contained_element
to auto
, so if the element is hidden it will be size constrained.
The intrinsic block size and inline size that are used when it is size constrained are set at the same time using contain-intrinsic-block-size
and contain-intrinsic-inline-size
, respectively.
css
#contained_element {
border: 2px solid green;
inline-size: 151px;
content-visibility: auto;
contain-intrinsic-inline-size: 152px;
contain-intrinsic-block-size: 52px;
}
.child_element {
border: 1px solid red;
background: blue;
block-size: 50px;
inline-size: 150px;
}
Specifications
Specification |
---|
CSS Box Sizing Module Level 4 # propdef-contain-intrinsic-inline-size |
Browser compatibility
BCD tables only load in the browser