diff --git a/aio/content/guide/elements.md b/aio/content/guide/elements.md index 2a8c78de0a..35b86d2370 100644 --- a/aio/content/guide/elements.md +++ b/aio/content/guide/elements.md @@ -1,6 +1,6 @@ # Angular Elements Overview -Angular Elements are Angular components packaged as custom elements, a web standard for defining new html elements in a framework-agnostic way. +_Angular elements_ are Angular components packaged as _custom elements_, a web standard for defining new HTML elements in a framework-agnostic way. [Custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements) are a Web Platform feature currently supported by Chrome, Opera, and Safari, and available in other browsers through polyfills (see [Browser Support](#browser-support)). A custom element extends HTML by allowing you to define a tag whose content is created and controlled by JavaScript code. @@ -8,7 +8,16 @@ The browser maintains a `CustomElementRegistry` of defined custom elements (also The `@angular/elements` package exports a `createCustomElement()` API that provides a bridge from Angular's component interface and change detection functionality to the built-in DOM API. -Transforming a component to a custom element makes all of the required Angular infrastructure available to the browser. Creating a custom element is simple and straightforward, and automatically connects your component-defined view with change detection and data binding, mapping Angular functionality to the corresponding native HTML equivalents. +Transforming a component to a custom element makes all of the required Angular infrastructure available to the browser. +Creating a custom element is simple and straightforward, and automatically connects your component-defined view with change detection and data binding, mapping Angular functionality to the corresponding native HTML equivalents. + +
+ + We are working on custom elements that can be used by web apps built on other frameworks. + A minimal, self-contained version of the Angular framework will be injected as a service to support the component's change-detection and data-binding functionality. + For more about the direction of development, check out this [video presentation](https://www.youtube.com/watch?v=Z1gLFPLVJjY&t=4s). + +
## Using custom elements @@ -41,14 +50,6 @@ When your custom element is placed on a page, the browser creates an instance of
-
- - We are working on custom elements that can be used by web apps built on other frameworks. - A minimal, self-contained version of the Angular framework will be injected as a service to support the component's change-detection and data-binding functionality. - For more about the direction of development, check out this [video presentation](https://www.youtube.com/watch?v=vHI5C-9vH-E). - -
- ## Transforming components to custom elements Angular provides the `createCustomElement()` function for converting an Angular component,