Skip to content

Commit 6516a86

Browse files
committed
[css-position-3] Fix computed value lines, add animation type, update offset-* to inset-*
1 parent a7856ae commit 6516a86

1 file changed

Lines changed: 46 additions & 38 deletions

File tree

css-position-3/Overview.bs

Lines changed: 46 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -733,7 +733,8 @@ Choosing a positioning scheme: 'position' property</h3>
733733
Inherited: no
734734
Animatable: no
735735
Percentages: N/A
736-
Computed value: specified value
736+
Computed value: specified keyword
737+
Animation type: discrete
737738
</pre>
738739

739740
The values of this property have the following meanings:
@@ -843,7 +844,8 @@ Box offsets: 'top', 'right', 'bottom', 'left'</h3>
843844
Inherited: no
844845
Animation type: length or percentage
845846
Percentages: refer to height of <a>containing block</a>
846-
Computed value: For 'position': ''relative'', see Relative positioning.<br/> For 'position': ''sticky'', see Sticky positioning.<br/> For 'position': ''static'', ''top/auto''.<br/> Otherwise: if specified as a '&lt;length>', the corresponding absolute length; if specified as a '&lt;percentage>', the specified value; otherwise, ''top/auto''.
847+
Computed value: the keyword ''top/auto'' or an absolute length and/or percentage expression
848+
Animation type: by computed value
847849
</pre>
848850

849851
This property specifies how far an absolutely positioned box’s top margin
@@ -868,7 +870,8 @@ Box offsets: 'top', 'right', 'bottom', 'left'</h3>
868870
Inherited: no
869871
Animation type: length or percentage
870872
Percentages: refer to height of <a>containing block</a>
871-
Computed value: For 'position': ''relative'', see Relative positioning.<br/> For 'position': ''sticky'', see Sticky positioning.<br/> For 'position': ''static'', ''right/auto''.<br/> Otherwise: if specified as a '&lt;length>', the corresponding absolute length; if specified as a '&lt;percentage>', the specified value; otherwise, ''right/auto''.
873+
Computed value: the keyword ''right/auto'' or an absolute length and/or percentage expression
874+
Animation type: by computed value
872875
</pre>
873876

874877
Similar to 'top', but specifies how far a box’s right margin edge is offset
@@ -893,7 +896,8 @@ Box offsets: 'top', 'right', 'bottom', 'left'</h3>
893896
Inherited: no
894897
Animation type: length or percentage
895898
Percentages: refer to height of <a>containing block</a>
896-
Computed value: For 'position': ''relative'', see Relative positioning.<br/> For 'position': ''sticky'', see Sticky positioning.<br/> For 'position': ''static'', ''bottom/auto''.<br/> Otherwise: if specified as a '&lt;length>', the corresponding absolute length; if specified as a '&lt;percentage>', the specified value; otherwise, ''bottom/auto''.
899+
Computed value: the keyword ''bottom/auto'' or an absolute length and/or percentage expression
900+
Animation type: by computed value
897901
</pre>
898902

899903
Similar to 'top', but specifies how far a box’s bottom margin edge is offset
@@ -918,7 +922,8 @@ Box offsets: 'top', 'right', 'bottom', 'left'</h3>
918922
Inherited: no
919923
Animation type: length or percentage
920924
Percentages: refer to height of <a>containing block</a>
921-
Computed value: For 'position': ''relative'', see Relative positioning.<br/> For 'position': ''sticky'', see Sticky positioning.<br/> For 'position': ''static'', ''left/auto''. Otherwise: if specified as a '&lt;length>', the corresponding absolute length; if specified as a '&lt;percentage>', the specified value; otherwise, ''left/auto''.
925+
Computed value: the keyword ''left/auto'' or an absolute length and/or percentage expression
926+
Animation type: by computed value
922927
</pre>
923928

924929
Similar to 'top', but specifies how far a box’s left margin edge is offset
@@ -971,11 +976,11 @@ Box offsets: 'top', 'right', 'bottom', 'left'</h3>
971976
<!-- End section: Box offsets: 'top', 'right', 'bottom', 'left' -->
972977

973978
<h3 id="logical-box-offsets-beaso">
974-
Logical box offsets: 'offset-before', 'offset-end', 'offset-after' and 'offset-start'</h3>
979+
Logical box insets: 'inset-before', 'inset-end', 'inset-after' and 'inset-start'</h3>
975980

976981
Issue: See [[!CSS-LOGICAL-1]]; this section is not up-to-date.
977982

978-
Logical offset properties allow for offsetting positioned boxes based on the
983+
Logical offset properties allow for insetting positioned boxes based on the
979984
'writing-mode' and 'direction' properties. When both the physical property and
980985
equivalent logical property (based on 'writing-mode' and 'direction') are
981986
specified the physical property computes to the computed value of the corresponding
@@ -986,14 +991,15 @@ Logical box offsets: 'offset-before', 'offset-end', 'offset-after' and 'offset-s
986991
and 'direction' of the <a>containing block</a>:
987992

