Connected Avatar Row
A headless overlapping avatar row layout (Structure layer).
Renders up to maxVisible avatars in a horizontal Row with negative spacing so that each avatar overlaps the previous one by overlap. When items.size exceeds maxVisible, an overflow indicator is rendered as the last element; the overflow indicator is produced by the overflow slot so that callers control its appearance. Each visible avatar is produced by the avatar slot, which receives the item, its index within the visible slice, and a Modifier that encodes the overlap offset.
This component makes no visual decisions — no colors, shapes, borders, or typography. It is the headless backbone that the Stylish Finish counterpart StylishConnectedAvatarRow consumes by supplying a styled avatar and overflow renderer. Supply your own slots to render a custom skin over the same overlapping geometry.
Parameters
The list of items to represent as avatars.
The maximum number of avatars to render before showing an overflow indicator. Defaults to 5. Must be at least 1.
The horizontal offset applied between consecutive avatars. Negative values cause avatars to overlap; positive values produce gaps. Defaults to (-8).dp.
A composable lambda that renders a single avatar. Receives the item, its index within the visible slice, and a Modifier that encodes the overlap offset and z-ordering.
A composable lambda that renders the overflow indicator shown when items.size > [maxVisible]. Receives the number of hidden items and a Modifier that encodes the overlap offset. Defaults to an empty box.
Type Parameters
The type of each item in the row.