Title: Document what is
Open Graph Title: Document what is
X Title: Document what is
Description: Searching for ng-content on https://angular.io/docs/ts/latest/ doesn't produce any useful results and if I'm not mistaken there is no any detailed description about what it is and how it works. There are quite some blog posts showing exa...
Open Graph Description: Searching for ng-content on https://angular.io/docs/ts/latest/ doesn't produce any useful results and if I'm not mistaken there is no any detailed description about what it is and how it works. The...
X Description: Searching for ng-content on https://angular.io/docs/ts/latest/ doesn't produce any useful results and if I'm not mistaken there is no any detailed description about what it is and how it wo...
Opengraph URL: https://github.com/angular/angular.io/issues/3099
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Document what is \u003cng-content> tag and how content projection works","articleBody":"Searching for `ng-content` on https://angular.io/docs/ts/latest/ doesn't produce any useful results and if I'm not mistaken there is no any detailed description about what it is and how it works. There are quite some blog posts showing examples of using it. It creates a lot of confusion for users, see:\r\n\r\n- angular/angular#13760\r\n- angular/angular#13894\r\n- angular/angular#13921\r\n- angular/angular#12639\r\n- angular/angular#13059\r\n\r\nPoints, which should probably be documented:\r\n\r\n- projection just moves nodes from one place to another, which leads to following conclusions:\r\n - not possible to use projected content multiple times ([link](https://github.com/angular/angular/issues/13894#issuecomment-272557621))\r\n - projected nodes/components, will be always created, even if you wrap them into `*ngIf`, e.g. `\u003cdiv *ngIf=\"false\">\u003cng-content>\u003c/ng-content>\u003c/div>`. It is reason for problems in angular/angular#13760 and angular/angular#13921 ([link](https://github.com/angular/angular/issues/13921#issuecomment-272557367))\r\n - when using `ViewEncapsulation.Emulated` (and probably `Native` as well?) projected nodes will have encapsulation of the place, where they were created and not where, they are projected \r\n- how to query only subset of nodes using `\u003cng-content select=\"\u003cselector>\">`\r\n - document, that only top-level nodes can be selected by this approach\r\n- document a recipe with template, Tobias referring [here](https://github.com/angular/angular/issues/13059#issuecomment-264598276) to created projected nodes only when they are needed\r\n\r\nPS During work on this issue, it may be good idea to also improve documentation of [projectableNodes](https://github.com/angular/angular/issues/13453) as they are tied to functionality discussed here.","author":{"url":"https://github.com/devoto13","@type":"Person","name":"devoto13"},"datePublished":"2017-01-14T14:46:47Z","url":"https://github.com/angular/angular.io/issues/3099"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:4e3588bb-8098-1e27-243b-fc7d3cc50ee5 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | A9EE:2E5652:216D2E4:2A87B18:6B017803 |
| html-safe-nonce | 54f0aa801aab16081491668f6873816ba3a3c4652f00f797a66636d5a479f0ff |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBOUVFOjJFNTY1MjoyMTZEMkU0OjJBODdCMTg6NkIwMTc4MDMiLCJ2aXNpdG9yX2lkIjoiNTcxNzcxNzE0OTYzMzM5MjY3IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 6c8a4afdfd4619e89564080c66385d94602dd6eb70807c1570745b7fc5d265ec |
| hovercard-subject-tag | issue:200807863 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/angular/angular.io/3099/issue_layout |
| twitter:image | https://opengraph.githubassets.com/a9806621858a56fd9db05e823ef521de9c14892db44335c04748d3c871e26aee/angular/angular.io/issues/3099 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/a9806621858a56fd9db05e823ef521de9c14892db44335c04748d3c871e26aee/angular/angular.io/issues/3099 |
| og:image:alt | Searching for ng-content on https://angular.io/docs/ts/latest/ doesn't produce any useful results and if I'm not mistaken there is no any detailed description about what it is and how it works. The... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | devoto13 |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/angular/angular.io git https://github.com/angular/angular.io.git |
| octolytics-dimension-user_id | 139426 |
| octolytics-dimension-user_login | angular |
| octolytics-dimension-repository_id | 31985425 |
| octolytics-dimension-repository_nwo | angular/angular.io |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 31985425 |
| octolytics-dimension-repository_network_root_nwo | angular/angular.io |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width