@@ -376,6 +376,118 @@ Containing Blocks of Positioned Boxes</h3>
376376</div>
377377
378378<!-- End section: Containing blocks -->
379+ <!-- End section: Choosing a positioning scheme: 'position' property -->
380+
381+ <h2 id="coords">
382+ Positioning Coordinates</h2>
383+
384+ The precise location of a [=positioned box=] is controlled by
385+ the <dfn>inset properties</dfn> :
386+ the [=physical=] [=inset properties=] 'top' , 'right' , 'bottom' , 'left' ;
387+ the [=flow-relative=] [=inset properties=] 'inset-block-start' , 'inset-inline-start' , 'inset-block-end' , and 'inset-inline-end' ;
388+ and their [=shorthands=] , 'inset-block' , 'inset-inline' , and 'inset' .
389+
390+ The interpretation of these specified coordinates varies by [=positioning scheme=] :
391+
392+ * for [=absolute positioning=] , the [=inset properties=] represent
393+ insets from the containing block.
394+ * for [=relative positioning=] , the [=inset properties=] represent
395+ insets from the box’s original margin edge.
396+ * for [=sticky positioning=] , the [=inset properties=] represent
397+ insets from the [=scrollport=] edge.
398+
399+ <h3 id="insets">
400+ Box Insets: the 'top', 'right', 'bottom', 'left', 'inset-block-start', 'inset-inline-start', 'inset-block-end', and 'inset-inline-end' properties </h3>
401+
402+ <pre class="propdef">
403+ Name : top, right, bottom, left, inset-block-start, inset-inline-start, inset-block-end, inset-inline-end
404+ Value : auto | <<length-percentage>>
405+ Initial : auto
406+ Applies to : positioned elements
407+ Inherited : no
408+ Percentages : refer to size of <a>containing block</a>; see prose
409+ Computed value : the keyword ''top/auto'' or a computed <<length-percentage>> value
410+ Animation type : by computed value type
411+ </pre>
412+
413+ These [=inset properties=] represent an inward “inset”
414+ on the corresponding side of the box
415+ (with respect to the box’s own [=writing mode=] ;
416+ see [[!CSS-WRITING-MODES-3#abstract-box]] ).
417+ For example, 'top' represents a downward inset of the top edge.
418+ The [=physical=] and [=flow-relative=] properties
419+ interact as defined in [[!CSS-LOGICAL-1]] .
420+ Values have the following meanings:
421+
422+ <dl dfn-for="top,right,bottom,left, inset-block-start,inset-inline-start,inset-block-end,inset-inline-end inset-block,inset-inline,inset" dfn-type="value">
423+ <dt> <dfn><length></dfn>
424+ <dd>
425+ The inset is a fixed distance from the reference edge.
426+ Negative values are allowed.
427+
428+ <dt> <dfn><percentage></dfn>
429+ <dd>
430+ The inset is a percentage
431+ relative to the <a>containing block</a> ’s size
432+ in the corresponding axis
433+ (e.g. width for 'left' or 'right' , height for 'top' and 'bottom' ).
434+ For [=sticky positioned=] boxes,
435+ the inset is instead
436+ relative to the relevant [=scrollport=] ’s size.
437+ Negative values are allowed.
438+
439+ <dt> <dfn>auto</dfn> </dt>
440+ <dd>
441+ Represents an unconstrained inset;
442+ the exact meaning depends on the [=positioning scheme=] .
443+ </dl>
444+
445+ Note: For [=fixed positioned=] elements,
446+ using large values or negative values
447+ can easily move elements outside the <a>viewport</a>
448+ and make the contents unreachable through scrolling or other means.
449+
450+ <h3 id="inset-shorthands">
451+ Box Insets Shorthands: the 'inset-block', 'inset-inline', and 'inset' properties</h3>
452+
453+ <pre class="propdef">
454+ Name : inset-block, inset-inline
455+ Value : <'top'>{1,2}
456+ Initial : auto
457+ Applies to : positioned elements
458+ Inherited : no
459+ Percentages : see individual properties
460+ Computed value : see individual properties
461+ Animation type : by computed value type
462+ </pre>
463+
464+ The 'inset-block' and 'inset-inline' properties are [=shorthand properties=]
465+ for setting 'inset-block-start' + 'inset-block-end'
466+ or 'inset-inline-start' + 'inset-inline-end' ,
467+ respectively,
468+ in a single declaration.
469+ The first component value sets the start side,
470+ the second sets the end;
471+ if omitted, the second value defaults to the first.
472+
473+ <pre class="propdef">
474+ Name : inset
475+ Value : <'top'>{1,4}
476+ Initial : auto
477+ Applies to : positioned elements
478+ Inherited : no
479+ Percentages : see individual properties
480+ Computed value : see individual properties
481+ Animation type : by computed value type
482+ </pre>
483+
484+ The 'inset' property is a [=shorthand property=]
485+ that sets all of the [=inset properties=]
486+ in a single declaration,
487+ assigning values to the longhands representing each side
488+ exactly as the 'margin' property does for its longhands.
489+
490+
379491
380492<h3 id="rel-pos">
381493Relative positioning</h3>
@@ -745,117 +857,6 @@ Fixed positioning</h3>
745857<!-- End section: Positioning schemes -->
746858
747859
748- <!-- End section: Choosing a positioning scheme: 'position' property -->
749-
750- <h2 id="coords">
751- Positioning Coordinates</h2>
752-
753- The precise location of a [=positioned box=] is controlled by
754- the <dfn>inset properties</dfn> :
755- the [=physical=] [=inset properties=] 'top' , 'right' , 'bottom' , 'left' ;
756- the [=flow-relative=] [=inset properties=] 'inset-block-start' , 'inset-inline-start' , 'inset-block-end' , and 'inset-inline-end' ;
757- and their [=shorthands=] , 'inset-block' , 'inset-inline' , and 'inset' .
758-
759- The interpretation of these specified coordinates varies by [=positioning scheme=] :
760-
761- * for [=absolute positioning=] , the [=inset properties=] represent
762- insets from the containing block.
763- * for [=relative positioning=] , the [=inset properties=] represent
764- insets from the box’s original margin edge.
765- * for [=sticky positioning=] , the [=inset properties=] represent
766- insets from the [=scrollport=] edge.
767-
768- <h3 id="insets">
769- Box Insets: the 'top', 'right', 'bottom', 'left', 'inset-block-start', 'inset-inline-start', 'inset-block-end', and 'inset-inline-end' properties </h3>
770-
771- <pre class="propdef">
772- Name : top, right, bottom, left, inset-block-start, inset-inline-start, inset-block-end, inset-inline-end
773- Value : auto | <<length-percentage>>
774- Initial : auto
775- Applies to : positioned elements
776- Inherited : no
777- Percentages : refer to size of <a>containing block</a>; see prose
778- Computed value : the keyword ''top/auto'' or a computed <<length-percentage>> value
779- Animation type : by computed value type
780- </pre>
781-
782- These [=inset properties=] represent an inward “inset”
783- on the corresponding side of the box
784- (with respect to the box’s own [=writing mode=] ;
785- see [[!CSS-WRITING-MODES-3#abstract-box]] ).
786- For example, 'top' represents a downward inset of the top edge.
787- The [=physical=] and [=flow-relative=] properties
788- interact as defined in [[!CSS-LOGICAL-1]] .
789- Values have the following meanings:
790-
791- <dl dfn-for="top,right,bottom,left, inset-block-start,inset-inline-start,inset-block-end,inset-inline-end inset-block,inset-inline,inset" dfn-type="value">
792- <dt> <dfn><length></dfn>
793- <dd>
794- The inset is a fixed distance from the reference edge.
795- Negative values are allowed.
796-
797- <dt> <dfn><percentage></dfn>
798- <dd>
799- The inset is a percentage
800- relative to the <a>containing block</a> ’s size
801- in the corresponding axis
802- (e.g. width for 'left' or 'right' , height for 'top' and 'bottom' ).
803- For [=sticky positioned=] boxes,
804- the inset is instead
805- relative to the relevant [=scrollport=] ’s size.
806- Negative values are allowed.
807-
808- <dt> <dfn>auto</dfn> </dt>
809- <dd>
810- Represents an unconstrained inset;
811- the exact meaning depends on the [=positioning scheme=] .
812- </dl>
813-
814- Note: For [=fixed positioned=] elements,
815- using large values or negative values
816- can easily move elements outside the <a>viewport</a>
817- and make the contents unreachable through scrolling or other means.
818-
819- <h3 id="inset-shorthands">
820- Box Insets Shorthands: the 'inset-block', 'inset-inline', and 'inset' properties</h3>
821-
822- <pre class="propdef">
823- Name : inset-block, inset-inline
824- Value : <'top'>{1,2}
825- Initial : auto
826- Applies to : positioned elements
827- Inherited : no
828- Percentages : see individual properties
829- Computed value : see individual properties
830- Animation type : by computed value type
831- </pre>
832-
833- The 'inset-block' and 'inset-inline' properties are [=shorthand properties=]
834- for setting 'inset-block-start' + 'inset-block-end'
835- or 'inset-inline-start' + 'inset-inline-end' ,
836- respectively,
837- in a single declaration.
838- The first component value sets the start side,
839- the second sets the end;
840- if omitted, the second value defaults to the first.
841-
842- <pre class="propdef">
843- Name : inset
844- Value : <'top'>{1,4}
845- Initial : auto
846- Applies to : positioned elements
847- Inherited : no
848- Percentages : see individual properties
849- Computed value : see individual properties
850- Animation type : by computed value type
851- </pre>
852-
853- The 'inset' property is a [=shorthand property=]
854- that sets all of the [=inset properties=]
855- in a single declaration,
856- assigning values to the longhands representing each side
857- exactly as the 'margin' property does for its longhands.
858-
859860<h2 id="size-and-position-details">
860861Sizing and positioning details</h2>
861862
0 commit comments