@webref/css 5.4.4 → 6.1.0

package/css-layout-api.json

@@ -0,0 +1,20 @@
+{
+  "spec": {
+    "title": "CSS Layout API Level 1",
+    "url": "https://drafts.css-houdini.org/css-layout-api-1/"
+  },
+  "properties": [],
+  "atrules": [],
+  "selectors": [],
+  "values": [],
+  "warnings": [
+    {
+      "msg": "Dangling value",
+      "name": "layout()",
+      "prose": "This value causes an element to generate a layout API container box.",
+      "type": "value",
+      "value": "layout()",
+      "for": "display"
+    }
+  ]
+}

package/css-line-grid.json

@@ -3,8 +3,8 @@
     "title": "CSS Line Grid Module Level 1",
     "url": "https://drafts.csswg.org/css-line-grid-1/"
   },
-  "properties": {
-    "line-grid": {
+  "properties": [
+    {
       "name": "line-grid",
       "value": "match-parent | create",
       "initial": "match-parent",
@@ -14,12 +14,26 @@
       "computedValue": "specified keyword",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "match-parent",
+          "prose": "Box assumes the line grid of its parent if its writing mode is the same as its parent. If the box has a writing mode that is different than its parent, then the box creates a new line grid as create below.",
+          "type": "value",
+          "value": "match-parent"
+        },
+        {
+          "name": "create",
+          "prose": "Box creates a new line grid using its own font and line layout settings, including any adjustment to the line height caused by the line-height-step property. The line grid consists of a series of horizontal lines corresponding to all the baselines (alphabetic, text-top, text-bottom, mathematic, central, hanging, etc.) and to the line-over and line-under edges, positioned where they would fall if the contents of this element consisted entirely of line boxes filled with text (no sub-elements) using the first available font. If the box is paginated, the line grid is restarted on each page; since line boxes cannot be fragmented, no page begins with the bottom part of a line’s grid.",
+          "type": "value",
+          "value": "create"
+        }
+      ],
       "styleDeclaration": [
         "line-grid",
         "lineGrid"
       ]
     },
-    "line-snap": {
+    {
       "name": "line-snap",
       "value": "none | baseline | contain",
       "initial": "none",
@@ -29,12 +43,32 @@
       "computedValue": "specified keyword",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "none",
+          "prose": "Line boxes do not snap to the grid; they stack normally.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "baseline",
+          "prose": "The dominant baseline snaps with the matching baseline on the line grid applying to the element.",
+          "type": "value",
+          "value": "baseline"
+        },
+        {
+          "name": "contain",
+          "prose": "Two baselines are used to align the line box: the line box is snapped so that its central baseline is centered between one of the line grid’s text-over-edge baselines and a subsequent (but not necessarily consecutive) text-under-edge baseline.",
+          "type": "value",
+          "value": "contain"
+        }
+      ],
       "styleDeclaration": [
         "line-snap",
         "lineSnap"
       ]
     },
-    "box-snap": {
+    {
       "name": "box-snap",
       "value": "none | block-start | block-end | center | baseline | last-baseline",
       "initial": "none",
@@ -44,12 +78,51 @@
       "computedValue": "as specified",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "none",
+          "prose": "The block is not snapped to any grid.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "block-start",
+          "prose": "The block-start edge is snapped to the nearest grid line.",
+          "type": "value",
+          "value": "block-start"
+        },
+        {
+          "name": "block-end",
+          "prose": "The block-end edge is snapped to the nearest grid line.",
+          "type": "value",
+          "value": "block-end"
+        },
+        {
+          "name": "center",
+          "prose": "The block is centered between one of the baseline grid’s text-over baselines and a subsequent (but not necessarily consecutive) text-under baseline.",
+          "type": "value",
+          "value": "center"
+        },
+        {
+          "name": "baseline",
+          "prose": "The first line box’s dominant baseline is snapped to the nearest grid line.",
+          "type": "value",
+          "value": "baseline"
+        },
+        {
+          "name": "last-baseline",
+          "prose": "The last line box’s dominant baseline is snapped to the nearest grid line.",
+          "type": "value",
+          "value": "last-baseline"
+        }
+      ],
       "styleDeclaration": [
         "box-snap",
         "boxSnap"
       ]
     }
-  },
-  "atrules": {},
-  "valuespaces": {}
+  ],
+  "atrules": [],
+  "selectors": [],
+  "values": []
 }

package/css-lists.json

@@ -3,8 +3,8 @@
     "title": "CSS Lists and Counters Module Level 3",
     "url": "https://drafts.csswg.org/css-lists-3/"
   },
