GridList
Tiled card grids for people directories, item collections, and image galleries.
The tiles are a list, as in Tailwind UI, and each tile is one of its items: a screen reader announces the list with its number of tiles and moves through it tile by tile. A tappable tile is a button inside its item. The label prop names the list (for example "Team members").
A virtualized grid with a bounded height scrolls its tiles on its own. On the web, while those tiles overflow, the grid is a keyboard tab stop (before the tiles themselves when onPressItem or tile actions make them buttons), the keyboard can scroll it, and while it has keyboard focus the grid, which has no card around it, draws the theme's focus ring around itself. Only the tiles near its viewport are mounted, and each says where it sits in the whole grid, so a screen reader still counts every tile. Give a windowed grid a label: focused, a list with no name is named in Chromium from the text of every tile it has rendered, so the kit warns in development when it has none.
- Rachel ChenEngineering LeadActive
- Ada LovelaceStaff EngineerActive
- Kevin TurnerProduct DesignerAway
iOS
- Rachel ChenEngineering LeadActive
- Ada LovelaceStaff EngineerActive
- Kevin TurnerProduct DesignerAway
Android
- Rachel ChenEngineering LeadActive
- Ada LovelaceStaff EngineerActive
- Kevin TurnerProduct DesignerAway
Web
tsx
Default
Gallery
Tappable
Each tile action carries its own onPress, so every button on a card fires your handler.
Props
Do & Don’t
People (card grid)
Don’t
A fixed column count with hard-width cards overflows the row on narrow viewports instead of reflowing.
Do
- Rachel ChenEngineering Lead
- Ada LovelaceStaff Engineer
- Kevin TurnerProduct Designer
Let auto-fill minmax columns size to the available width so cards wrap cleanly at any breakpoint.
Image gallery
Don’t
Letting each thumbnail keep its intrinsic height makes a ragged grid and shifts the layout as images load.
Do
- hero-banner.png1.2 MB
- icon-set.svg340 KB
- product-shot.jpg2.8 MB
- avatar-default.png96 KB
Lock a consistent aspect ratio so the grid stays even and nothing reflows once thumbnails load.