# Editor Studio: aggiungere un elemento personalizzato

Source: https://support.wix.com/it/article/editor-studio-aggiungere-un-elemento-personalizzato (updated 2026-06-03)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Migliora il sito del tuo cliente con i tuoi elementi. Puoi aggiungere qualsiasi componente Javascript collegando un [elemento personalizzato](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements) a un URL del server o a un file di codice. Se necessario, puoi impostare più attributi direttamente dall'Editor.

> **Prima di iniziare:** Assicurati che il sito del tuo cliente abbia un [dominio collegato](https://support.wix.com/it/article/collegare-un-dominio-ai-name-server-di-wix-1393268) e nessun annuncio Wix.

---

## Cosa sono gli elementi personalizzati?

Gli elementi personalizzati ti consentono di utilizzare i tuoi tag HTML. Questi elementi funzionano su tutti i browser supportati e possono essere utilizzati con qualsiasi libreria o framework JavaScript ES6 che funzioni con HTML 5.

Quando incorpori un elemento personalizzato devi tenere a mente alcuni requisiti:

* Il tuo file Javascript deve essere [ospitato](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements#host-the-custom-element-with-wix-using-velo) su Wix utilizzando Velo (consigliato) o il tuo server esterno o locale
* Il codice deve contenere HTTPS e non HTTP, altrimenti non verrà visualizzato sul tuo sito live
* Il codice deve essere aggiornato e compatibile con HTML5\. La maggior parte dei browser non mostra correttamente le pagine e gli script se sono stati scritti utilizzando versioni JS o HTML precedenti
* Tutte le impostazioni di design rilevanti e le funzionalità complesse devono essere memorizzate all'interno del codice JS principale, ad esempio il CSS e altri file JS. Se queste impostazioni vengono memorizzate separatamente, significa che non funzioneranno sul tuo sito

> **Suggerimenti:**
>
> * Puoi usare elementi personalizzati da fonti terze, assicurati solo di aggiornare il **Nome tag** nelle **Proprietà** quando aggiungi l'elemento personalizzato alla tua pagina
> * Le prestazioni dell'elemento personalizzato dipendono dall'implementazione dello stesso

---

## Aggiungere e configurare l'elemento personalizzato

Aggiungi tutti gli elementi personalizzati di cui hai bisogno. Dopo aver trascinato un elemento personalizzato sulla tua pagina, definisci la sua origine (URL del server o un file Velo) e assegnagli un nome del tag in modo da riconoscerlo facilmente nel registro della pagina.

### Per aggiungere e configurare un elemento personalizzato:

1. Clicca su **Aggiungi elementi** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/06/14/cef22a14-dfc9-43c7-a54f-72ed83266050/741248d2-4240-497e-a282-2a7d15d8afac.png) sul lato sinistro dell'Editor
2. Clicca su **Incorpora e social**
3. Clicca su **Elemento personalizzato**
4. Clicca sull'icona **Aggiungi** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2024/07/22/e901c4fc-b4aa-48e0-81dd-8242eecca0c8/16eec3ff-490b-4c99-b97b-d08d3d8c7764.png) accanto a **Elemento personalizzato**
5. Aggiungi il tuo file di script:  
   1. Seleziona l'elemento personalizzato  
   2. Clicca su **Scegli origine**  
   3. Seleziona il modo in cui vuoi aggiungere il tuo elemento personalizzato:  
         * **URL server:** inserisci l'URL del file, incluso il nome del file  
         * **File Velo:** seleziona uno dei tuoi file Velo  
   4. Inserisci un **Nome del tag** per il tuo elemento  
   **Nota:** il nome del tag deve essere formato da almeno due parole, separate da un trattino (es. widget-meteo-grande)
6. (Facoltativo) Regola le dimensioni, l'ancoraggio e l'allineamento dell'elemento dal pannello Ispezione

> **Note:**
>
> * Per motivi di sicurezza, l'elemento personalizzato viene renderizzato all'interno di un iFrame nell'Editor e in modalità anteprima. Ciò potrebbe influire sul layout del componente. **Vai al tuo sito pubblicato per vedere come appare online**
> * Puoi definire le impostazioni SEO del tuo elemento utilizzando l'API Velo

---

## Impostare gli attributi dell'elemento personalizzato

Apporta ulteriori modifiche alle proprietà e al comportamento dell'elemento impostando gli attributi. Il pannello Attributi elemento ti consente di aggiungere, modificare e rimuovere attributi direttamente dall'Editor, senza dover accedere al codice vero e proprio.

> **Importante:** Il codice per l'elemento personalizzato deve riconoscere e gestire gli attributi definiti. In caso contrario, non funzioneranno correttamente.

### Per impostare gli attributi dell'elemento personalizzato:

1. Seleziona l'elemento personalizzato
2. Clicca su **Imposta attributi**
3. Clicca su **New Attribute (Nuovo attributo)**
4. Inserisci un nome per l'[attributo](https://www.w3.org/TR/2011/WD-html5-20110525/syntax.html#attributes-0) (es. "rotazione", "larghezza") (contenuti in inglese)
5. Inserisci il valore dell'attributo (può essere qualsiasi stringa pertinente)
6. Clicca su **Imposta**

> **Cerchi informazioni più avanzate?** [Scopri come utilizzare gli elementi personalizzati](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements) con Velo by Wix. Per domande specifiche e per la risoluzione dei problemi, consulta [le FAQ sugli elementi personalizzati](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/custom-element-faqs).