-  "properties": {
-    "list-style-image": {
+  "properties": [
+    {
       "name": "list-style-image",
       "value": "<image> | none",
       "initial": "none",
@@ -14,12 +14,26 @@
       "computedValue": "the keyword noneor the computed <image>",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "<image>",
+          "prose": "If the <image> represents a valid image, specifies the element’s marker image as the <image>. Otherwise, the element has no marker image.",
+          "type": "value",
+          "value": "<image>"
+        },
+        {
+          "name": "none",
+          "prose": "The element has no marker image.",
+          "type": "value",
+          "value": "none"
+        }
+      ],
       "styleDeclaration": [
         "list-style-image",
         "listStyleImage"
       ]
     },
-    "list-style-type": {
+    {
       "name": "list-style-type",
       "value": "<counter-style> | <string> | none",
       "initial": "disc",
@@ -29,12 +43,32 @@
       "computedValue": "specified value",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "<counter-style>",
+          "prose": "Specifies the element’s marker string as the value of the list-item counter represented using the specified <counter-style>. Specifically, the marker string is the result of generating a counter representation of the list-item counter value using the specified <counter-style>, prefixed by the prefix of the <counter-style>, and followed by the suffix of the <counter-style>. If the specified <counter-style> does not exist, decimal is assumed.",
+          "type": "value",
+          "value": "<counter-style>"
+        },
+        {
+          "name": "<string>",
+          "prose": "The element’s marker string is the specified <string>.",
+          "type": "value",
+          "value": "<string>"
+        },
+        {
+          "name": "none",
+          "prose": "The element has no marker string.",
+          "type": "value",
+          "value": "none"
+        }
+      ],
       "styleDeclaration": [
         "list-style-type",
         "listStyleType"
       ]
     },
-    "list-style-position": {
+    {
       "name": "list-style-position",
       "value": "inside | outside",
       "initial": "outside",
@@ -44,12 +78,26 @@
       "computedValue": "keyword, but see prose",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "inside",
+          "prose": "No special effect. (The ::marker is an inline element at the start of the list item’s contents.)",
+          "type": "value",
+          "value": "inside"
+        },
+        {
+          "name": "outside",
+          "prose": "If the list item is a block container: the marker box is a block container and is placed outside the principal block box; however, the position of the list-item marker adjacent to floats is undefined. CSS does not specify the precise location of the marker box or its position in the painting order, but does require that it be placed on the inline-start side of the box, using the writing mode of the box indicated by marker-side. The marker box is fixed with respect to the principal block box’s border and does not scroll with the principal box’s content. A UA may hide the marker if the element’s overflow is other than visible. (This allowance may change in the future.) The size or contents of the marker box may affect the height of the principal block box and/or the height of its first line box, and in some cases may cause the creation of a new line box; this interaction is also not defined. This is handwavey nonsense from CSS2, and needs a real definition. If the list item is an inline box: this value is equivalent to inside. Alternatively, outside could lay out the marker as a previous sibling of the principal inline box.",
+          "type": "value",
+          "value": "outside"
+        }
+      ],
       "styleDeclaration": [
         "list-style-position",
         "listStylePosition"
       ]
     },
-    "list-style": {
+    {
       "name": "list-style",
       "value": "<'list-style-position'> || <'list-style-image'> || <'list-style-type'>",
       "initial": "see individual properties",
@@ -64,7 +112,7 @@
         "listStyle"
       ]
     },
-    "marker-side": {
+    {
       "name": "marker-side",
       "value": "match-self | match-parent",
       "initial": "match-self",
@@ -74,12 +122,26 @@
       "computedValue": "specified keyword",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "match-self",
+          "prose": "The marker box is positioned using the directionality of the ::marker’s originating element.",
+          "type": "value",
+          "value": "match-self"
+        },
+        {
+          "name": "match-parent",
+          "prose": "The marker box is positioned using the directionality of the ::marker’s originating element’s parent element.",
+          "type": "value",
+          "value": "match-parent"
+        }
+      ],
       "styleDeclaration": [
         "marker-side",
         "markerSide"
       ]
     },
-    "counter-reset": {
+    {
       "name": "counter-reset",
       "value": "[ <counter-name> <integer>? | <reversed-counter-name> <integer>? ]+ | none",
       "initial": "none",
@@ -89,12 +151,38 @@
       "computedValue": "the keyword none or a list, each item an identifier or a reversed() function paired with an integer",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "none",
+          "prose": "This element does not create any new counters.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "<counter-name> <integer>?",
+          "prose": "Instantiates a counter of the given <counter-name> with a starting value of the given <integer>, defaulting to 0.",
+          "type": "value",
+          "value": "<counter-name> <integer>?"
+        },
+        {
+          "name": "<reversed-counter-name> <integer>?",
+          "prose": "Instantiates a reversed counter of the given <counter-name> with a starting value of the given <integer>, or no starting value if not given.",
+          "type": "value",
+          "value": "<reversed-counter-name> <integer>?"
+        },
+        {
+          "name": "list-item",
+          "prose": "In addition to any explicitly defined counters that authors write in their styles, list items automatically increment a special list-item counter, which is used when generating the default marker string on list items (see list-style-type).",
+          "type": "value",
+          "value": "list-item"
+        }
+      ],
       "styleDeclaration": [
         "counter-reset",
         "counterReset"
       ]
     },
