286

我应该如何配置新的 Angular 8 view child?

@ViewChild('searchText', {read: ElementRef, static: false})
public searchTextInput: ElementRef;

对比

@ViewChild('searchText', {read: ElementRef, static: true})
public searchTextInput: ElementRef;

哪个更好?我什么时候应该使用static:truevs static:false

4

7 回答 7

338

在大多数情况下,您会想要使用{static: false}. 像这样设置它将确保找到依赖于绑定解析(如结构指令*ngIf, etc...)的查询匹配。

何时使用的示例static: false

@Component({
  template: `
    <div *ngIf="showMe" #viewMe>Am I here?</div>
    <button (click)="showMe = !showMe"></button>
  ` 
})
export class ExampleComponent {
  @ViewChild('viewMe', { static: false })
  viewMe?: ElementRef<HTMLElement>; 

  showMe = false;
}

static: false将是 Angular 9 中的默认后备行为。在此处此处阅读更多信息

引入该{ static: true }选项是为了支持动态创建嵌入式视图。当您动态创建视图并想要访问 时TemplateRef,您将无法这样做,ngAfterViewInit因为它会导致ExpressionHasChangedAfterChecked错误。将静态标志设置为 true 将在 ngOnInit 中创建您的视图。

尽管如此:

在大多数其他情况下,最佳做法是使用{static: false}.

请注意,尽管该{ static: false }选项将在 Angular 9 中设为默认值。这意味着不再需要设置静态标志,除非您想使用该static: true选项。

您可以使用 angular cling update命令自动升级您当前的代码库。

有关迁移指南甚至更多相关信息,您可以在此处此处查看

#静态查询和动态查询有什么区别?@ViewChild() 和 @ContentChild() 查询的静态选项确定查询结果何时可用。

使用静态查询 (static: true),一旦创建视图,但在更改检测运行之前,查询就会解析。但是,结果永远不会更新以反映对视图的更改,例如对 ngIf 和 ngFor 块的更改。

对于动态查询(静态:false),查询分别在 @ViewChild() 和 @ContentChild() 的 ngAfterViewInit() 或 ngAfterContentInit() 之后解析。结果将根据您的视图的更改进行更新,例如对 ngIf 和 ngFor 块的更改。


using 的一个很好的用例static: true是,如果您要使用fromEvent绑定到模板中定义的元素。考虑以下模板:

<div [ngStyle]="thumbStyle$ | async" #thumb></div>

然后,您可以处理此元素上的事件,而无需使用订阅或初始化挂钩(如果您不想或不能使用角度事件绑定):

@Component({})
export class ThumbComponent {
  @ViewChild('thumb', { static: true })
  thumb?: ElementRef<HTMLElement>;

  readonly thumbStyle$ = defer(() => fromEvent(this.thumb, 'pointerdown').pipe(
    switchMap((startEvent) => fromEvent(document, 'pointermove', { passive: true })
    // transform to proper positioning
  ));
}

使用很重要defer。这将确保 observable 仅在订阅时才被解析。这将发生在ngAfterViewInit被触发之前,当async管道订阅它时。因为我们正在使用static: true,所以this.thumb已经填充。

于 2019-05-29T11:31:57.530 回答
144

因此,根据经验,您可以选择以下内容:

  • { static: true }ViewChild当您要访问in时需要设置ngOnInit

  • { static: false }只能在ngAfterViewInit. *ngIf当您在模板中的元素上有一个结构指令(即 )时,这也是您想要的。

于 2019-07-18T07:50:32.197 回答
21

从角度文档

static - 是否在更改检测运行之前解析查询结果(即仅返回静态结果)。如果未提供此选项,编译器将退回到其默认行为,即使用查询结果来确定查询解析的时间。如果任何查询结果在嵌套视图中(例如 *ngIf),则查询将在更改检测运行后解析。否则,它将在更改检测运行之前解决。

static:true如果孩子不依赖任何条件,使用它可能是一个更好的主意。如果元素的可见性发生变化,则static:false可能会产生更好的结果。

PS:由于它是一项新功能,我们可能需要运行性能基准测试。

编辑

正如@Massimiliano Sartoretto 所提到的,github 提交可能会给你更多的见解。

于 2019-05-29T11:33:44.953 回答
3

来到这里是因为在升级到 Angular 8 后, ngOnInit 中的 ViewChild 为空。

静态查询在 ngOnInit 之前填充,而动态查询(静态:false)在之后填充。换句话说,如果在你设置 static:false 之后 viewchild 现在在 ngOnInit 中为 null,你应该考虑更改为 static:true 或将代码移动到 ngAfterViewInit。

https://github.com/angular/angular/blob/master/packages/core/src/view/view.ts#L332-L336

其他答案是正确的,并解释了为什么会出现这种情况:依赖于结构指令的查询,例如 ngIf 中的 ViewChild 引用,应该在该指令的条件已解决之后运行,即在更改检测之后。但是,可以安全地使用 static: true ,从而在 ngOnInit 之前解析未嵌套引用的查询。恕我直言,这个特殊情况值得一提,因为空异常可能是您遇到这种特殊性的第一种方式,就像对我一样。

于 2019-07-10T07:04:01.270 回答
2

查看子 @angular 5+ 标记两个参数('本地引用名称',静态:false|true)

@ViewChild('nameInput', { static: false }) nameInputRef: ElementRef;

要知道真假之间的区别检查这个

static - 是否在更改检测运行之前解析查询结果(即仅返回静态结果)。如果未提供此选项,编译器将退回到其默认行为,即使用查询结果来确定查询解析的时间。如果任何查询结果在嵌套视图中(例如 *ngIf),则查询将在更改检测运行后解析。否则,它将在更改检测运行之前解决。

于 2020-02-24T08:19:16.843 回答
2

在 ng8 中,您可以手动设置何时访问父组件中的子组件。当你设置 static 为 true 时,意味着父组件只在onInit钩子中获取组件的定义:例如:

 // You got a childComponent which has a ngIf/for tag
ngOnInit(){
  console.log(this.childComponent);
}

ngAfterViewInit(){
  console.log(this.childComponent);
}

如果 static 为 false ,那么您只能在 ngAfterViewInit() 中获得定义,在 ngOnInit() 中,您将获得未定义。

于 2020-03-23T04:52:42.327 回答
1

查看孩子

...可以将其用于模板元素引用。

...对于特定组件参考之外。

使用装饰器样式语法.. @ViewChild( selector) reference : ElementRef || QueryList.

特定组件或元素的引用。

中使用它AfterViewInIt()

我们可以在Oninit().

但这要具体使用ngAfterViewInit()

最后{static : false}应该放在@ViewChild( Useme , { static : false})... 以供模板变量引用。

模板文件中的变量看起来像。 #Useme.

于 2020-11-12T17:49:00.010 回答