diff --git a/aio/content/guide/elements.md b/aio/content/guide/elements.md index 3b0ffa253e..3a1c7fcf33 100644 --- a/aio/content/guide/elements.md +++ b/aio/content/guide/elements.md @@ -71,6 +71,15 @@ When the browser encounters the tag for the registered element, it uses the cons Transform a component to a custom element +
+ + Avoid using the [`@Component`](api/core/Component) [selector](api/core/Directive#selector) as the custom-element tag name. + This can lead to unexpected behavior, due to Angular creating two component instances for a single DOM element: + One regular Angular component and a second one using the custom element. + +
+ + ### Mapping A custom element _hosts_ an Angular component, providing a bridge between the data and logic defined in the component and standard DOM APIs. Component properties and logic maps directly into HTML attributes and the browser's event system.