Skip to content

New property: row-rule-color#44549

Merged
estelle merged 23 commits into
mainfrom
gaps1
Jul 15, 2026
Merged

New property: row-rule-color#44549
estelle merged 23 commits into
mainfrom
gaps1

Conversation

@estelle

@estelle estelle commented Jun 22, 2026

Copy link
Copy Markdown
Member

new page.

Looking to get feedback/approval before updating/creating other row-rule, all the column-rule, and rule shorthand properties.

because of this, some links might be red (page not created yet), and module landing not being updated until i add several pages. please don't hold up review / approval for issues of red links for CSS gaps properties

Part of openwebdocs/project#238

@estelle
estelle requested a review from a team as a code owner June 22, 2026 16:47
@estelle
estelle requested review from chrisdavidmills and removed request for a team June 22, 2026 16:47
@github-actions github-actions Bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Jun 22, 2026
@github-actions

github-actions Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Preview URLs (1 page)

Flaws (10)

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/CSS/Reference/Properties/row-rule-color
Title: row-rule-color CSS property
Flaw count: 10

  • macros:
    • Macro cssxref produces link /en-US/docs/Web/CSS/row-rule-width which doesn't resolve
    • Macro cssxref produces link /en-US/docs/Web/CSS/row-rule-style which doesn't resolve
    • Macro cssxref produces link /en-US/docs/Web/CSS/row-rule which doesn't resolve
    • Macro cssxref produces link /en-US/docs/Web/CSS/rule-color which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/number-token which doesn't resolve
    • and 5 more flaws omitted

(comment last updated: 2026-07-15 10:54:28)

@estelle estelle mentioned this pull request Jun 29, 2026
62 tasks

@chrisdavidmills chrisdavidmills left a comment

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.

Excellent work, @estelle. This is mostly really nice and clear, and the comments are not particularly major.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md
- : A {{cssxref("repeat()")}} function, with the first parameter being an {{cssxref("<integer>")}} of `1` or more, representing the number of the times the second parameter, a {{cssxref("<color>")}} value, should be repeated.

- `<auto-repeat-line-color>`
- : A {{cssxref("repeat()")}} function, with `auto` as the first argument and a `<color>` as the second, representing the color to be repeated as many times as needed to fill in values for any row-rules that would not otherwise receive values from other parts of the property 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.

Hrm, this is tricky to explain. It took me a little while to grok this. Would the following help, do you think?

Suggested change
- : A {{cssxref("repeat()")}} function, with `auto` as the first argument and a `<color>` as the second, representing the color to be repeated as many times as needed to fill in values for any row-rules that would not otherwise receive values from other parts of the property value.
- : A {{cssxref("repeat()")}} function, with `auto` as the first argument and a `<color>` as the second, representing a color to be repeated as many times as needed to fill in values for any row-rules that are not explicitly specified by other components of the property value.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

should actually be a list of colors.

A {{cssxref("repeat()")}} function, with auto as the first argument and a <color> as the second, representing one or more comma-separated <color> values to be repeated as many times as needed to fill in values for any row-rules that are not explicitly specified by other components of the property value.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md
row-rule-color: blue;
```

When more than one `<line-color>` is declared, they will be applied to row-rules in the order specified. If there are more row-rules than `<line-color> values, the list of line colors is repeated until every row rule has a color. If we declare the following, for example, every odd rule will be blue, and every even rule will be yellow.

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.

[markdownlint] reported by reviewdog 🐶
error MD033/no-inline-html Inline HTML [Element: line-color]

@estelle
estelle requested a review from chrisdavidmills July 6, 2026 12:47

@chrisdavidmills chrisdavidmills left a comment

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.

@estelle, a few more comments for you, mainly around the issue of repeat() being able to accept multiple colors, not just one.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated

### Auto-repeating line colors

The `repeat()` function also accepts `auto` as the first argument instead of a positive integer. With `auto` as the first argument, the `<color>` passed as the second will be repeated as many times as needed to fill in values for any row-rules that are not explicitly specified by other components of the property value, if any.

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 cover the fact that auto can be combined with multiple <color> values.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md
- : A {{cssxref("&lt;color&gt;")}} representing the color of the line.

- `<repeat-line-color>`
- : A {{cssxref("repeat()")}} function, with the first parameter being an {{cssxref("&lt;integer&gt;")}} of `1` or more, representing the number of the times the second parameter, a {{cssxref("&lt;color&gt;")}} value, should be repeated.

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.

repeat() can accept multiple color values, not just one?

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
@estelle
estelle requested a review from chrisdavidmills July 13, 2026 17:09

@chrisdavidmills chrisdavidmills left a comment

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.

@estelle I've got a few more comments for you, but they are pretty minor. I will approve, as I don't think I need to see this again. Nice work.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
row-rule-color: blue, repeat(auto, yellow), red;
```

In this case, the first row rule will be blue, the last will be red, and all others will be yellow. It doesn't matter if the container has 3, 6, 11, 16, or 21 rows; the first will always be blue and, as long as there are at least two row-rules, the last will always be red. All the other row rules will be yellow, which means if there are only 2 or 3 rows, there will be no yellow row rules.

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've noticed an inconsistency in the text: "row-rule" versus "row rule". I'd suggest choosing one, then making it consistent everywhere. I personally think "row rule" is better grammatically when referring to the concept rather than the property name, but I don't really care that much which one we go with.

Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/row-rule-color/index.md Outdated
@estelle
estelle merged commit c2b19ba into main Jul 15, 2026
13 checks passed
@estelle
estelle deleted the gaps1 branch July 15, 2026 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants