Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -74,10 +74,10 @@ box-sizing: revert-layer;
box-sizing: unset;
```

The `box-sizing` property is specified as a single keyword chosen from the list of values below.

### Values

This property is specified as one of the following keyword values:

- `content-box`
- : This is the initial and default value as specified by the CSS standard. The {{Cssxref("width")}} and {{Cssxref("height")}} properties include the content, but does not include the padding, border, or margin. For example, `.box {width: 350px; border: 10px solid black;}` renders a box that is 370px wide.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ caret-animation: unset;

### Values

The `caret-animation` property is specified as one of the keyword values listed below.
This property is specified as one of the following keyword values:

- `auto`
- : The caret blinks on and off. This is the default (initial) value.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ caret-color: unset;

### Values

This property is specified as one `<color>` value or the keyword `auto`.
This property is specified as one `<color>` value or the keyword `auto`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as one `<color>` value or the keyword `auto`:
This property is specified as a single value from the following list:


- `auto`
- : Generally resolves to [`currentColor`](/en-US/docs/Web/CSS/Reference/Values/color_value#currentcolor_keyword), the {{cssxref("color")}} of the text that will be modified.
Expand Down
2 changes: 2 additions & 0 deletions files/en-us/web/css/reference/properties/clip-rule/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ clip-rule: unset;

### Values

This property is specified as one of the following keyword values:

- `nonzero`
- : For every point in the clipping mask's box, a ray is drawn in a random direction. Every time the ray intersects with any part of the clipping path, a tally is increased by one if the clipping path's part is moving from left to right across the ray, whereas it is decreased by one if the path part is moving right to left across the ray. If the final total of the tally is zero, the point is outside the path's shape. Otherwise, it's inside the path's shape.

Expand Down
2 changes: 2 additions & 0 deletions files/en-us/web/css/reference/properties/clip/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@ clip: unset;

### Values

This property is specified as a `rect()` function or the keyword `auto`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as a `rect()` function or the keyword `auto`:
This property is specified as a single value from the following list:


- `rect()`
- : A rectangle defined using a `rect()` function of the form `rect(<top>, <right>, <bottom>, <left>)`. The `<top>` and `<bottom>` values are offsets from the _inside top border edge_ of the box, while `<right>` and `<left>` are offsets from the _inside left border edge_ of the box — that is, the extent of the padding box.

Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/css/reference/properties/color/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,12 +110,10 @@ color: revert-layer;
color: unset;
```

The `color` property is specified as a single {{cssxref("&lt;color&gt;")}} value.

Note that the value must be a uniform color. It can't be a {{cssxref("gradient")}}, which is actually a type of {{cssxref("image")}}.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we retain this Note? looks like important guidance


### Values

This property is specified as one {{cssxref("&lt;color&gt;")}} value:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as one {{cssxref("&lt;color&gt;")}} value:
This property is specified as a single value from the following list:


