@angular/core

contentChild

Initializer API

Developer preview

Initializes a content child query. Consider using contentChild.required for queries that should always match.

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

          @Component({...})export class TestComponent {  headerEl = contentChild<ElementRef>('h');                    // Signal<ElementRef|undefined>  headerElElRequired = contentChild.required<ElementRef>('h'); // Signal<ElementRef>  header = contentChild(MyHeader);                             // Signal<MyHeader|undefined>  headerRequired = contentChild.required(MyHeader);            // Signal<MyHeader>}

contentChild<LocatorT>(locator: string | ProviderToken<LocatorT>, opts?: { descendants?: boolean; read?: undefined; }): Signal<LocatorT>;

Initializes a content child query.

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

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ descendants?: boolean; read?: undefined; }

@returnsSignal<LocatorT>

contentChild<LocatorT, ReadT>(locator: string | ProviderToken<LocatorT>, opts: { descendants?: boolean; read: ProviderToken<ReadT>; }): Signal<ReadT>;

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ descendants?: boolean; read: ProviderToken<ReadT>; }

@returnsSignal<ReadT>

contentChild.required<LocatorT>(locator: string | ProviderToken<LocatorT>, opts?: { descendants?: boolean; read?: undefined; }): Signal<LocatorT>;

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ descendants?: boolean; read?: undefined; }

@returnsSignal<LocatorT>

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

@paramlocatorstring | ProviderToken<LocatorT>

@paramopts{ descendants?: boolean; read: ProviderToken<ReadT>; }

@returnsSignal<ReadT>

Aug	SEP	Oct
	20
2023	2024	2025