@angular/core

viewChild

Initializer API

Developer preview

Initializes a view child query.

Consider using viewChild.required for queries that should always match.

Create a child query in your component by declaring a class field and initializing it with the viewChild() function.

          @Component({template: '<div #el></div><my-component #cmp />'})export class TestComponent {  divEl = viewChild<ElementRef>('el');                   // Signal<ElementRef|undefined>  divElRequired = viewChild.required<ElementRef>('el');  // Signal<ElementRef>  cmp = viewChild(MyComponent);                          // Signal<MyComponent|undefined>  cmpRequired = viewChild.required(MyComponent);         // Signal<MyComponent>}

viewChild<LocatorT>(locator: string | ProviderToken<LocatorT>): Signal<LocatorT>;

Initializes a view child query. Consider using viewChild.required for queries that should always match.

@paramlocatorstring | ProviderToken<LocatorT>

@returnsSignal<LocatorT>

viewChild<LocatorT, ReadT>(locator: string | ProviderToken<LocatorT>, opts: { read: ProviderToken<ReadT>; }): Signal<ReadT>;

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ read: ProviderToken<ReadT>; }

@returnsSignal<ReadT>

viewChild.required<LocatorT>(locator: string | ProviderToken<LocatorT>): Signal<LocatorT>;

@paramlocatorstring | ProviderToken<LocatorT>

@returnsSignal<LocatorT>

viewChild.required<LocatorT, ReadT>(locator: string | ProviderToken<LocatorT>, opts: { read: ProviderToken<ReadT>; }): Signal<ReadT>;

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ read: ProviderToken<ReadT>; }

@returnsSignal<ReadT>

Aug	SEP	Oct
	20
2023	2024	2025