- {{cssxref("&lt;color&gt;")}}
- : Sets the color of the textual and decorative parts of the element.
- [`currentColor`](/en-US/docs/Web/CSS/Reference/Values/color_value#currentcolor_keyword)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,8 @@ column-count: unset;

### Values

This property is specified as an `<integer>` or the keyword `auto`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as an `<integer>` or the keyword `auto`:
This property is specified as a single value from the following list:


- `auto`
- : The number of columns is determined by other CSS properties, such as {{cssxref("column-width")}}.
- {{cssxref("&lt;integer&gt;")}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,8 @@ column-gap: unset;

### Values

This property is specified as a `<length>`, `<percentage>`, or the keyword `normal`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as a `<length>`, `<percentage>`, or the keyword `normal`:
This property is specified as a single value from the following list:


- `normal`
- : For multi-column layout, resolves to `1em`; otherwise `0`. This is the default value.
- {{CSSxRef("&lt;length&gt;")}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ column-height: unset;

### Values

This property is specified as a `<length>` or the keyword `auto`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as a `<length>` or the keyword `auto`:
This property is specified as a single value from the following list:


- `auto`
- : The initial value. If the content container has a set height, the content columns will grow to that height, overflowing to the side if the content doesn't fit inside the container. If the content container does not have a set height, the content will be equally distributed between the columns generated inside the container.
- {{cssxref("&lt;length>")}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ column-rule: unset;

### Values

The `column-rule` property accepts a comma-separated list of values, including:
This property is specified as a comma-separated list of values, each value being one of the following value types:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as a comma-separated list of values, each value being one of the following value types:
This property is specified as a comma-separated list of values. Each value can be one of the following value types:


- `<gap-rule>`
- : Specified as one, two, or three of the values listed below, in any order.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ column-wrap: unset;

### Values

This property is specified as one of the following keyword values:

- `auto`
- : The initial value. If the content container's {{cssxref("column-height")}} is set to a {{cssxref("&lt;length>")}}, `auto` resolves to `wrap`, otherwise it resolves to `nowrap`.
- `nowrap`
Expand Down
8 changes: 1 addition & 7 deletions files/en-us/web/css/reference/properties/contain/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,13 +102,7 @@ contain: unset;

### Values

The `contain` property can have any of the following values:

- The keyword `none` **or**
- One or more of the space-separated keywords `size` (or `inline-size`), `layout`, `style`, and `paint` in any order **or**
- One of the shorthand values `strict` or `content`

The keywords have the following meanings:
This property is specified as the keyword `none`, `strict`, or `content`, or a space-separated list of keyword values:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This info from original looks crucial - "one or more"

Suggested change
This property is specified as the keyword `none`, `strict`, or `content`, or a space-separated list of keyword values:
This property is specified as a single value (`none`, `strict`, or `content`) or as a space-separated list of one or more of `size` (or `inline-size`), `layout`, `style`, and `paint`, in any order:


- `none`
- : The element renders as normal, with no containment applied.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ container-name: unset;

### Values

This property is specified as a space-separated list of `<custom-ident>` values or the keyword `none`:

- `none`
- : The default value. The query container has no name.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ container-type: unset;

### Values

The `container-type` property can take a single value from the list below, or two values. In the two-value case, one must be `scroll-state` and the other can be `inline-size` or `size`.
This property is specified as one of the following keyword values, optionally with the keywords `inline-size` or `size` if the keyword is `scroll-state`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the original had valuable framing around single-value and two-value cases.
I'd suggest to add those back:

Suggested change
This property is specified as one of the following keyword values, optionally with the keywords `inline-size` or `size` if the keyword is `scroll-state`:
This property is specified as one or two keyword values from the following list. In the two-value case, one must be `scroll-state` and the other must be `inline-size` or `size`:


- `anchored`
- : Establishes a query container for anchored container queries on the container. In this case, the size of the element is not computed in isolation; no [containment](/en-US/docs/Web/CSS/Guides/Containment/Using) is applied.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ counter-increment: unset;

### Values

The `counter-increment` property takes as its value either a list of space-separated counter names specified as `<custom-ident>` with an optional `<integer>` value or the keyword `none`. You may specify as many counters to increment as you want, with each name or name-number pair separated by a space.
This property is specified as a space-separated list of `<custom-ident>` values, each optionally followed by an `<integer>`, or the keyword `none`:

- {{cssxref("&lt;custom-ident&gt;")}}
- : Specifies the name of the counter to increase or decrease.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -94,13 +94,10 @@ counter-set: revert-layer;
counter-set: unset;
```

The `counter-set` property is specified as either one of the following:

- A `<custom-ident>` naming the counter, followed optionally by an `<integer>`. You may specify as many counters to reset as you want, with each name or name-number pair separated by a space.
- The keyword value `none`.

### Values

The `counter-set` property is specified as either a space-separated list of `<custom-ident>` values, each optionally followed by an `<integer>`, or the keyword `none`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `counter-set` property is specified as either a space-separated list of `<custom-ident>` values, each optionally followed by an `<integer>`, or the keyword `none`:
This property is specified as either a space-separated list of `<custom-ident>` values, each optionally followed by an `<integer>`, or the keyword `none`:


- {{cssxref("custom-ident", "&lt;custom-ident&gt;")}}
- : The name of the counter to set.
- {{cssxref("&lt;integer&gt;")}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,8 @@ dominant-baseline: unset;

### Values

This property is specified as one of the following keyword values:

- `auto`
- : If this property is applied to a {{SVGElement("text")}} element, then the computed value depends on the value of the {{SVGAttr("writing-mode")}} attribute.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ dynamic-range-limit: unset;

### Values

This property is specified as one of the following keyword values or a `dynamic-range-limit-mix()` function:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as one of the following keyword values or a `dynamic-range-limit-mix()` function:
This property is specified as a single value from the following list:


- `standard`
- : Specifies the maximum luminance as High Dynamic Range (HDR) reference white, which is the CSS color `white`.
- `no-limit`
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/css/reference/properties/fill/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ fill: unset;

### Values

This property is specified as one keyword, `<color>`, or `url()` with an optional `<color>`:
This property is specified as a `<color>`, a `url()` optionally followed by a `<color>` or the keyword `none`, or one of the following keyword values:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This again mixes "one of the following keyword values" when the list also includes <color>, <url>, and none. The description for <url> already covers the values that can be optionally attached so we can drop that detail from this lead-in prose:

Suggested change
This property is specified as a `<color>`, a `url()` optionally followed by a `<color>` or the keyword `none`, or one of the following keyword values:
This property is specified as a single value from the following list or as two values when using `<url>`:


- `none`
- : No `fill` is painted; the areas inside the stroke, if any, are transparent.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Generally, `flex-shrink` is used alongside the {{cssxref("flex-grow")}} and {{cs

## Values

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section needs to be moved before "Description"

Suggested change
## Values
### Values


The `flex-shrink` property is specified as a single `<number>`.
This property is specified as one `<number>` value:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as one `<number>` value:
This property is specified as the following value:


- `<number>`
- : See {{cssxref("&lt;number&gt;")}}. Negative values are invalid. Defaults to 1.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ flex-wrap: unset;

### Values

The `flex-wrap` property is specified as a single keyword chosen from the following values below:
This property is specified as one of the following keyword values:

- `nowrap`
- : The flex items are laid out in a single line which may cause the flex container to overflow. The cross-start is the equivalent of [inline-start or block-start](/en-US/docs/Glossary/Flow_relative_values), depending on the {{cssxref("flex-direction")}} value. This is the default value.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@ The `font-language-override` property is specified as the keyword `normal` or a

### Values

This property is specified as a `<string>` or the keyword `normal`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This property is specified as a `<string>` or the keyword `normal`:
This property is specified as a single value from the following list:


- `normal`
- : Tells the browser to use font glyphs that are appropriate for the language specified by the `lang` attribute. This is the default value.
- {{cssxref("string")}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ font-palette: palette-mix(in lch, --blue, --yellow);

### Values

This property is specified as a `<dashed-ident>`, a `paletter-mix()` function, or one of the following keyword values:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The listed values are not just the keywords but also include <dashed-ident> and palette-mix(). Can we update this to:

Suggested change
This property is specified as a `<dashed-ident>`, a `paletter-mix()` function, or one of the following keyword values:
This property is specified as a single value from the following list:


- `normal`
- : Specifies the default color palette or the default glyph colorization (set by the font maker) to be used for the font. With this setting, the palette in the font at index 0 is rendered.
- `light`
Expand Down