本文介绍在 angular 中不依赖 `[(ngmodel)]` 或 `[checked]` 绑定时，如何通过模板引用变量精准控制 matcheckbox 的选中状态、视觉更新及 change 事件触发，并避免点击区域误操作。
在使用 *ngFor 遍历 Map（如 deselectedList | keyvalue）时，由于无法直接绑定 [checked]（缺少稳定索引或对象引用），开发者常试图通过原生 DOM 操作（如 document.getElementById() + dispatchEvent）模拟用户交互。但这种方式存在两个关键问题：
- 视觉不同步：仅派发 change 事件不会改变 <mat-checkbox> 的内部状态和 UI；
- Angular 生命周期脱节：MatCheckbox 是封装组件，其状态由 @Input() 和内部逻辑管理，原生事件无法穿透到其 Angular 控制层。
✅ 正确解法是：使用模板引用变量（#checkbox）获取 MatCheckbox 实例，调用其公开方法 toggle() 或直接设置 checked 属性，并手动触发业务逻辑。
✅ 推荐实现（语义清晰、状态可控）
<div
*ngFor="let cus of deselectedList | keyvalue"
(click)="handleCheckboxClick(checkbox, cus.key, cus.value)">
{{ cus.key }}
<mat-checkbox
id="customer_{{cus.key}}_checkbox"
class="cus-check float-checkbox-right"
#checkbox>
</mat-checkbox>
</div>// component.ts
handleCheckboxClick(checkbox: MatCheckbox, key: string, value: any): void {
checkbox.toggle(); // 自动切换 checked 状态并更新 UI
this.deselectCheck(checkbox.checked, key, value); // 同步执行业务逻辑
}? MatCheckbox.toggle() 不仅更新 checked 属性，还会触发内部 change 事件（即 (change) 输出），确保与模板绑定完全一致。
⚠️ 关键注意事项
-
禁用 checkbox 默认点击响应：为防止用户直接点击复选框导致重复触发（<div> 点击 + <mat-checkbox> 自身点击），需在 CSS 中添加：
.cus-check { pointer-events: none; }这样点击复选框区域实际触发的是外层 <div> 的 (click)，保证逻辑统一。
不要用 dispatchEvent(new Event('change'))：该方式仅触发事件监听器，但 MatCheckbox 的 checked 状态、indeterminate、UI 样式均不受影响，属于“假触发”。
避免 getElementById + 强制类型断言：<mat-checkbox> 渲染后并非原生 <input type="checkbox">，而是自定义元素（含 Shadow DOM 或复杂结构），HTMLInputElement 类型断言会失败或行为不可控。
✅ 扩展：批量操作与状态同步
若需程序化设置多个 checkbox 状态（如“全选/反选”），可结合 ViewChildren：
@ViewChildren('checkbox') checkboxes!: QueryList<MatCheckbox>;
selectAll() {
this.checkboxes.forEach(cb => cb.checked = true);
// 注意：此时 change 事件不会自动触发，需手动调用业务函数
this.updateAllSelections();
}总结
- ✅ 用 #checkbox 模板变量 + toggle() / checked = true|false 是唯一可靠、Angular 原生支持的控制方式；
- ✅ 外层容器点击 + pointer-events: none 是解决“无绑定遍历场景”交互一致性的最佳实践；
- ❌ 避免原生 DOM 事件派发，它绕过组件封装，破坏状态一致性。
此方案兼顾可维护性、可测试性与用户体验，符合 Angular 数据流设计哲学。
