STRML/react-grid-layout
22,320 estrellas·2,709 forks·TypeScript·MIT·7 vistasreact-grid-layout.github.io/react-grid-layout/examples/00-showcase.html↗
React Grid Layout
React Grid Layout is a draggable and resizable grid system for React that organizes components into a coordinate-based layout. It functions as a responsive layout manager and a serialized grid state engine, providing the tools necessary to create user-customizable workspaces where interface elements can be moved and resized.
The system distinguishes itself through breakpoint-driven layout mapping, which adjusts grid configurations based on container width. It utilizes a serialized state model to convert spatial positions and dimensions into data formats for saving and restoring user layouts, and employs collision-aware compaction algorithms to resolve overlaps and eliminate empty space during interactions.
The project covers broad capability areas including interactive widget management, movement boundary constraints, and custom positioning strategies. It also provides user interface utilities such as resize handles and SVG background overlays to visualize the underlying grid structure.
Features
- Draggable Layout Elements - Enables users to interactively drag and reposition grid widgets to customize their workspace layout.
- Widget Frameworks - Provides a framework for building user-customizable workspaces with draggable and resizable interface elements.
- Layout Persisters - Converts current grid item positions and sizes into a data format for saving and restoring user-defined layouts.
- Grid Packing Algorithms - Provides collision-aware compaction algorithms that automatically rearrange grid items to fill empty space and resolve overlaps.
- Absolute Positioning - Uses absolute coordinates and CSS transforms to place grid elements precisely within a virtual unit system.
- Grid Layout Engines - Functions as an engine that converts spatial grid positions into serializable data for layout restoration.
- Grid Layouts - Implements a coordinate-based grid system for React to organize components into a draggable and resizable layout.
- Layout State Serialization - Represents grid positions and dimensions as a JSON-serializable array for easy storage and restoration of user layouts.
- Element Resizers - Provides interactive resize handles on element edges to update the dimensions of grid cells.
- Grid Item Resizers - Provides interactive resize handles that allow users to adjust the width and height of grid widgets.
- Responsive Breakpoints - Implements an architectural mapping of responsive breakpoints to switch between distinct grid configurations based on container width.
- Responsive Grid Systems - Organizes web page elements into a responsive grid that automatically rearranges based on different screen breakpoints.
- Responsive Layouts - Manages adaptive layout configurations that adjust grid structures based on container size and predefined breakpoints.
- Custom Compaction Strategies - Allows the application of custom algorithms to control the shifting and packing of items after drag or resize events.
- Boundary Validation - Constrains dragging and resizing movements to ensure elements cannot be moved outside the visible container area.
- Customizable Workspaces - Enables the creation of personalized dashboards where users can drag and resize widgets to customize their workspace.
- Drag Boundary Constraints - Restricts the movement and resizing of grid elements to keep them within the boundaries of the parent container.
- Interactive Widgets - Manages a system of draggable and resizable UI components that snap to a grid and avoid overlapping.
- Manual Positioning - Supports manual positioning strategies, enabling developers to specify element placement via transforms or absolute coordinates.
- User-Defined Layouts - Allows users to save and restore their preferred arrangement of screen elements by serializing layout positions.
- Grid Layouts - Draggable and resizable grid system with responsive breakpoints.
