指南

布局数据由应用维护。拖拽或缩放时，GridLayout 会发出有效的布局变更，并等待新值通过属性传回。

构建第一个栅格

01安装并引入添加依赖，再选择局部或全局注册组件。02绑定受控布局定义栅格项坐标，绑定 v-model:layout，再选择插槽。03运行基础示例拖拽和缩放栅格项，再打开并复制最简示例。04使用完整方案参考受控布局、响应式、编程式、无头渲染或 Core API 的完整工作流。

查询 API

需要确认类型、默认值或事件签名时，直接查看参考页。

API 索引查找 v2 公开符号，或按任务选择合适的 API。→属性GridLayout、GridItem 与 GridBackground 的输入、默认值、类型、压缩器和定位策略。→事件布局更新，以及移动和缩放栅格项时的交互生命周期事件。→方法编程式组件命令和受控事务回执。→组合式函数无头布局、响应式状态和容器宽度观测。→操作契约结果状态、拒绝原因、revision 和结构化错误。→Core API无 DOM 的校验、规范化、碰撞、压缩和几何换算。→

定制样式或迁移旧版本

定制样式设置栅格项状态和交互反馈。按任务看示例每个功能都有一个可运行的小示例。迁移指南替换已移除的 API，并核对行为变化。