988993
<pre class="propdef">
989-
Name: offset-before, offset-after, offset-start, offset-end
994+
Name: inset-before, inset-after, inset-start, inset-end
990995
Value: auto | <<length-percentage>>
991996
Initial: auto
992997
Applies to: positioned elements
993998
Inherited: no
994999
Animation type: length or percentage
9951000
Percentages: refer to height of <a>containing block</a>
996-
Computed value: For ''position: relative'', see Relative positioning.<br/> For ''position: sticky'', see Sticky positioning.<br/> For ''position: static'', ''top/auto''.<br/> Otherwise: if specified as a <<length>>, the corresponding absolute length; if specified as a <<percentage>>, the specified value; otherwise, ''top/auto''.
1001+
Computed value: the keyword ''inset-before/auto'' or an absolute length and/or percentage expression
1002+
Animation type: by computed value
9971003
</pre>
9981004

9991005
For an absolutely positioned box this property specifies how far the corresponding
@@ -1029,59 +1035,59 @@ Logical box offsets: 'offset-before', 'offset-end', 'offset-after' and 'offset-s
10291035
<tr>
10301036
<td rowspan="4"><div>Edge</div></td>
10311037
<td>top</td>
1032-
<td>offset-before</td>
1033-
<td>offset-before</td>
1034-
<td>offset-start</td>
1035-
<td>offset-end</td>
1036-
<td>offset-start</td>
1037-
<td>offset-end</td>
1038+
<td>inset-before</td>
1039+
<td>inset-before</td>
1040+
<td>inset-start</td>
1041+
<td>inset-end</td>
1042+
<td>inset-start</td>
1043+
<td>inset-end</td>
10381044
</tr>
10391045
<tr>
10401046
<td>right</td>
1041-
<td>offset-end</td>
1042-
<td>offset-start</td>
1043-
<td>offset-before</td>
1044-
<td>offset-before</td>
1045-
<td>offset-after</td>
1046-
<td>offset-after</td>
1047+
<td>inset-end</td>
1048+
<td>inset-start</td>
1049+
<td>inset-before</td>
1050+
<td>inset-before</td>
1051+
<td>inset-after</td>
1052+
<td>inset-after</td>
10471053
</tr>
10481054
<tr>
10491055
<td>bottom</td>
1050-
<td>offset-after</td>
1051-
<td>offset-after</td>
1052-
<td>offset-end</td>
1053-
<td>offset-start</td>
1054-
<td>offset-end</td>
1055-
<td>offset-start</td>
1056+
<td>inset-after</td>
1057+
<td>inset-after</td>
1058+
<td>inset-end</td>
1059+
<td>inset-start</td>
1060+
<td>inset-end</td>
1061+
<td>inset-start</td>
10561062
</tr>
10571063
<tr>
10581064
<td>left</td>
1059-
<td>offset-start</td>
1060-
<td>offset-end</td>
1061-
<td>offset-after</td>
1062-
<td>offset-after</td>
1063-
<td>offset-before</td>
1064-
<td>offset-before</td>
1065+
<td>inset-start</td>
1066+
<td>inset-end</td>
1067+
<td>inset-after</td>
1068+
<td>inset-after</td>
1069+
<td>inset-before</td>
1070+
<td>inset-before</td>
10651071
</tr>
10661072
</tbody>
10671073
</table>
10681074
<p class="caption">
1069-
Relationship of physical offset edges and the logical properties per
1075+
Relationship of physical inset edges and the logical properties per
10701076
'writing-mode' and 'direction'.
10711077
</p>
10721078
</div>
10731079

10741080
<p class="issue">The logical property definitions should move to the Logical Properties module.</p>
10751081

1076-
For relatively positioned boxes, the offset is with respect to the property’s
1082+
For relatively positioned boxes, the inset is with respect to the property’s
10771083
corresponding physical reference edge of the box itself (i.e., the box is given a
10781084
position in the <a>normal flow</a>, and then offset from that position according
10791085
to the property).
10801086

10811087
<p class="issue">This needs to be defined for sticky positioning.</p>
10821088

10831089
For absolutely positioned elements whose <a>containing block</a>
1084-
is based on a block-level element, this property is an offset from the corresponding
1090+
is based on a block-level element, this property is an inset from the corresponding
10851091
padding edge of that element.
10861092

10871093
<p class="note">
@@ -1111,6 +1117,7 @@ Inherited: no
11111117
Animatable: no
11121118
Percentages: n/a
11131119
Computed value: specified value, but see prose
1120+
Animation type: discrete
11141121
</pre>
11151122

11161123
The values of this property have the following meanings:
@@ -1502,7 +1509,7 @@ Auto heights for block formatting context roots</h3>
15021509
the bottommost block-level child box.
15031510

15041511
Absolutely positioned children are ignored, and relatively positioned boxes are
1505-
considered without their offset. Note that the child box may be an <a href="https://www.w3.org/TR/CSS2/visuren.html#anonymous-block-level">anonymous block box</a>.
1512+
considered without their inset. Note that the child box may be an <a href="https://www.w3.org/TR/CSS2/visuren.html#anonymous-block-level">anonymous block box</a>.
15061513

15071514
In addition, if the element has any floating descendants whose bottom margin edge
15081515
is below the element’s bottom content edge, then the height is increased to
@@ -1941,7 +1948,8 @@ Layered presentation</h2>
19411948
Inherited: no
19421949
Animatable: &lt;integer>
19431950
Percentages: N/A
1944-
Computed value: as specified
1951+
Computed value: the keyword ''z-index/auto'' or an integer
1952+
Animation type: per computed value
19451953
</pre>
19461954

19471955
For a positioned box, the 'z-index' property specifies:

0 commit comments

Comments
 (0)