Skip to content

Editorial review: Document CSS multicol column wrapping#42934

Merged
chrisdavidmills merged 55 commits intomdn:mainfrom
chrisdavidmills:multicol-column-wrapping
Mar 4, 2026
Merged

Editorial review: Document CSS multicol column wrapping#42934
chrisdavidmills merged 55 commits intomdn:mainfrom
chrisdavidmills:multicol-column-wrapping

Conversation

@chrisdavidmills
Copy link
Contributor

@chrisdavidmills chrisdavidmills commented Jan 27, 2026

Description

Chrome 145 adds support for Column wrapping for multicol, which includes the column-height and column-wrap properties. See https://chromestatus.com/feature/5176206485618688.

This PR documents those two properties and adds appropriate mentions in other places.

Motivation

Additional details

Related issues and pull requests

Fixes #43183

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner January 27, 2026 12:05
@chrisdavidmills chrisdavidmills requested review from estelle and removed request for a team January 27, 2026 12:05
@github-actions github-actions bot added the Content:CSS Cascading Style Sheets docs label Jan 27, 2026
@chrisdavidmills chrisdavidmills changed the title Document CSS multicol column wrapping Jan 27, 2026
@github-actions github-actions bot added the size/xl [PR only] >1000 LoC changed label Jan 27, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 27, 2026

Preview URLs (7 pages)
Flaws (13)

Note! 3 documents with no flaws that don't need to be listed. 🎉

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

URL: /en-US/docs/Web/CSS/Reference/Properties/column-count
Title: column-count
Flaw count: 1

  • broken_links:
    • Link /en-US/docs/Web/CSS/number-token doesn't resolve

URL: /en-US/docs/Web/CSS/Reference/Properties/column-height
Title: column-height
Flaw count: 1

  • broken_links:
    • Link /en-US/docs/Web/CSS/length is a redirect

URL: /en-US/docs/Web/CSS/Reference/Properties/column-width
Title: column-width
Flaw count: 3

  • broken_links:
    • Link /en-US/docs/Web/CSS/length is a redirect
    • Link /en-US/docs/Web/CSS/length is a redirect
    • Link /en-US/docs/Web/CSS/percentage is a redirect

URL: /en-US/docs/Web/CSS/Reference/Properties/columns
Title: columns
Flaw count: 8

  • broken_links:
    • Link /en-US/docs/Web/CSS/column-width is a redirect
    • Link /en-US/docs/Web/CSS/column-count is a redirect
    • Link /en-US/docs/Web/CSS/column-height doesn't resolve
    • Link /en-US/docs/Web/CSS/length is a redirect
    • Link /en-US/docs/Web/CSS/length is a redirect
    • and 3 more flaws omitted

(comment last updated: 2026-03-04 20:42:49)

Copy link
Collaborator

@rachelandrew rachelandrew left a comment

Choose a reason for hiding this comment

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

This looks generally ok, other than a nit on the overflow page and a suggestion to make things clearer around what causes columns to overflow.

@chrisdavidmills chrisdavidmills changed the title Technical review: Document CSS multicol column wrapping Feb 6, 2026
Copy link
Member

@estelle estelle left a comment

Choose a reason for hiding this comment

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

lots of comments, but nothing major

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner February 19, 2026 11:10
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team February 19, 2026 11:10
chrisdavidmills and others added 6 commits February 19, 2026 11:14
…ndex.md

Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
…ndex.md

Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
…ndex.md

Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
…ndex.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Copy link
Member

@estelle estelle left a comment

Choose a reason for hiding this comment

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

-I think height: fit-content can be removed from the no-support sections.

  • Recommend placing relevant CSS before hidden CSS in the source order so hitting "play" shows the relevant to the example CSS at the top. If there are specificity concerns, put the hidden CSS in a layer.
  • Begin the description section with the name of the feature and a summary description.
  • A lot of the suggestions are to make the reference pages sound less guide-like and more reference-esque.
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
chrisdavidmills and others added 8 commits March 4, 2026 08:50
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
chrisdavidmills and others added 8 commits March 4, 2026 08:56
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
@chrisdavidmills chrisdavidmills requested a review from estelle March 4, 2026 09:44
Copy link
Member

@estelle estelle left a comment

Choose a reason for hiding this comment

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

Looks good. Just a few minor tweaks, but I don't need to re-review. approving.


#### CSS

We start by setting {{cssxref("column-width")}} on the {{htmlelement("body")}} element to define the preferred width for the columns. A {{cssxref("gap")}} of `3em 2em` results in a `3em` gap between rows and a `2em` gap between columns. The {{cssxref("column-rule")}} adds a line in the center of the gap between the columns. The `column-height` of `95vh` makes the columns nearly as tall as the viewport.
Copy link
Member

Choose a reason for hiding this comment

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

I did a PR if you want to do a quick review - #43338

chrisdavidmills and others added 6 commits March 4, 2026 20:37
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
Co-authored-by: Estelle Weyl <estelle@openwebdocs.org>
@chrisdavidmills chrisdavidmills requested review from rachelandrew and removed request for rachelandrew March 4, 2026 20:42
@chrisdavidmills chrisdavidmills dismissed rachelandrew’s stale review March 4, 2026 20:43

These comments were handled.

@chrisdavidmills chrisdavidmills merged commit 04defe5 into mdn:main Mar 4, 2026
8 checks passed
@chrisdavidmills chrisdavidmills deleted the multicol-column-wrapping branch March 4, 2026 20:44
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/xl [PR only] >1000 LoC changed

3 participants