New layouts with CSS Subgrid

(joshwcomeau.com)

250 points | by joshwcomeau 22 hours ago

16 comments

  • webstrand 10 hours ago
    Subgrid is really cool, but I want to note that for the first trivial example, you could make the children participate in grid layout by doing

        ul { display: contents }
    
    it's more efficient, if you don't need subgrid features, but still want the nested element structure for other reasons.
    • Izkata 10 hours ago
      And on the second one, you could use any other unit instead of fr for the image to set its width consistently, then fr on the text to have it use up whatever remains.
      • bradly 10 hours ago
        I also wasn't understanding the value looking at the first two examples, but the pricing packages example I do think I would struggle to implement in a clean way using traditional css.
        • b2ccb2 4 hours ago
          I'd use <table>. It literally is a table. And for mobile just do a media query to turn it into a flexbox.
          • PxldLtd 3 hours ago
            Yeah the claim that tables are hard to style for such a simple design doesn't really hold up in my opinion.

            This took two seconds to make https://codesandbox.io/p/sandbox/5ry4rl

            I do agree though that subgrid makes the HTML more readable though so I'm all for it.

    • moron4hire 10 hours ago
      Yes, for that specific example it works. But in general, this essentially deletes the UL from the layout entirely. It won't be stylable[0] and it won't dispatch UI events that occur on it specifically.

      One example of a reason you might want such an element to still participate in layout is to use that element as an area highlighter. Or you might make it a scrollable section; subgrid makes sticky-header tables rather trivial to implement now.

      [0] Well, I can't remember right now if it's unstylable or if its height just ends up zero, but either way, it might not be what you expect.

      • masterphai 9 hours ago
        One subtle thing worth adding is that display: contents also changes how accessibility trees are constructed. The element is removed from the visual layout and from the accessibility tree in many browsers, so semantics like list grouping, landmarks, or ARIA roles can disappear unless you re-introduce them manually.

        That’s why subgrid ends up filling a different niche: you preserve the DOM structure, preserve accessibility semantics, and still let the children participate in the parent’s track sizing. It costs more than contents, but it avoids a lot of the accidental side-effects that show up once you start mixing layout, semantics, and interactivity.

        • paulhebert 8 hours ago
          Yeah this is a good callout. My understanding is that display: contents is not meant to impact the accessibility tree but there is a long and ongoing history of browser bugs that make me not want to use it for elements that have an accessible role
          • webstrand 36 minutes ago
            From my testing, as far as I've been able to tell it no longer has any impact on accessibility. The element itself does not appear in the tree, this makes sense display:contents is non-interactive. But all of the children correctly appear in the accessibility tree as if they did not have that shared parent element. But I am by no means an expert at operating screen readers, do you know of any specific issues with it?
      • webstrand 39 minutes ago
        Yeah, though I find in practice I use `display: contents` far more than I do subgrid. Contents effectively deletes the node for layout purposes, but it still participates in the CSS cascade so you can use it in selectors, even `:hover` works when a child gets hovered, or use it as the origin for inheritable properties.
  • dsego 3 hours ago
    The pricing UI example is exactly the type of thing I had to build a few years ago. Deceptively simple, two tables for comparison, but the rows need to line up.

    Impossible without subgrid, either you need to have fixed heights or calculate heights with JS, but neither is elegant or simple, especially if you have react components and adhere to modular design, and you need to have those components agree on sizing.

  • Nathanba 11 hours ago
    Isn't this also what container queries solve better? I guess maybe you want to be sure that the whole grid remains consistent instead of relying on individual containers possibly making their own decisions. So many new features to investigate, so little time :) https://codepen.io/web-dot-dev/pen/rNrbPQw
    • webstrand 10 hours ago
      Container queries don't solve the responsive to sibling sizes issue that grid/flex can solve. And frustratingly container queries force your container element to be a new stacking context, unlike flex/grid.

      I am sad that using containers and subgrids together doesn't work. Being able to query the size of the subgrid from a child element would be super powerful.

  • buovjaga 6 hours ago
    Random grid gotcha that drove me crazy some time ago: due to browser bugs we can't use <img> elements with percentage widths or heights as grid items. The grid cell dimensions get blown out to the ones of the original image. Seen in both Firefox and Chromium. Relevant FF bug is probably https://bugzilla.mozilla.org/show_bug.cgi?id=1857365 '<img> grid item with percentage height, "width: auto", "grid-template-columns: auto", and no track stretching makes column to have the same width of the original image's width' (although someone there claims it works in Chromium).
    • bryanrasmussen 6 hours ago
      so if the img has a specific size set in width and height attributes or via css, and that size is not percentile or auto, the problem doesn't exist?

      I'm just confused by the "original image's width".

      • chrisweekly 44 minutes ago
        not OP but (unless silently edited) they wrote

        > "<img> elements with percentage widths or heights"

  • flowerthoughts 7 hours ago
    This sounds useful, but the example of the feature rows reminds me how sad it is that CSS sometimes requires adding information about the document structure to make a layout work. In this case the number of rows.
    • dsego 3 hours ago
      Ideally, we would have a way to align elements even when they don't share a parent. Or maybe a flex container that can have its layout mimic another flex container so the distribution in them can line up. It seems that there are a lot of heuristics and edge cases though to keep a simple DX.
  • N_Lens 9 hours ago
    Have we wrapped all the way around to <table> layouts again?
    • sussmannbaka 9 hours ago
      Yes and no. <table> layouts were a hack that solved a real problem but came with massive downsides. People didn’t tell you to not use <table> to lay out content because grids are bad (they are quite handy! take a look at Grid Systems by Josef Müller-Brockmann) but because <table> both posed technical and accessibility problems. A layout grid is not a table (or a <table >). A table (with and without <>) comes with attached semantics, hierarchy, reading direction etc. and is extremely rigid, which makes it a bad fit for differing screen sizes.

      It’s true that this was a blind spot for a long time and that it was frustrating to not be able to efficiently lay out content in 2D when <table> was just there. But it was the wrong choice then as it is now and it has been baseline available for 8 years now. I hope it won’t take another 8 years until the comparison stops :o)

      • system2 6 hours ago
        Try to select a tr / td without pulling your hair.
      • lelandfe 8 hours ago
        > A layout grid is not a table

        Ain't it? Rows and columns get you a table.

        • dwb 6 hours ago
          A table is for tabulating data. They have quite different meaning and purpose, even if they share a couple of characteristics.
          • lelandfe 5 hours ago
            Tabulate means to organize by rows and columns.

            Layout grids organize data by rows and columns.

            • sussmannbaka 43 minutes ago
              They don't! Layout grids are less about the rows and columns and more about the lines separating them (which is why those get a lot of attention in CSS grid). Take a look at how layout grids are used in design and you will quickly find examples that are extremely inconvenient to realize with HTML tables. I'm sure it can be done and I'm sure some poor email marketing dev had to, but the result would be entirely static and not able to reflow.
            • dwb 3 hours ago
              You have just restated the similarity I referred to. The ways they are different make them important enough to distinguish.

              “Tabulate” doesn’t just mean organising anything by rows and columns, it means organising data for a particular purpose. And layout grids usually end up looking quite different to tables because although they have a broadly similar underlying structure, the purpose is quite different.

          • pacifika 5 hours ago
            HTML spec couldn’t just have added a grid element?
            • sussmannbaka 46 minutes ago
              I think CSS grid is too powerful to be represented in markup. I rotated the idea in my head for a bit but the most I could come up was elements that covered a small subset of CSS grid and which completely lost the entire appeal of being able to handle tracks dynamically.
            • maqnius 5 hours ago
              CSS grids are for presentation, HTML is for semantics. Ideally they are separated. That's why the use of <center> tag is deprecated.
        • Boltgolt 3 hours ago
          A table is a grid, but a grid does not have to be a table
    • dreamcompiler 7 hours ago
      Yes. I built layouts like this with automatic server-rendered tables 25 years ago, and they just worked with very little effort.

      Tables weren't responsive or accessible or any of the other things we now recognize as essential, but it has certainly taken a long time to reinvent the table wheel. And all the while we've had to listen to people screaming in our ears that tables were bad, while also listening to them argue about which of their incredibly difficult and patently subpar "solutions" we were supposed to use instead.

    • halapro 8 hours ago
      <table> was a problem because it described content, not style. There's nothing wrong with creating grids.
    • joduplessis 8 hours ago
      Was going to say this too!
    • hackthemack 9 hours ago
      I agree. I got really tired of hearing tables are for tabular data! For 20+ years. My reply was always, Who cares if it accomplished the layout you want. If the meaning of a word is what got people so hung up... why not go and make a new css term that did what tables did but improve on it. Now 20+ years later, that is pretty much what they did.
      • strixli 7 hours ago
        Screen readers do care. A lot. Grid and subgrid solve the problem without breaking DOM and semantics, which is a huge concern in accessibility.
  • Surac 6 hours ago
    So we are back to grids after all the years put into css? We had this with html many years ago
    • system2 6 hours ago
      This makes the content responsive way easier than any HTML grid could.
    • moi2388 6 hours ago
      Yes but now they cascade for even more fun bugs whilst styling your layout :D

      /s

  • echelon 10 hours ago
    I am continually in awe of Josh's blog posts, clarity of writing, sense of design, and fun interactive website.

    You're killing it, Josh. Thank you for writing and teaching us.

    • paulhebert 8 hours ago
      Agreed. I’m happy to be on his mailing list. I’m always excited for a new Josh article
  • rckt 8 hours ago
    I never found it comfortable to work with grids. The syntax and layout just feel off. Flexbox is a much more flexible and easy thing to work with.
    • code_biologist 8 hours ago
      There's plenty of overlap, but they solve different problems: flexbox when the content should control element sizing/fit, grid when the container should control element sizing/fit.
      • alwillis 7 hours ago
        Another way to think about it: flexbox is for alignment of boxes in one dimension: horizontally or vertically.

        CSS Grid is for two dimensional layout of rows and columns.

        Back in the day, developers wanted page layout instead of the hacks on top of hacks with table-based layouts, floats and positioning to create layouts.

        We’ve had CSS Grid designed for page layout on the web, in all browsers since 2017; as of 2022, only 12% of the top 1 million websites used CSS Grid, which to me is ridiculously low.

        • rckt 4 hours ago
          I use flexbox for grid purposes, simply because the syntax is straightforward and easy to read. Yeah, it’s one dimension, but if you nest it, it becomes two with no issues.
          • laszlokorte 2 hours ago
            With nested flexbox the nested dimensions are not aligned to each other. With grid the items are aligned across both each row AND each column. With subgrid even nested grids can be aligned across nesting levels.
            • rckt 1 hour ago
              True. But so far I haven't faced layouts that I could not implement using flexbox.
      • ffsm8 6 hours ago
        But flex grow and align stretch exist, which moves control back to the parent...

        A grid really feels like a list flexes to me too, functionally.

    • sings 7 hours ago
      I agree. I occasionally turn to them to see if they work in a new setting, but find they never expose the features of a grid I would find useful. Everything must be manually placed, rather than allowing content to intelligently snap to multiple axes. Possibly I never have grasped some fundamental concept, possibly they are not suited to the sorts of layouts I usually work on. But more and more I feel they are designed to fulfil some purpose orthogonal to what I would need them to do.
  • hollowturtle 4 hours ago
    From the example:

      .grid {
        display: grid;
        grid-template-columns: 35% 1fr 1fr 1fr;
      }
    
      .grid header {
        grid-row: 1 / 3;
      }
    
      .grid ul {
        grid-row: span 2;
        grid-column: span 3;
        display: grid;
        grid-template-rows: subgrid;
        grid-template-columns: subgrid;
      }
    
    I swear you that I had less hard time reading x86 assembly code or even c++ templates. I mean what the hell? Then if you go look at another example:

    > @media (max-width: 32rem)

    I know what rem means, I just don't know what the hell MAY mean, that alone in a big project will make you hate your job as sometimes it's more easier predicting what the response of an LLM may be than what styling an element will have on a live page

    [Edit] I'm not confusing rem with em, em are even worse, but still hard predicting what a rem might be, before arguing we shouldn't I'd like to stress out we should once it's used like that "@media (max-width: 32rem)"

    [Edit2] Instead of just downvoting why don't you reply with your counter arguments? I really am interested in hearing what you have to say

  • HenriTEL 3 hours ago
    Ah yes, a new css concept! I love this kind of article that invariably contains this kind of statement:

    > This is mind-bending stuff, but it becomes intuitive with a bit of practice.

    The problem is not the language, it's just that you did not spend enough time to learn it the proper way.

  • lofaszvanitt 8 hours ago
    When I see the grid syntax, I just wanna jump off a cliff. Who created this abomination and why? We need trials to check whether these were the output of humans or some synthetics pretending to be humans.
    • alwillis 7 hours ago
      Yes, the syntax takes a while to get used to; they were attempting to cover several different use cases.

      You can use ASCII art to “draw” your layout if you want to, which is quite accessible [1].

      [1]: “Grid: how grid-template-areas offer a visual solution for your code” — https://webkit.org/blog/17620/grid-how-grid-template-areas-o...

    • alwillis 7 hours ago
      Layout Land [1] is a great set of videos that explains CSS Grid

      [1]: https://m.youtube.com/layoutland

    • hexasquid 7 hours ago
      It's quite straightforward to find the discussions that lead to the specs, if you're interested in participating.
    • hollowturtle 4 hours ago
      I sympathize with your comment and imagine the overflowing downvotes as soon you openly critic the web/css/javascript and their people doing the standard. I watched tons of videos and read a lot on mdn about css grid, I don't touch it for a while I need to go back at it again... After tables/floats/abs positioning eventually convoluted flex we should have stopped and review what the heck people were doing on w3c, it's artificial complexity we don't deserve that
  • kumarvvr 10 hours ago
    How is this different to, and better than using nested grids?
    • psolidgold 10 hours ago
      This is addressed in the article. This really shines when you have sibling dependent layouts.
    • laszlokorte 2 hours ago
      If you nest two grids, the rows and columns of two sibling grids are not forced two align.

      With subgrid the rows and columns of two sibling grids are aligned with each other by glueing them to the rows and columns of the parent grid.

  • kafkaesque 43 minutes ago
    Am I the only one who sees "content boxes"/divs with content displayed in different widths as poor design? At least in the example given, I would think you would want the image and its associated content box to be the same size for all four and not have its content vary in width based on how much content it has.

    But in terms of functionality, I'm sure there are plenty applications for this!

  • scotty79 5 hours ago
    Have we reached the point where we can fully simulate quirks mode table behavior?
  • t1234s 10 hours ago
    is grid intended to replace flex at some point or live side by side
    • SquareWheel 10 hours ago
      They're complimentary. As a general (though not exclusive) rule, consider flex for one-dimensional layouts, and grids for two-dimensional layouts.
      • psygn89 9 hours ago
        Yeah, to expand on that... Flex is, well, flexible, whereas Grid is more rigid like a table. The rigidity of Grid allows you to span rows and columns (2D) just like you can with table cells (colspan/rowspan). Grid is usually used at a macro level for its more deterministic layout (no unintuitive flex quirks), while flex is usually used to lay things out at a component level where you don't care that the next row of items isn't perfectly aligned with the ones above (you will often see it hold some buttons or badges, or vertically align text to an icon), and Grid setting the layout of the app and container components (modals, cards, etc).
        • taftster 9 hours ago
          So is Grid supposed to be what we should use to replace the html <table> element? That I still use to this day for layouts because CSS still sucks to me?
          • dsego 16 minutes ago
            It's more like a comic book, you define the layout and the elements slot into that. You can define how many rows and columns your comic has and then you can make some panels fit exactly into one spot, or you can have panels that span more than one row or column. So it's more of a 2d design system.

            https://l-wortley0811-dp.blogspot.com/2010/10/comic-layoutsj...

          • psygn89 8 hours ago
            Use <table> for tabular data, but for layout you should use grid. Grid doesn't have it's own element like table does, so you have to use css to apply that display to a div.

            CSS takes a bit of time to understand. It's cascading nature and how certain properties behave differently based on the html structure or display type or direction makes it tricky. I don't blame you sticking with tables for layouts for yourself - making layouts with floats was a pain. Bootstrap hid a lot of the layout pain. But today we have flex and grid to help us realize our layouts.

            • Akronymus 3 hours ago
              > Grid doesn't have it's own element like table does, so you have to use css to apply that display to a div.

              Well, OOTB, yeah. I personally like to make use of custom html elements a lot of the time for such things. Such as <main-header> <main-footer> <main-content> <content-header> etc, and apply css styles to those, rather than putting in classes onto divs. Feels a lot more ergonomic to me. Also gives more meaningful markup in the html. (and forces me to name the actual tags so I use much less unnecessary ones)

              • moron4hire 1 hour ago
                One of the many things I hate about React: can't easily create custom elements that truly exist in the DOM so I can style them in CSS.
            • antod 5 hours ago
              There were back in CSS 2 display values for table, table cell, table row etc which meant you could make divs or other block elements layout like tables did. Of course it wasn't supported in a certain browser with 90% market share.
          • paulhebert 8 hours ago
            No. The table is meant to hold tabular data like a spreadsheet. It has special behavior for people who use tools like screen readers because they have vision impairment.

            CSS grid is a powerful layout tool. If you think CSS sucks I encourage you to brush up on the newer developments. Flex box and grid and many other newer tools solve a lot of the classic pain points with CSS and make it a pleasure to use if you invest the time to learn it

    • Brajeshwar 9 hours ago
      I use this thumb-rule while explaining them — Grid to Lay Layouts of distinct UI Blocks; while Flex is to layout contents, sometimes a continuous set of content.
    • moi2388 6 hours ago
      Live side by side unfortunately. I personally however always use grid, flexbox sucks.
      • dsego 3 hours ago
        Flexbox is great for stacking and distributing elements vertically or horizontally, especially when you don't know how many there are.
      • system2 6 hours ago
        Can you get the same alignment properties with the grid? If so, I will use the grid more often.