Skip to content

Conversation

@captainbrosset
Copy link
Contributor

Fixes #2045.

The CSSWG has resolved to make masonry its own display type, and decided to call it grid-lanes.

It's important that our feature uses this term, but at the same time retain the masonry name too. The spec still uses it, and that's how most developers who know about this type of layout likely refer to it.

Let's iterate on a better description.

@github-actions github-actions bot added the feature definition Creating or defining new features or groups of features. label Dec 11, 2025
Copy link
Collaborator

@ddbeck ddbeck left a comment

Choose a reason for hiding this comment

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

Ugh, I am really disappointed that CSSWG decided to invent a new name for this. We're now likely to see a half decade of "grid lanes (formerly known as masonry)" and "masonry (also known as grid lanes)" and the like. 😞

In addition to my suggestions below, I think we should preemptively reserve the IDs:

  • display-grid-lanes
  • grid-lanes

They would be kind: move feature entries that point to the existing masonry feature.

@@ -1,4 +1,4 @@
name: Masonry
description: Masonry is a type of CSS grid layout where the items on one of the axes are tightly packed together, like brickwork, instead of leaving gaps to align across the other axis.
description: Masonry is a two-dimensional layout system where items are tightly packed within parallel lanes. Items are placed one by one in the lane which has the most space available. Also known as grid-lanes.
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think we should:

  • Mention CSS
  • Retain the illustrative metaphor.
  • Explicitly mention the display: grid-lanes and display: inline-grid-lanes entrypoints (unless we think it's likely that implementers will do the latter separately). This lets us out of saying "also known as" which I'm not convinced is a true statement (at least not yet).

Maybe something like this:

Suggested change
description: Masonry is a two-dimensional layout system where items are tightly packed within parallel lanes. Items are placed one by one in the lane which has the most space available. Also known as grid-lanes.
description: Masonry, created by a `display: grid-lanes` or `display: inline-grid-lanes` CSS declaration, is a two-dimensional layout system where items are tightly packed in parallel, like brickwork. Items are placed one by one in the lane that has the most available space.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature definition Creating or defining new features or groups of features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Masonry's description when the CSSWG resolves the "just grid" vs. new display type question

3 participants