c8086b7e86
tweak the current structural directives guide (currently mainly targeted at the creation of custom structural directives) so that is more generic and a point of reference for structural directives in general this also includes the re-addition of the one-per-element section removed in PR #40015 resolves #44786 PR Close #44895 |
||
|---|---|---|
| .. | ||
| core | ||
| README.md | ||
Special Elements
Each sub-directory below this contains documentation that describes "special elements". These are elements that can appear in templates that have special meaning and behaviour in the Angular framework.
Each element should have a markdown file with the same file name as the element's tag name for example, `ng-container.md`.
The file should be stored in a directory whose name is that of the Angular package under which this element should appear in the docs usually `core`.
Short description
The file should contain a "short description" of the element. This is the first paragraph in the file.
Long description
All the paragraphs after the short description are collected as an additional longer description.
Element attributes
If the special element accepts one or more attributes that have special meaning to Angular, then these should be documented using the @elementAttribute tag.
These tags should come after the description.
The format of this tag is:
@elementAttribute attr="value"
Description of the attribute and value.
@reviewed 2022-02-28