From 4da805243a22ded3f44ef9515fc7443ea14a456e Mon Sep 17 00:00:00 2001 From: Erik Pintar Date: Thu, 25 Jul 2019 17:00:30 -0400 Subject: [PATCH] docs(core): clarify @ContentChild(ren) behavior (#31846) Describe that @ContentChild(ren) doesn't search within other component templates (doesn't go across "component boundaries"). PR Close #31846 --- packages/core/src/metadata/di.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/core/src/metadata/di.ts b/packages/core/src/metadata/di.ts index 0d4abd05d9..f3fc53925b 100644 --- a/packages/core/src/metadata/di.ts +++ b/packages/core/src/metadata/di.ts @@ -132,6 +132,9 @@ export interface ContentChildrenDecorator { * * Content queries are set before the `ngAfterContentInit` callback is called. * + * Does not retrieve elements or directives that are in other components' templates, + * since a component's template is always a black box to its ancestors. + * * **Metadata Properties**: * * * **selector** - The directive type or the name used for querying. @@ -194,6 +197,9 @@ export interface ContentChildDecorator { * * Content queries are set before the `ngAfterContentInit` callback is called. * + * Does not retrieve elements or directives that are in other components' templates, + * since a component's template is always a black box to its ancestors. + * * **Metadata Properties**: * * * **selector** - The directive type or the name used for querying.