官網 Demo:https://gridster.net/ (藍色區域白塊可隨意拖拽)
<script src="jquery-1.7.2.min.js"></script>
<script src="jquery.gridster.js"></script>
<link rel="stylesheet" href="style.css" /> <!-- 包含 gridster 基礎樣式 -->
<div class="gridster">
<ul id="dashboard">
<li data-row="1" data-col="1" data-sizex="1" data-sizey="1"><div class="handle">1</div></li>
<li data-row="2" data-col="1" data-sizex="1" data-sizey="1"><div class="handle">2</div></li>
<li data-row="3" data-col="1" data-sizex="1" data-sizey="1"><div class="handle">3</div></li>
<li data-row="1" data-col="2" data-sizex="2" data-sizey="1"><div class="handle">4 (寬2格)</div></li>
<li data-row="2" data-col="2" data-sizex="2" data-sizey="2"><div class="handle">5 (2x2)</div><p>內容...</p></li>
<li data-row="1" data-col="4" data-sizex="1" data-sizey="1"><div class="handle">6</div></li>
</ul>
</div>
屬性說明:`data-row/col` 起始位置 (1-based);`data-sizex/sizey` 佔用格數。
.gridster { position: relative; background: #ccc; min-height: 400px; }
.gridster > ul { list-style: none; margin: 0; padding: 0; }
.gridster li {
background: #fff; border: 2px solid #333;
box-sizing: border-box; /* 關鍵:含邊框在寬高內 */
/* 內容樣式自定 */
}
.handle { height: 30px; background: #eee; border-bottom: 1px solid #ccc; cursor: move; padding: 5px; font-weight: bold; }
/* Gridster 內部類別 (勿修改核心邏輯類別) */
.gs_w { position: absolute; } /* 元件包裹器 */
.preview-holder { opacity: 0.3; background: #fff; border: 2px dashed #999; } /* 拖拽預覽位置 */
.player-revert { z-index: 10!important; transition: left .3s, top .3s!important; } /* 歸位動畫 */
.dragging { z-index: 10!important; transition: none!important; } /* 拖拽中無動畫 */
$(function() {
var $grid = $(".gridster ul").gridster({
widget_margins: [5, 5], // 元件間距 [垂直, 水平]
widget_base_dimensions: [100, 100], // 基礎格尺寸 [寬, 高] (px)
min_cols: 6, // 最小列數 (響應式下限)
max_cols: 12, // 最大列數
min_rows: 3, // 最小行數
autogrow_cols: true, // 寬度不足時自動增列
autogenerate_stylesheet: true, // 自動生成定位 CSS
resize: { enabled: true, axes: ['both'], handle_append_to: '.handle' }, // 可調整大小
draggable: {
handle: '.handle', // 僅拖拽手柄觸發
start: function(e, ui) { console.log('開始拖拽', this); },
stop: function(e, ui) { console.log('結束拖拽', this); saveLayout(); }
}
}).data('gridster'); // 取得實例
// 動態添加元件
$('#addWidget').click(function() {
$grid.add_widget('New ', 1, 1); // sizex, sizey
});
// 序列化儲存
function saveLayout() {
var layout = $grid.serialize(); // [{col, row, size_x, size_y}, ...]
localStorage.setItem('dashboardLayout', JSON.stringify(layout));
console.log('佈局已儲存', layout);
}
// 載入佈局
var saved = JSON.parse(localStorage.getItem('dashboardLayout') || '[]');
if (saved.length) {
saved.forEach(function(w) {
$grid.add_widget('Loaded ', w.size_x, w.size_y, w.col, w.row);
});
}
});
| 方法 | 說明 |
|---|---|
| `add_widget(html, size_x, size_y, col, row)` | 添加元件,可指定位置/尺寸 |
| `remove_widget(el, silent)` | 移除元件,silent=true 不觸發回調 |
| `resize_widget(el, size_x, size_y)` | 調整元件尺寸 |
| `serialize()` | 返回陣列 `[{col, row, size_x, size_y}, ...]` |
| `disable()` / `enable()` | 禁用/啟用拖拽 |
| `destroy()` | 完全銷毀實例,恢復原始 DOM |
gridster.js 0.5.0+ 或修補 CSS:`.gs_w { outline: none; }`。| 庫 | 特點 | 框架整合 |
|---|---|---|
| GridStack.js | TypeScript 原生、觸控完美、響應式、調整大小、動畫、序列化 | React, Vue, Angular, Svelte 官方綁定 |
| Muuri | 極高性能、WebGL 加速、拖拽/排序/佈局統一、無依賴 | 原生 JS,易封裝 |
| React-Grid-Layout | React 專用、斷點響應式、靜態/動態佈局、服務端渲染友好 | React Hooks API |
| Vue-Grid-Layout | Vue 版 Grid-Layout | Vue 2/3 Composition API |