-
Notifications
You must be signed in to change notification settings - Fork 124
Adding intro to Masonry blog post #357
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
csalt-scottlogic
merged 10 commits into
ScottLogic:gh-pages
from
osharon-scottlogic:gh-pages
Sep 17, 2025
Merged
Changes from 1 commit
Commits
Show all changes
10 commits
Select commit
Hold shift + click to select a range
8312d9d
Adding intro to Masonry blog post
osharon-scottlogic c6b2308
added sample links + fixed typos
osharon-scottlogic e55de07
Merge branch 'ScottLogic:gh-pages' into gh-pages
osharon-scottlogic aed6bf7
added design comment
osharon-scottlogic 10a078e
update images
osharon-scottlogic b324de2
Merge branch 'ScottLogic:gh-pages' into gh-pages
osharon-scottlogic 713f59c
updated pub date
osharon-scottlogic af4df00
fixed typos
osharon-scottlogic 69c4a20
Merge branch 'ScottLogic:gh-pages' into gh-pages
osharon-scottlogic a0157ae
updated date and fixed pdf link
osharon-scottlogic File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
--- | ||
title: Intro to Masonry Layout | ||
date: 2025-09-01 08:00:00 Z | ||
categories: | ||
- Tech | ||
tags: | ||
- CSS | ||
- Javascript | ||
summary: Let's explore the concept of masonry layouts in web development where items share the same width but differ in height. We'll explains when a simple CSS grid is sufficient, when to rely on libraries like Masonry.js for dynamic content, and why the CSS grid-template-rows experimental value masonry; remains impractical due to limited browser support. We'll also touch on accessibility concerns, the underlying column-stacking logic, and more advanced rectangle-packing techniques for layouts with both variable widths and heights. | ||
osharon-scottlogic marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
author: osharon | ||
image: "/osharon/assets/masonry/pinterest.png" | ||
--- | ||
|
||
As a web-developer you might have come across the term “Masonry”. If you’re not familiar with it, this article will hopefully shed some light on the topic. The most famous example for masonry layout is pinterest.com. At first glance it looks like simple grid of items but notice that each item is slightly different height whilst they all stack neatly with varying gaps between them. | ||
|
||
<img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/pinterest.jpg" alt="Pinterest signature masonry layout"/> | ||
|
||
You might argue that it’s not a big deal but notice that items are ordered horizontally - if there were only 5 items, we would expect them fill a single row (and not be stacked in a single vertical column). | ||
There’s no denying that masonry looks good, but do you really need it? | ||
If all your items are of the same height, you can use a simple grid without any issue. | ||
|
||
<img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/fixed-grid.png" alt="Fixed-size grid"/> | ||
|
||
If your content is fixed, ie. It’s always the same items; you can use one of the many grid generators. | ||
Even if your layout is fixed, for example - the first item is always big, you shouldn’t have any issue. | ||
|
||
<img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/fixed-layout.png" alt="Fixed layout"/> | ||
|
||
The problem begins when items are load dynamically with different sizes and still needs to be nicely laid out. The common case is like Pinterest: same width, different heights. | ||
Let’s say we have this line of items, and we now wonder where the next item should appear. | ||
|
||
<img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/masonry-question.png" alt="Fixed-size grid"/> | ||
|
||
If you’re not into reinventing the wheel, there are JS-based libraries such as Masonry.js. | ||
Alternatively, you can use the new CSS feature grid-template-rows: masonry;. The only problem with it is that it’s only available on Firefox and must be explicitly enabled. The feature is available in Firefox since 2020 but it's still not commonly used. | ||
osharon-scottlogic marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
```css | ||
display: grid; | ||
grid-template-columns: repeat(4, 3rem); | ||
grid-template-rows: masonry; | ||
``` | ||
|
||
<table><tr> | ||
<td><img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/masonry-not-firefox.png" alt="Fixed-size grid"/> | ||
disabled</td> | ||
<td><img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/masonry-firefox.png" alt="Fixed-size grid"/> enabled</td> | ||
</tr></table> | ||
|
||
From a technical standpoint, we’re adding the next item to the shortest column iteratively. | ||
Behind the scenes, masonry js-library can do one of the following - Change the actual order of HTML elements; change the visual layout using CSS transition feature but keep the HTML elements at their original order. When deciding between the two, you should take keyboard-navigation into consideration: When the user hit “next” on the keyboard, where should the focus go? | ||
|
||
The next step beyond standard masonry is both widths and heights are different sizes. The algorithm becomes far more complicated - it’s no longer adding an item to the shortest column as the previous libraries did, rather trying to fit each element wherever possible, but of course there’s no need to re-invent the wheel - the problem is called “rectangle-packing” and there are ready made libraries for it. | ||
|
||
|
||
<img src="{{ site.baseurl }}/osharon/assets/intro-to-masonry/rect-packing.png" alt="Rectangle Packing algorithm"/> | ||
|
||
## So, what are the takeaways? | ||
For anything static, avoid overcomplicated code. Use a css-grid generator to set the layout. | ||
For dynamic items of various heights (or width, just as long as one of the dimensions is fixed), use an existing library of masonry-js. Internally you can rely on Firefox feature but avoid it for public use. | ||
For anything more complicated, use the rect-packing algorithm. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.