Title: Document what is
Open Graph Title: Document what is
X Title: Document what is
Description: I'm submitting a ... [ ] Regression (behavior that used to work and stopped working in a new release) [ ] Bug report [ ] Feature request [x] Documentation issue or request [ ] Support request => Please do not submit support request here,...
Open Graph Description: I'm submitting a ... [ ] Regression (behavior that used to work and stopped working in a new release) [ ] Bug report [ ] Feature request [x] Documentation issue or request [ ] Support request => Pl...
X Description: I'm submitting a ... [ ] Regression (behavior that used to work and stopped working in a new release) [ ] Bug report [ ] Feature request [x] Documentation issue or request [ ] Support request =...
Opengraph URL: https://github.com/angular/angular/issues/17983
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Document what is \u003cng-content> tag and how content projection works","articleBody":"\u003c!--\r\nPLEASE HELP US PROCESS GITHUB ISSUES FASTER BY PROVIDING THE FOLLOWING INFORMATION.\r\n\r\nISSUES MISSING IMPORTANT INFORMATION MIGHT BE CLOSED WITHOUT INVESTIGATION.\r\n-->\r\n\r\n## I'm submitting a ...\r\n\u003c!-- Check one of the following options with \"x\" -->\r\n\u003cpre>\u003ccode>\r\n[ ] Regression (behavior that used to work and stopped working in a new release)\r\n[ ] Bug report \u003c!-- Please search github for a similar issue or PR before submitting -->\r\n[ ] Feature request\r\n[x] Documentation issue or request\r\n[ ] Support request => Please do not submit support request here, instead see https://github.com/angular/angular/blob/master/CONTRIBUTING.md#question\r\n\u003c/code>\u003c/pre>\r\n\r\n## Current behavior\r\nAs per https://github.com/angular/angular.io/issues/3099 searching for ng-content on https://angular.io/docs/ts/latest/ doesn't produce any useful results and there doesn't seem to be any detailed description about what it is and how it works.\r\n\r\n## Expected behavior\r\nAs per https://github.com/angular/angular.io/issues/3099 these points should probably be documented: \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 https://github.com/angular/angular/issues/13760 and https://github.com/angular/angular/issues/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\n## Minimal reproduction of the problem with instructions\r\nSearch for ng-content on https://angular.io/docs/ts/latest/\r\n\r\n## What is the motivation / use case for changing the behavior?\r\nIt creates a lot of confusion for users, see:\r\n- https://github.com/angular/angular/issues/13760\r\n- https://github.com/angular/angular/issues/13894\r\n- https://github.com/angular/angular/issues/13921\r\n- https://github.com/angular/angular/issues/12639\r\n- https://github.com/angular/angular/issues/13059\r\n\r\n## Please tell us about your environment\r\nN/A\r\n","author":{"url":"https://github.com/tomchinery","@type":"Person","name":"tomchinery"},"datePublished":"2017-07-07T11:59:15Z","url":"https://github.com/angular/angular/issues/17983"}
| 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:870a634c-5507-78b5-4ef6-04c334481987 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B2EA:23CF06:2622063:3091D4A:6B01808E |
| html-safe-nonce | a9cf6c79833007697cdb94e106053d07881a3c0f7bc9761beb7e89197d162595 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCMkVBOjIzQ0YwNjoyNjIyMDYzOjMwOTFENEE6NkIwMTgwOEUiLCJ2aXNpdG9yX2lkIjoiNTc2ODA0OTU3MTc1MDA1MTk4MiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | c4696838b08492c9a7cf2403e9c051d79bd8c20ce144609360b9c4199c9ec71e |
| hovercard-subject-tag | issue:241242886 |
| 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/17983/issue_layout |
| twitter:image | https://opengraph.githubassets.com/7d6287151f3e4e20c2ac318533c2964d01ebd4edee15512a47e93e4bac1c6075/angular/angular/issues/17983 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/7d6287151f3e4e20c2ac318533c2964d01ebd4edee15512a47e93e4bac1c6075/angular/angular/issues/17983 |
| og:image:alt | I'm submitting a ... [ ] Regression (behavior that used to work and stopped working in a new release) [ ] Bug report [ ] Feature request [x] Documentation issue or request [ ] Support request => Pl... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | tomchinery |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/angular/angular git https://github.com/angular/angular.git |
| octolytics-dimension-user_id | 139426 |
| octolytics-dimension-user_login | angular |
| octolytics-dimension-repository_id | 24195339 |
| octolytics-dimension-repository_nwo | angular/angular |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 24195339 |
| octolytics-dimension-repository_network_root_nwo | angular/angular |
| 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