:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import clsx from 'clsx'
import React, { useCallback, useLayoutEffect, useRef, useState } from 'react'
// see https://github.com/PostHog/posthog/pull/20359/files#r1490894232 for a visual example of what this is trying to
// solve
// if 5 items are to be evenly distributed across a container that has space for 4, just naively using flex will result
// in a 4-1 split, whereas this component will distribute them 3-2
// Sadly, the technology to do this with pure CSS has not been invented or discovered yet.
export const EvenlyDistributedRows = ({
children,
minWidthRems,
className,
maxItemsPerRow,
}: {
children: React.ReactNode[]
minWidthRems: number
className: string
maxItemsPerRow?: number
}): JSX.Element => {
const [rowLayout, setRowLayout] = useState<{ itemsPerRow: number; numRows: number }>()
const elementRef = useRef<HTMLDivElement>(null)
const updateSize = useCallback((): void => {
if (!elementRef.current) {
return
}
const pxPerRem = parseFloat(getComputedStyle(document.documentElement).fontSize)
const minWidthPx = minWidthRems * pxPerRem
const containerWidthPx = elementRef.current.offsetWidth
const calculatedMaxItemsPerRow = Math.floor(containerWidthPx / minWidthPx)
const effectiveMaxItemsPerRow = maxItemsPerRow
? Math.min(calculatedMaxItemsPerRow, maxItemsPerRow)
: calculatedMaxItemsPerRow
// Distribute items evenly
// e.g. if we can have 4 elements per row and have 9 items
// prefer 3,3,3 to 4,4,1
const numRows = Math.ceil(children.length / effectiveMaxItemsPerRow)
const itemsPerRow = Math.min(Math.ceil(children.length / numRows), effectiveMaxItemsPerRow)
setRowLayout({
numRows,
itemsPerRow,
})
}, [setRowLayout, elementRef, minWidthRems, children.length, maxItemsPerRow])
// Layout effect, not effect: the first commit has no children (the column count is unknown
// until the container is measured). Measuring before paint means the browser never paints the
// empty container, so the rows appearing does not count as a layout shift. With useEffect the
// empty frame was painted and everything below the grid moved down when the rows arrived.
useLayoutEffect(() => {
const element = elementRef.current
if (!element) {
return
}
updateSize()
let resizeObserver: ResizeObserver | undefined
if (typeof ResizeObserver !== 'undefined') {
resizeObserver = new ResizeObserver(updateSize)
}
resizeObserver?.observe(element)
return () => {
resizeObserver?.unobserve(element)
}
}, [updateSize])
return (
<div
className={clsx('grid', className)}
// eslint-disable-next-line react/forbid-dom-props
style={{ gridTemplateColumns: `repeat(${rowLayout?.itemsPerRow ?? 1}, 1fr)` }}
ref={elementRef}
>
{rowLayout ? children : null}
</div>
)
}