@jchn/simple-masonry-layout
v0.1.2
Published
Creating masonry layouts based on rectangles.
Downloads
4
Readme
SimpleMasonryLayout
Create masonry style layouts and render them any way you want.
Install
npm i @jchn/simple-masonry-layout
Creating the layout
SimpleMasonryLayout has one single function which is called getLayout
, this function will return an object describing the layout.
import { getLayout } from "@jchn/simple-masonry-layout";
const items = [
{ size: { width: 150, height: 200 }, data: null },
{ size: { width: 200, height: 150 }: data: null },
];
const layout = getLayout(items, 800, 3, { gutter: 10 });
getLayout<T>(
items: Item<T>[], // The input dimensions, oftentimes the width and height of an image
width: number, // The width of the grid
columns: number, // The number of columns
options?: Options // More options
) => Layout<T>
type Layout<T> = {
items: GridItem<T>[]
height: number
}
type Item<T> = {
size: Size,
data: T
}
type GridItem<T> = {
rect: Rect
data: T
}
type Size = {
width: number,
height: number
}
type Rect = {
x: number,
y: number,
width: number,
height: number
}
type Options = {
gutter: number, // x and y gutter
gutterX: number, // x gutter
gutterY: number, // y gutter
paddingY: number, // additional height added to rectangle
collapsing: bool, // if the elements should collapse into each other
centering: bool // if the elements should be centered if there are less items then columns
}
Now it's up to you to translate this layout object to something on screen using the DOM or a Canvas or anything else:
const container = document.querySelector(".container")
container.style.height = `${layout.height}px`
layout.items.forEach({ rect } => {
const div = document.createElement('div')
div.style.cssText = `
position: absolute;
top: ${rect.x};
left: ${rect.y};
width: ${rect.width}px;
height: ${rect.height}px;
border: 1px solid;
`
document.body.appendChild(div)
})