angular/components

docs-bug(CdkPortal): @ViewChild() returns undefined when using *cdkPortal instead of <ng-template cdkPortal>

Open

#21,092 创建于 2020年11月19日

在 GitHub 查看
 (3 评论) (0 反应) (0 负责人)TypeScript (24,044 star) (6,650 fork)batch import
P3area: cdk/portaldocsgood first issuehelp wanted

描述

The official doc says:

However, @ViewChild('theElementRef') binds to undefined when I use the *cdkPortal notation, while it works when I use <ng-template cdkPortal>

I suspect *cdkPortal makes the element to leave the page before afterViewInit(). Maybe the documentation should encourage using the <ng-template> form instead.

Affected documentation page: https://material.angular.io/cdk/portal/overview#portals-in-practice

贡献者指南

技术栈
typescriptangular
领域
documentationfrontend
议题类型
documentation
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
1
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
under 1 hour
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
Angular basicsCdkPortal usage
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
90
研究方向
The issue suggests that the official documentation should be updated to clarify that `@ViewChild` only works with `<ng template cdkPortal>` syntax, not with `*cdkPortal`. A contributor should review the portal overview documentation page (https://material.angular.io/cdk/portal/overview#portals in practice) and modify the text to explicitly note this limitation. No code changes are required.