-    "counter-increment": {
+    {
       "name": "counter-increment",
       "value": "[ <counter-name> <integer>? ]+ | none",
       "initial": "none",
@@ -104,12 +192,32 @@
       "computedValue": "the keyword none or a list, each item an identifier paired with an integer",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "none",
+          "prose": "This element does not alter the value of any counters.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "<counter-name> <integer>?",
+          "prose": "Sets (for counter-set) or increments (for counter-increment) the value of the named counter on the element to/by the specified <integer>. If the <integer> is omitted, it defaults to 1 (for counter-increment) or 0 (for counter-set). If there is not currently a counter of the given name on the element, the element instantiates a new counter of the given name with a starting value of 0 before setting or incrementing its value.",
+          "type": "value",
+          "value": "<counter-name> <integer>?"
+        },
+        {
+          "name": "list-item",
+          "prose": "In addition to any explicitly defined counters that authors write in their styles, list items automatically increment a special list-item counter, which is used when generating the default marker string on list items (see list-style-type).",
+          "type": "value",
+          "value": "list-item"
+        }
+      ],
       "styleDeclaration": [
         "counter-increment",
         "counterIncrement"
       ]
     },
-    "counter-set": {
+    {
       "name": "counter-set",
       "value": "[ <counter-name> <integer>? ]+ | none",
       "initial": "none",
@@ -119,28 +227,75 @@
       "computedValue": "the keyword none or a list, each item an identifier paired with an integer",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "none",
+          "prose": "This element does not alter the value of any counters.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "<counter-name> <integer>?",
+          "prose": "Sets (for counter-set) or increments (for counter-increment) the value of the named counter on the element to/by the specified <integer>. If the <integer> is omitted, it defaults to 1 (for counter-increment) or 0 (for counter-set). If there is not currently a counter of the given name on the element, the element instantiates a new counter of the given name with a starting value of 0 before setting or incrementing its value.",
+          "type": "value",
+          "value": "<counter-name> <integer>?"
+        },
+        {
+          "name": "list-item",
+          "prose": "In addition to any explicitly defined counters that authors write in their styles, list items automatically increment a special list-item counter, which is used when generating the default marker string on list items (see list-style-type).",
+          "type": "value",
+          "value": "list-item"
+        }
+      ],
       "styleDeclaration": [
         "counter-set",
         "counterSet"
       ]
     }
-  },
-  "atrules": {},
-  "valuespaces": {
-    "<counter-name>": {
-      "prose": "Counters are referred to in CSS syntax using the <counter-name> type, which represents their name as a <custom-ident>. A <counter-name> name cannot match the keyword none; such an identifier is invalid as a <counter-name>."
+  ],
+  "atrules": [],
+  "selectors": [],
+  "values": [
+    {
+      "name": "<counter-name>",
+      "prose": "Counters are referred to in CSS syntax using the <counter-name> type, which represents their name as a <custom-ident>. A <counter-name> name cannot match the keyword none; such an identifier is invalid as a <counter-name>.",
+      "type": "type"
     },
-    "<reversed-counter-name>": {
+    {
+      "name": "<reversed-counter-name>",
+      "type": "type",
       "value": "reversed( <counter-name> )"
     },
-    "<counter>": {
+    {
+      "name": "<counter>",
+      "type": "type",
       "value": "<counter()> | <counters()>"
     },
-    "<counter()>": {
-      "value": "counter( <counter-name>, <counter-style>? )"
+    {
+      "name": "counter()",
+      "type": "function",
+      "value": "counter( <counter-name>, <counter-style>? )",
+      "values": [
+        {
+          "name": "list-item",
+          "prose": "In addition to any explicitly defined counters that authors write in their styles, list items automatically increment a special list-item counter, which is used when generating the default marker string on list items (see list-style-type).",
+          "type": "value",
+          "value": "list-item"
+        }
+      ]
     },
-    "<counters()>": {
-      "value": "counters( <counter-name>, <string>, <counter-style>? )"
+    {
+      "name": "counters()",
+      "type": "function",
+      "value": "counters( <counter-name>, <string>, <counter-style>? )",
+      "values": [
+        {
+          "name": "list-item",
+          "prose": "In addition to any explicitly defined counters that authors write in their styles, list items automatically increment a special list-item counter, which is used when generating the default marker string on list items (see list-style-type).",
+          "type": "value",
+          "value": "list-item"
+        }
+      ]
     }
-  }
+  ]
 }