mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# Special Elements
|
|
|
|
Each subdirectory 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:
|
|
|
|
```typescript
|
|
@elementAttribute attr="value"
|
|
|
|
Description of the attribute and value.
|
|
```
|
|
|
|
<!-- links -->
|
|
|
|
<!-- external links -->
|
|
|
|
<!-- end links -->
|
|
|
|
@reviewed 2022-02-28
|