--- title: Web Components slug: Web/Web_Components translation_of: Web/Web_Components ---

Web Components è una suite di tecnologie che permettono di creare elementi personalizzati, la cui funzionalità è incapsulata e separata dal resto del codice sorgente, per uso in applicazioni web.

Concetti e uso

Riutilizzare una porzione di codice il più possibile è desiderabile. In passato, questo non è sempre stato facile per i linguaggi di markup: si pensi ad esempio al complesso HTML e CSS (con script associati) necessari per personalizzare i controlli dell'interfaccia utente, e a come sia necessario riutilizzarli all'interno della stessa pagina.

I Web Component hanno l'obiettivo di risolvere questi problemi. Consistono di tre tecnologie principali che possono essere usate in combinazione per creare elementi personalizzati versatili con funzionalità incapsulata che possono essere riutilizzati senza dover temere collisioni nel codice.

Elementi personalizzati: Un insieme di API per JavaScript che permettono di definire elementi personalizzati ed il loro comportamento.
Shadow DOM: Un insieme di API per JavaScript per assegnare un albero DOM "nascosto" ad un elemento, e controllare la funzionalità associata. In questo modo, è possibile mantenere le caratteristiche dell'elemento private ed evitare collisioni con altre parti del documento.
Template HTML: Gli elementi {{HTMLElement("template")}} e {{HTMLElement("slot")}} permettono di scrivere template di markup che non vengono visualizzati nella pagina. Questi template possono essere riutilizzati più volte come struttura base di un elemento personalizzato.

L'approccio all'implementazione di un web component è di solito la seguente:

Creare una classe o funzione in cui si specifica la funzionalità del componente. Se si usa una classe, è solito usare la sintassi ECMAScript 2015.
Registrare l'elemento tramite il metodo {{domxref("CustomElementRegistry.define()")}} passando come parametro il nome dell'elemento, la classe o funzione che specifica la funzionalità del componente, e (opzionalmente) l'elemento da cui eredita.
Se richiesto, assegnare un shadow DOM all'elemento tramite il metodo {{domxref("Element.attachShadow()")}} e aggiungere elementi figli, event listener eccetera allo shadow DOM tramite metodi standard del DOM.
Se richiesto, definire un template HTML usando {{htmlelement("template")}} e {{htmlelement("slot")}}. Usare i normali metodi del DOM per clonare il template e assegnarlo allo shadow DOM.
Usare l'elemento personalizzato dove necessario nella pagina, come un qualsiasi elemento HTML.

Tutorial

Usare elementi personalizzati: Una guida che mostra come usare elementi personalizzati per creare componenti web, istruzioni sui lifecycle callbacks, ed altre funzionalità avanzate.
Usare lo shadow DOM: Una guida che spiega i fondamenti dello shadow DOM, mostrando come aggiungerlo a un elemento, aggiungere elementi all'albero shadow DOM, stilizzarlo, ed altro.
Usare templates e slot: Una guida che spiega come definire una struttura HTML riutilizzabile usando gli elementi {{htmlelement("template")}} e {{htmlelement("slot")}}, e come usera la struttura in un web component.

Glossario

Elementi personalizzati

{{domxref("CustomElementRegistry")}}

Contiene funzionalità relativa a elementi personalizzati, in particolare il metodo {{domxref("CustomElementRegistry.define()")}} usato per registrare nuovi elementi personalizzati in modo che possano essere usati nel documento.

{{domxref("Window.customElements")}}

Returns a reference to the CustomElementRegistry object.

Life cycle callbacks

Special callback functions defined inside the custom element's class definition, which affect its behavior:

connectedCallback: Invoked when the custom element is first connected to the document's DOM.
disconnectedCallback: Invoked when the custom element is disconnected from the document's DOM.
adoptedCallback: Invoked when the custom element is moved to a new document.
attributeChangedCallback: Invoked when one of the custom element's attributes is added, removed, or changed.

Extensions for creating custom built-in elements

The {{htmlattrxref("is")}} global HTML attribute: Allows you to specify that a standard HTML element should behave like a registered custom built-in element.
The "is" option of the {{domxref("Document.createElement()")}} method: Allows you to create an instance of a standard HTML element that behaves like a given registered custom built-in element.

CSS pseudo-classes

Pseudo-classes relating specifically to custom elements:

