mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
31479cfaa4
* [ADF-4152] Moved proc services cloud docs to subfolders * [ADF-4152] Fixed links in PS cloud docs * [ADF-4152] Added subfolders and checked links for extensions and insights docs * [ADF-4152] Moved proc services cloud docs to subfolders * [ADF-4152] Fixed links in PS cloud docs * [ADF-4152] Added subfolders and checked links for extensions and insights docs * [ADF-4152] Fixed links in Proc cloud, Insights and Extensions docs * [ADF-4152] Updated links in user guide * [ADF-4152] Fixed broken links in tutorials * [ADF-4152] Fixed remaining links in core docs * [ADF-4152] Fixed remaining links in proc services docs * [ADF-4152] Fixed remaining links in content services docs * [ADF-4152] Fixed links in breaking changes docs * [ADF-4152] Updated main README index page * [ADF-4152] Fixed glitches with preview ext component docs
44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
---
|
|
Title: Transclusion
|
|
Added: v2.6.0
|
|
---
|
|
|
|
# Transclusion
|
|
|
|
Several components in ADF make use of **transclusion**, which is the technique
|
|
of incorporating user-supplied content in the body of a standard component.
|
|
|
|
In
|
|
most cases, this is used to make small customizations (for example, the various
|
|
list components let you supply custom content to show when the list is empty).
|
|
However, there are also a few "containers" whose entire content is set by the user
|
|
with the container itself being mainly for convenient display and formatting
|
|
(for example, the [Info drawer component](../core/components/info-drawer.component.md)).
|
|
|
|
You supply the content you want to transclude between the opening and closing tags of
|
|
the main component. In a few cases, this content can be completely free-form as with
|
|
the body section of the [Login component](../core/components/login.component.md):
|
|
|
|
```html
|
|
<adf-login ...>
|
|
<div>
|
|
<div>Your extra content</div>
|
|
</div>
|
|
</adf-login>
|
|
```
|
|
|
|
More often, though, the main component makes use of one or more sub-components to add
|
|
structure to the transclusion. For example, the [Login component](../core/components/login.component.md)
|
|
also has sub-components for the header and footer regions in addition to the free-form
|
|
content of the body:
|
|
|
|
```html
|
|
<adf-login ...>
|
|
<adf-login-footer><ng-template>My custom HTML for the footer</ng-template></adf-login-footer>
|
|
</adf-login>
|
|
```
|
|
|
|
|
|
|
|
The doc pages for the components that use transclusion contain full details of all
|
|
supported sub-components and their usage. |