YJDragGrid：一个灵活易用的Qt Widget 拖拽网格布局组件
YJDragGrid为 Qt Widgets 打造的优雅拖拽网格布局组件在桌面应用开发中仪表盘、配置面板、素材管理器等界面常需要用户自由排列卡片。虽然 Qt 提供了强大的QGridLayout但它本身并不支持拖拽重排这种交互。YJDragGrid正是为解决这一痛点而生的——一个基于 Qt Widgets 的可复用拖拽网格布局组件让你轻松实现类似浏览器首页或看板应用中的卡片拖拽体验。设计初衷补足 Qt 生态的关键一环YJDragGrid的定位并非替代QGridLayout而是补足 Qt Widgets 在“动态卡片网格”场景中的能力。它专注于处理少量到中等数量的QWidget卡片适合需要添加、删除和拖拽重排的界面例如仪表盘用户可自由排列各类数据图表卡片。配置面板通过拖拽调整功能模块的显示顺序。插件面板或素材管理器直观地组织和管理项目元素。核心特性开箱即用的流畅交互YJDragGrid提供了一套完整的拖拽布局解决方案主要特性包括流畅的拖拽重排在网格中随意拖拽卡片并伴有平滑的布局过渡动画。自动滚动将卡片拖拽至容器视口边缘时内容会自动滚动方便长列表操作。灵活的布局配置可自由设置列数、单元格最小尺寸并支持等分单元格以及不完整行填满整行。键盘辅助支持当卡片获得焦点时可使用Space键拾取方向键移动占位符Enter键落位Escape键取消操作提升了可访问性。纯 Qt Widgets 实现无任何第三方依赖兼容 Qt 5.15 与 Qt 6.x。快速上手构建与集成环境要求Qt 5.15 或 Qt 6.xCMake 3.16C17 编译器作为库集成到项目中方式一直接引入源码add_subdirectory(path/to/YJDragGrid) target_link_libraries(YourApp PRIVATE YJDragGrid::YJDragGrid)方式二安装后通过 CMake Package 使用# 安装库 cmake -S . -B build -DYJDRAGGRID_BUILD_EXAMPLESOFF cmake --build build --config Release cmake --install build --prefix /path/to/install # 在项目中使用 find_package(YJDragGrid CONFIG REQUIRED) target_link_libraries(YourApp PRIVATE YJDragGrid::YJDragGrid)基本用法示例在你的代码中使用非常简单#includeYJDragGrid/DragGridWidget.hauto*gridnewYJDragGrid::DragGridWidget(scrollArea,parent);grid-setDragEnabled(true);// 启用拖拽grid-setColumnCount(4);// 设置4列grid-addWidget(newMyCardWidget());丰富的 API满足定制化需求YJDragGrid提供了详尽的 API让你能精细控制行为和外观核心开关setDragEnabled()启用/禁用拖拽setColumnCount()设置列数。布局调整setMinimumCellSize()控制单元格最小尺寸setEqualCellSizeEnabled()控制是否等宽setFillIncompleteRowEnabled()控制最后一行元素的填充行为。交互反馈setGhostScale()设置拖拽时卡片的缩放比例setPlaceholderOpacity()和setPlaceholderPulseDuration()自定义占位符样式和脉冲动画。高级功能setDragHandle()可指定一个子控件作为拖拽手柄仅在特定区域按下才能拖动。事件通知通过orderChanged()、itemMoved(int from, int to)和orderUpdated()等信号轻松监听并保存用户最新的卡片顺序。未来规划与设计边界项目维护者已经明确了清晰的路线图v0.4.0 目标包括更完善的拖拽状态信号如dragStarted、dragFinished便于业务层同步保存状态。每卡片独立拖拽手柄支持为每个卡片指定自己的拖拽区域。便捷的查询与重排 API如indexOf(widget)和moveWidget(from, to)。更全面的边界测试与文档。同时项目也坦诚地说明了暂不计划支持的功能以保持核心的轻量和专注响应式列数、瀑布流、跨行/跨列卡片、QML 支持。大量数据项数千个的虚拟化渲染。结语YJDragGrid是一个设计精巧、文档齐全的开源项目它为 Qt Widgets 开发者提供了一站式的卡片拖拽布局解决方案。无论你是在开发需要灵活界面的桌面工具还是想为应用增添直观的交互方式YJDragGrid都值得一试。项目采用MIT 许可证自由且宽松。你可以访问其 GitHub 仓库 获取源码、运行演示程序并参与到贡献中来。下图是我改造的
)
