ducksboard/gridster.js
Gridster.js
Gridster.js is a jQuery plugin that turns page elements into a draggable, resizable grid layout. It provides a framework for building interactive dashboards and interfaces where widgets snap to a multi-column grid and can be repositioned by dragging, with automatic layout reflow when items are added, removed, or resized.
The plugin handles mouse and touch events through a drag-and-drop manager, calculates widget overlap with a collision detection engine, and positions items using CSS transforms for smoother animations. It maintains an internal registry of all grid items with their coordinates and dimensions, divides the container width into equal columns based on a configurable count, and triggers layout recalculation on window resize or widget dimension changes through custom jQuery events.
Gridster.js supports adding and removing widgets at runtime without rebuilding the entire layout, and allows changing the width and height of grid items so the layout reflows automatically. It includes a serialization API that converts the current grid state into a JSON array of widget positions and dimensions for persistence.
Features
- jQuery Plugins - Extends jQuery's prototype chain to add grid layout methods directly to DOM element selections.
- Dashboard Grid Frameworks - Provides a framework for building interactive dashboards and interfaces with draggable, resizable grid items.
- Grid Drag-and-Drop Managers - Ships a drag-and-drop manager that handles mouse and touch events for widget repositioning with real-time feedback.
- jQuery Grid Layout Plugins - A jQuery plugin for building intuitive, multi-column grid layouts where elements can be dragged and resized.
- Draggable Grid Widgets - Arranges page elements into a multi-column grid that users can reposition by dragging.
- Runtime Widget Inserters and Removers - Supports adding and removing widgets at runtime without rebuilding the entire layout.
- Snap-to-Grid Draggable Layouts - Builds interactive page layouts where elements snap to a multi-column grid and can be repositioned by dragging.
- Grid Item Resizers - Provides interactive handles that allow users to modify the dimensions of individual grid cells with automatic layout reflow.
- Widget Layout Management - Manages dynamic addition, removal, and rearrangement of grid widgets at runtime without rebuilding the entire layout.
- jQuery Grid Widget Libraries - Turns page elements into draggable, resizable widgets within a dynamic grid system.
- Grid Layout Collision Detectors - Provides a collision detection engine that shifts adjacent widgets to fill gaps during drag operations.
- JavaScript Column Calculators - Divides the container width into equal columns based on a configurable column count and widget sizes.
- Positioning Transforms - Positions grid items using CSS transforms for smoother animations instead of absolute positioning.
- Grid Layout Resize Event Systems - Triggers layout recalculation on window resize and widget dimension changes through custom jQuery events.
- Dynamic Reflow Grid Builders - Creates flexible, multi-column grid layouts that automatically reflow when elements are added, removed, or resized.
- Widget Coordinate Registries - Maintains an internal registry of all grid items with their coordinates and dimensions for efficient lookups.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
