查询子节点与内容投影
viewChild/contentChild 用于需要真实节点或子组件 API 的边界,不是替代普通输入输出。查询结果的存在时机和销毁时机必须明确,读取 DOM 要放在合适生命周期。
实验:投影一个模板,切换条件后验证 query 更新和监听清理。
练习:设计一个只暴露 focus() 的有限命令接口。
核心机制与实现
viewChild 查询组件自己的视图,contentChild 查询父组件投影进来的内容;两者的来源和生命周期不同。查询结果可能暂时为空,条件分支切换后也会变化,因此不能在构造函数里假定节点永远存在。
ts
readonly input = viewChild<ElementRef<HTMLInputElement>>('searchInput')
focusSearch() { this.input()?.nativeElement.focus() }把 #searchInput 放进 @if 后切换条件,实验应看到查询从元素到 undefined 再恢复。若为查询结果注册 listener,要在结果变化和组件销毁时同时移除;更简单的表单输入优先用 input()/output(),不要为了传值引入命令式查询。
本节专属实验:把输入追到视图
在 Angular 组件中只保留本节主题的一条数据流:输入值、状态变更、模板读取和清理日志分别打印。先运行成功路径,再删除本节涉及的绑定或 provider,记录是模板编译、依赖注入还是运行时错误。
ts
const before = signal('idle')
const after = computed(() => before() === 'idle' ? 'ready' : 'busy')
effect(() => console.log('state', before(), after()))预期:before 改变时只重新计算依赖它的 computed;组件销毁后 effect 不再产生输出。
可运行实验
- 在组件、注入服务和路由切换之间记录实例创建与销毁。
- 对模板读取、signal 更新、Observable 订阅和 HTTP 请求分别加日志。
- 用 Angular 测试工具验证可访问性、错误状态、取消请求和 SSR/hydration 边界。
实验记录至少包含:环境版本、输入序列、预期结果、实际结果、失败截图或日志,以及修复后再次运行的结果。
练习
- 用自己的话画出本篇概念的依赖图,并标出一个可能产生重复执行或竞态的节点。
- 写一个最小测试覆盖成功、失败、取消/卸载三条路径;测试应断言可观察结果,而不是内部实现调用次数。
- 给出一个选择当前方案而不是替代方案的理由,并写下替代方案何时更合适。
下一步
完成本节练习后阅读本章答案,再继续本章下一节。