How metafizzy/packery works
Packery is a browser bin-packing layout library. An application initializes Packery on a DOM container, after which the layout controller measures items, packs their rectangles, and positions them in the container. Optional draggable integrations feed movement events back into Packery, which computes drop targets and relays the final placement. The excerpts directly support the core layout, geometry, item lifecycle, stamping, resizing, and drag flow; declarative and jQuery entry behavior is represented through the documented/demo integrations.
Main entry points: packery.js Packery Controller · item.js Packery Item · rect.js Rectangle Geometry · jquery-main.js jQuery Bridge
Components 13
Layout API
- jQuery Bridge
sandbox/browserify/jquery-main.js - Packery Controller
js/packery.js - Outlayer Runtime
Packing Engine
- Bin Packer
js/packer.js - Rectangle Geometry
js/rect.js
Item Lifecycle
- Packery Item
js/item.js - Size Measurement
Drag Interaction
- Drag Source
- Drop Packer
js/packery.js - Drop Placeholder
js/item.js
Other components
- Application
- DOM Container
- jQuery UI Draggable
Connections 20
- Application → Packery Controller: initializes
- Application → jQuery Bridge: registers plugin
- jQuery Bridge → Packery Controller: invokes API
- Packery Controller → DOM Container: lays out items
- Packery Controller → Outlayer Runtime: creates layout
- Packery Controller → Packery Item: manages items
- Packery Controller → Size Measurement: measures elements
- Packery Controller → Bin Packer: packs rectangles
- Packery Controller → Rectangle Geometry: creates rectangles
- Packery Item → Outlayer Runtime: extends item
- Packery Item → Rectangle Geometry: stores geometry
- Size Measurement → DOM Container: reads dimensions
- Bin Packer → Rectangle Geometry: updates spaces
- Drag Source → Packery Controller: sends drag events
- jQuery UI Draggable → Drag Source: provides events
- Packery Controller → Drop Packer: computes drop targets
- Drop Packer → Rectangle Geometry: packs targets
- Packery Controller → Drop Placeholder: positions placeholder
- Drop Placeholder → DOM Container: renders feedback
- Packery Controller → Packery Item: positions items