本文介绍如何基于 Angular CDK Drag and Drop 对固定声明的子组件（如 等）实现可视化拖拽排序，并通过 index 输入绑定与 moveItemInArray 工具函数维护顺序状态，支持后续读取和持久化。
本文介绍如何基于 angular cdk drag and drop 对固定声明的子组件（如 `
在 Angular 应用中，当子组件以静态模板形式声明（如
✅ 正确做法：绑定 cdkDrag + 显式 index 输入
首先，为每个子组件添加 cdkDrag 指令，并通过 [index] 输入传递其初始逻辑序号（从 0 开始）：
<div cdkdroplist> <app-1-card cdkdrag></app-1-card><app-2-card cdkdrag></app-2-card><app-3-card cdkdrag></app-3-card><app-4-card cdkdrag></app-4-card> </div>
⚠️ 注意：cdkDropList 必须包裹所有可拖拽项，且每个子组件必须同时声明 cdkDrag —— 否则拖拽行为不会触发。
接着，在每个子组件类中定义 @Input() index: number，用于接收并（可选）在模板中展示或参与业务逻辑：
// app-1-card.component.ts
import { Component, Input } from '@angular/core';
@Component({
selector: 'app-1-card',
template: `
<div class="card" cdkdraghandle>
<span>Card #1 (Index: {{ index }})</span>
<p>{{ input }}</p>
</div>
`,
})
export class App1CardComponent {
@Input() input!: string;
@Input() index!: number; // 关键：接收并保留当前顺序索引
}
其他卡片组件（app-2-card、app-3-card 等）同理实现，确保 index 输入一致可用。
? 处理拖拽事件：更新顺序状态
在父组件中，实现 onDrop 方法，利用 CDK 提供的 CdkDragDrop 事件对象获取 previousIndex 和 currentIndex，并调用 moveItemInArray 工具函数更新你的顺序数组：
import { Component } from '@angular/core';
import { CdkDragDrop, moveItemInArray } from '@angular/cdk/drag-drop';
@Component({
selector: 'app-parent',
templateUrl: './parent.component.html',
})
export class ParentComponent {
input = 'Shared data';
// 初始顺序：对应组件声明顺序 [0, 1, 2, 3]
order: number[] = [0, 1, 2, 3]; // ✅ 这是你要持久化的“顺序状态”
onDrop(event: CdkDragDrop<number>) {
// 更新本地 order 数组
moveItemInArray(this.order, event.previousIndex, event.currentIndex);
// ✅ 可立即保存到 localStorage 或发送至后端
localStorage.setItem('cardOrder', JSON.stringify(this.order));
}
}</number>
? moveItemInArray 是 CDK 内置的纯函数，安全修改数组而不产生副作用；它不依赖 DOM，只操作数据，因此完全契合响应式状态管理思路。
? 恢复上次排序（可选增强）
应用启动时，可从存储中读取 order 并按需重新渲染（虽然本例中组件仍静态声明，但 index 值已随 order 动态调整）：
ngOnInit() {
const saved = localStorage.getItem('cardOrder');
if (saved) {
this.order = JSON.parse(saved);
}
}
此时，你虽未改变模板结构，但通过 index 属性与 order 数组的协同，实现了逻辑顺序与 UI 顺序的一致性映射——这正是静态组件拖拽排序的关键抽象。
? 注意事项总结
- ❌ 不要尝试通过 ViewChildren 查询元素再手动移动 DOM 节点：CDK 的拖拽逻辑会与手动 DOM 操作冲突，且破坏 Angular 变更检测。
- ✅ 所有 cdkDrag 元素必须位于同一个 cdkDropList 容器内，否则跨容器拖拽需额外配置 cdkDropListGroup。
- ✅ index 输入值本身不控制渲染顺序，但它为业务逻辑提供上下文（如排序后生成 API 请求 payload、高亮当前位次等）。
- ✅ 若需支持多列/分组拖拽，应改用 cdkDropListGroup 并为各列表设置唯一 id，同时在 drop 事件中判断 event.container.id。
通过以上模式，你既能保持模板简洁性与组件封装性，又能获得完整、可测试、可持久化的拖拽排序能力。
