Masonry#
Data Display
@rockshin/tao-uiArranges cards of different heights into balanced columns.
This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with TaoProvider.
The 6.7.0 items/itemRender contract supports responsive columns and fresh resize tracking. Layout uses native positioning; DOM order remains the input order.
#When to use
Use for galleries or varied content cards where row alignment is unnecessary.
#Examples
#Balanced columns
Tile 1
Tile 2
Tile 3
Tile 4
Tile 5
Tile 6
TSX
import { Masonry } from "@rockshin/tao-ui";
const items = [100, 160, 80, 130, 90, 150].map((height, key) => ({
key,
height,
data: { title: `Tile ${key + 1}` },
}));
export default function Example() {
return (
<Masonry
columns={3}
gutter={16}
items={items}
itemRender={({ data }) => (
<div
style={{
height: "100%",
boxSizing: "border-box",
padding: 16,
borderRadius: 6,
background: "var(--tao-color-fill-secondary)",
}}
>
{data.title}
</div>
)}
/>
);
}#Responsive columns and gutters
TSX
import { Masonry } from "@rockshin/tao-ui";
const items = [100, 160, 80, 130, 90, 150].map((height, key) => ({
key,
height,
data: { title: `Tile ${key + 1}` },
}));
export default function Example() {
return (
<Masonry
columns={{ xs: 1, sm: 2, lg: 3 }}
gutter={[{ xs: 8, sm: 16 }, 16]}
items={items}
itemRender={({ data }) => (
<div
style={{
height: "100%",
boxSizing: "border-box",
padding: 16,
borderRadius: 6,
background: "var(--tao-color-fill-secondary)",
}}
>
{data.title}
</div>
)}
/>
);
}#Assign a column
Tile 1
Tile 2
Tile 3
Tile 4
Tile 5
Tile 6
TSX
import { Masonry } from "@rockshin/tao-ui";
const items = [100, 160, 80, 130, 90, 150].map((height, key) => ({
key,
height,
data: { title: `Tile ${key + 1}` },
}));
export default function Example() {
return (
<Masonry
columns={3}
gutter={16}
items={items.map((item, index) => ({
...item,
column: index === 0 ? 2 : undefined,
}))}
itemRender={({ data }) => (
<div
style={{
height: "100%",
boxSizing: "border-box",
padding: 16,
borderRadius: 6,
background: "var(--tao-color-fill-secondary)",
}}
>
{data.title}
</div>
)}
/>
);
}#Track changing content heights
TSX
import { useState } from "react";
import { Button, Masonry } from "@rockshin/tao-ui";
export default function Example() {
const [expanded, setExpanded] = useState(false);
return (
<div>
<Button
onClick={() => setExpanded(!expanded)}
style={{ marginBottom: 16 }}
>
Toggle details
</Button>
<Masonry
columns={{ xs: 1, sm: 2 }}
gutter={16}
fresh
items={[
{
key: "one",
data: 1,
children: (
<div
style={{
padding: 16,
background: "var(--tao-color-fill-secondary)",
borderRadius: 6,
}}
>
<h4>Details</h4>
{expanded ? (
<p>
A longer description changes the card height and the
following cards are positioned again.
</p>
) : (
<p>Short summary.</p>
)}
</div>
),
},
...[2, 3, 4].map((key) => ({
key,
data: key,
height: 80 + key * 12,
children: (
<div
style={{
height: "100%",
padding: 16,
boxSizing: "border-box",
background: "var(--tao-color-fill-secondary)",
borderRadius: 6,
}}
>
Card {key}
</div>
),
})),
]}
/>
</div>
);
}#Reorder and inspect layout
Tile 1
Tile 2
Tile 3
Tile 4
Tile 5
Tile 6
Item → column:
TSX
import { useState } from "react";
import { Button, Masonry } from "@rockshin/tao-ui";
const items = [100, 160, 80, 130, 90, 150].map((height, key) => ({
key,
height,
data: { title: `Tile ${key + 1}` },
}));
export default function Example() {
const [reversed, setReversed] = useState(false);
const [columns, setColumns] = useState("");
return (
<div>
<Button
onClick={() => setReversed(!reversed)}
style={{ marginBottom: 16 }}
>
Reverse items
</Button>
<Masonry
columns={2}
gutter={12}
items={reversed ? [...items].reverse() : items}
onLayoutChange={(order) =>
setColumns(
order.map((item) => `${item.key} → ${item.column + 1}`).join(", "),
)
}
itemRender={({ data }) => (
<div
style={{
height: "100%",
boxSizing: "border-box",
padding: 16,
borderRadius: 6,
background: "var(--tao-color-fill-secondary)",
}}
>
{data.title}
</div>
)}
/>
<p>Item → column: {columns}</p>
</div>
);
}#API
#Masonry
| Property | Description | Type | Default Value |
|---|