{{cssxref(":defined")}}: Matches any element that is defined, including built in elements and custom elements defined with CustomElementRegistry.define()).
{{cssxref(":host")}}: Selects the shadow host of the shadow DOM containing the CSS it is used inside.
{{cssxref(":host()")}}: Selects the shadow host of the shadow DOM containing the CSS it is used inside (so you can select a custom element from inside its shadow DOM) — but only if the selector given as the function's parameter matches the shadow host.
{{cssxref(":host-context()")}}: Selects the shadow host of the shadow DOM containing the CSS it is used inside (so you can select a custom element from inside its shadow DOM) — but only if the selector given as the function's parameter matches the shadow host's ancestor(s) in the place it sits inside the DOM hierarchy.

Shadow DOM

{{domxref("ShadowRoot")}}

Represents the root node of a shadow DOM subtree.

{{domxref("DocumentOrShadowRoot")}}

A mixin defining features that are available across document and shadow roots.

{{domxref("Element")}} extensions

Extensions to the Element interface related to shadow DOM:

The {{domxref("Element.attachShadow()")}} method attaches a shadow DOM tree to the specified element.
The {{domxref("Element.shadowRoot")}} property returns the shadow root attached to the specified element, or null if there is no shadow root attached.

Relevant {{domxref("Node")}} additions

Additions to the Node interface relevant to shadow DOM:

The {{domxref("Node.getRootNode()")}} method returns the context object's root, which optionally includes the shadow root if it is available.
The {{domxref("Node.isConnected")}} property returns a boolean indicating whether or not the Node is connected (directly or indirectly) to the context object, e.g. the {{domxref("Document")}} object in the case of the normal DOM, or the {{domxref("ShadowRoot")}} in the case of a shadow DOM.

{{domxref("Event")}} extensions

Extensions to the Event interface related to shadow DOM:

{{domxref("Event.composed")}}: Returns a {{jsxref("Boolean")}} which indicates whether the event will propagate across the shadow DOM boundary into the standard DOM (true), or not (false).
{{domxref("Event.composedPath")}}: Returns the event’s path (objects on which listeners will be invoked). This does not include nodes in shadow trees if the shadow root was created with {{domxref("ShadowRoot.mode")}} closed.

HTML templates

{{htmlelement("template")}}: Contains an HTML fragment that is not rendered when a containing document is initially loaded, but can be displayed at runtime using JavaScript, mainly used as the basis of custom element structures. The associated DOM interface is {{domxref("HTMLTemplateElement")}}.
{{htmlelement("slot")}}: A placeholder inside a web component that you can fill with your own markup, which lets you create separate DOM trees and present them together. The associated DOM interface is {{domxref("HTMLSlotElement")}}.
The slot global HTML attribute: Assigns a slot in a shadow DOM shadow tree to an element.
{{domxref("Slotable")}}: A mixin implemented by both {{domxref("Element")}} and {{domxref("Text")}} nodes, defining features that allow them to become the contents of an {{htmlelement("slot")}} element. The mixin defines one attribute, {{domxref("Slotable.assignedSlot")}}, which returns a reference to the slot the node is inserted in.

{{domxref("Element")}} extensions

Extensions to the Element interface related to slots:

{{domxref("Element.slot")}}: Returns the name of the shadow DOM slot attached to the element.

CSS pseudo-elements

Pseudo-elements relating specifically to slots:

{{cssxref("::slotted")}}: Matches any content that is inserted into a slot.

The {{event("slotchange")}} event

Fired on an {{domxref("HTMLSlotElement")}} instance ({{htmlelement("slot")}} element) when the node(s) contained in that slot change.

Examples

We are building up a number of examples in our web-components-examples GitHub repo. More will be added as time goes on.

Specifications

Specification	Status	Comment
{{SpecName("HTML WHATWG","scripting.html#the-template-element","<template> element")}}	{{Spec2("HTML WHATWG")}}	The definition of {{HTMLElement("template")}}.
{{SpecName("HTML WHATWG","custom-elements.html#custom-elements","custom elements")}}	{{Spec2("HTML WHATWG")}}	The definition of HTML Custom Elements.
{{SpecName("DOM WHATWG","#shadow-trees","shadow trees")}}	{{Spec2("DOM WHATWG")}}	The definition of Shadow DOM.
{{SpecName("HTML Imports", "", "")}}	{{Spec2("HTML Imports")}}	Initial HTML Imports definition.
{{SpecName("Shadow DOM", "", "")}}	{{Spec2("Shadow DOM")}}	Initial Shadow DOM definition.

Browser compatibility

In general:

Web components are supported by default in Firefox (version 63), Chrome, and Opera.
Safari supports a number of web component features, but less than the above browsers.
Edge is working on an implementation.

For detailed browser support of specific features, you'll have to consult the reference pages listed above.