Skip to content

Commit 2e0ab3c

Browse files
committed
[css-layout-api] Clarify some comments.
1 parent d911b36 commit 2e0ab3c

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

css-layout-api/Overview.bs

+12-6
Original file line numberDiff line numberDiff line change
@@ -1006,8 +1006,8 @@ and |internalLayoutConstraints|, it <em>must</em> run the following steps:
10061006

10071007
<pre class='idl'>
10081008
dictionary LayoutConstraintsOptions {
1009-
double availableInlineSize = 0;
1010-
double availableBlockSize = 0;
1009+
double availableInlineSize;
1010+
double availableBlockSize;
10111011

10121012
double fixedInlineSize;
10131013
double fixedBlockSize;
@@ -1034,18 +1034,26 @@ The example below shows the basic usage of the {{LayoutConstraintsOptions}} dict
10341034
registerLayout('child-layout-constraints-example', class {
10351035
async layout(children, edges, constraints, styleMap) {
10361036

1037-
// A web developer can
1037+
// The call below gives the child an "available" space. It will try and
1038+
// fit within this.
10381039
const fragment = children[0].layoutNextFragment({
10391040
availableInlineSize: 100,
10401041
availableBlockSize: 200,
10411042
});
10421043

1044+
// The call below gives the child a "fixed" size, it will be forced to
1045+
// this size ignoring any style set.
1046+
const fragment = children[0].layoutNextFragment({
1047+
fixedInlineSize: 20,
1048+
fixedBlockSize: 30,
1049+
});
1050+
10431051
}
10441052
});
10451053
</pre>
10461054
</div>
10471055

1048-
Issue: Finish up this section.
1056+
Issue: Specify how to convert to internal representation of these values.
10491057

10501058
Breaking and Fragmentation {#breaking-and-fragmentation}
10511059
--------------------------------------------------------
@@ -1153,8 +1161,6 @@ registerLayout('box-edges', class {
11531161
</pre>
11541162
</div>
11551163

1156-
Issue: Slim this down to just the "all" edges.
1157-
11581164
Interactions with other Modules {#interactions-with-other-modules}
11591165
==================================================================
11601166

0 commit comments

Comments
 (0)