PAYATHON 2026

Angular 动态创建组件的 signal 输入为何不更新?

数据小陈

结论

动态组件不更新,原因就出在这一句:componentRef.setInput('value', this.value()) 只在 ngAfterViewInit 里执行了一次,传进子组件的是当时 signal 的字符串快照。setInput() 做的是命令式赋值,不是模板那种响应式绑定,它不会自己去订阅父组件的 value signal。后面再调 this.value.set('Updated value'),改的只是父组件的 signal,新值没有重新写进动态子组件,子组件自然还停在 Initial value。

OnPush 不是根因,只是会让“没有新输入、也没有标记检查”这类情况表现得更明显。别想着用手动 detectChanges() 兜底,比较稳妥的做法是用 effect() 或 inputBinding() 把两边同步起来。

原因拆解

  • ViewContainerRef.createComponent() 只负责创建组件实例,不会自动把父组件的 signal 绑定到子组件 input。
  • this.value() 只是读取当前值。读一次并不会让动态子组件变成这个 signal 的依赖方。
  • setInput() 把传入的值写进 input,并参与后续变更检测,但它不是持续绑定。
  • 子组件的 value = input<string>() 是输入信号,值来自父方写入。父方不再写入,它就不会变。
  • 在 OnPush 下,只要再次正确调用 setInput(),输入会更新,检查也会被标记;前提是你确实又调用了一次。

推荐做法一:用 effect 同步 setInput

在父组件里注入 Injector,创建动态组件之后用 effect() 监听 signal,并在 effect 里调用 setInput():

import {
  AfterViewInit,
  ChangeDetectionStrategy,
  Component,
  ViewChild,
  ViewContainerRef,
  signal,
  effect,
  inject,
  Injector
} from '@angular/core';
import { DynamicComponent } from './dynamic.component';

@Component({
  selector: 'app-parent',
  standalone: true,
  template: `
    <button (click)="updateValue()">Update</button>
    <ng-container #container></ng-container>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush
})
export class ParentComponent implements AfterViewInit {
  @ViewChild('container', { read: ViewContainerRef })
  container!: ViewContainerRef;

  private readonly injector = inject(Injector);
  value = signal('Initial value');

  ngAfterViewInit(): void {
    const componentRef = this.container.createComponent(DynamicComponent);

    effect(() => {
      componentRef.setInput('value', this.value());
    }, { injector: this.injector });
  }

  updateValue(): void {
    this.value.set('Updated value');
  }
}

effect 第一次执行时写入 Initial value,之后每次 this.value.set(...) 都会让它再跑一遍,把新值通过 setInput() 写进动态子组件。

推荐做法二:用 inputBinding 声明动态绑定

如果你用的 Angular 18 版本支持 inputBinding,可以在 createComponent() 时直接建立响应式 input 绑定:

import { inputBinding } from '@angular/core';

ngAfterViewInit(): void {
  this.container.createComponent(DynamicComponent, {
    bindings: [
      inputBinding('value', () => this.value())
    ]
  });
}

inputBinding 的回调会在变更检测中读取 this.value(),signal 一变,新值就同步到动态组件的 input。这个 API 能不能用,取决于当前 Angular 18 的具体小版本;项目里没有的话,用上面的 effect() 方案就行。

注意事项

  • 如果动态组件可能比父组件先销毁,建议把 effect 返回的 EffectRef 存下来,在组件销毁时调用 destroy();或者在 effect 里判断 componentRef.hostView.destroyed,避免继续往已经销毁的实例写值。
  • 不要把 componentRef.changeDetectorRef.detectChanges() 当成常规方案。它只能强制刷新,建立不了 signal 到 input 的同步关系。
  • 如果你只是想把 signal 当作值传一次,现在的写法没问题;要持续同步,就得让 setInput() 在 signal 变化时再执行一次,或者改用 inputBinding 这类动态绑定 API。
  • 子组件保持 input<string>() 和 OnPush 不动即可。问题出在父方只写入了一次输入,子组件的模板读取方式并没有问题。

备注:内容仅供参考。