# Velo: sobre elementos personalizados

Source: https://support.wix.com/pt/article/velo-sobre-elementos-personalizados (updated 2022-11-13)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Elementos personalizados permitem que você adicione ao seu site elementos que no momento não estão disponíveis com o Editor Wix. Elementos personalizados estão disponíveis na seção **Incorporar código** do menu **Adicionar** no Editor.  
  
 Com o Velo, você pode melhorar o comportamento de elementos personalizados ainda mais do que é possível no Editor. Você também pode hospedar seus elementos personalizados com o Wix usando o Velo.  
  
 Primeiro você cria e codifica o elemento e seu comportamento em um arquivo JavaScript. Em seguida, você implementa como seu site deve lidar com eventos no elemento personalizado.

> **Importante** Apenas usuários premium Wix em sites [com seu próprio domínio e anúncios Wix removidos](https://www.wix.com/account/domains?referralAdditionalInfo=account&domainSearch=true&alwaysfs=) podem trabalhar com elementos personalizados.

## Como criar elementos personalizados

Aqui está um caminho com as etapas para adicionar elementos personalizados:  
  
1. Verifique os [pré-requisitos](https://support.wix.com/pt/article/velo-sobre-elementos-personalizados#prerequisites-1).
2. [Codifique](https://support.wix.com/pt/article/velo-sobre-elementos-personalizados#code-the-custom-element) o elemento personalizado.
3. [Hospede](https://support.wix.com/pt/article/velo-sobre-elementos-personalizados#host-the-custom-element-with-wix-using-velo) o arquivo JavaScript.
4. [Adicione um elemento personalizado](https://support.wix.com/pt/article/velo-sobre-elementos-personalizados#add-the-custom-element-in-the-wix-editor) ao seu site.
5. Para elementos personalizados muito legais, use o Velo para codificar comportamentos adicionais, como [manipulação de eventos de código e mais funcionalidades](https://support.wix.com/pt/article/velo-sobre-elementos-personalizados#code-the-behaviors-with-velo).

## Pré-requisitos

Antes de começar, [verifique os pré-requisitos](https://support.wix.com/en/article/velo-custom-element-faqs#general-requirements-and-guidelines) (em inglês) para garantir que você está configurado corretamente para trabalhar com elementos personalizados. Alguns pré-requisitos importantes a serem observados incluem:

* [Obter um domínio e remover anúncios Wix](https://support.wix.com/en/article/velo-custom-element-faqs#get-a-domain-and-remove-wix-ads-1) (em inglês)
* [Faça upload de imagens para o elemento personalizado no Editor Wix](https://support.wix.com/en/article/velo-custom-element-faqs#where-do-i-store-images-for-custom-elements-1) (em inglês)

## Codificar o elemento personalizado

Codifique o elemento personalizado e seu comportamento em um arquivo JavaScript estático usando o IDE do Velo ou qualquer outro IDE.

Cada arquivo JavaScript corresponde à implementação de um elemento personalizado de seu design e comportamentos. Elementos personalizados são definidos usando a sintaxe da classe ECMAScript 2015.

> **Observação** Presumimos que você saiba um pouco sobre design de elementos com [propriedades CSS](https://developer.mozilla.org/pt-BR/docs/Web/CSS/Reference) em Javascript e trabalhar com [componentes web](https://developer.mozilla.org/pt-BR/docs/Web/Web%5FComponents).   
> Este artigo fornece apenas instruções básicas. Para obter instruções completas e exemplos sobre o uso de componentes web, que são a base dos elementos personalizados, consulte a [documentação MDN](https://developer.mozilla.org/pt-BR/docs/Web/Web%5FComponents).

Alguns dos comportamentos e estilos que você pode considerar codificar no elemento personalizado incluem:

* Variáveis e estilos.
* Funções para animações e outros comportamentos.
* Eventos. Criar eventos é a maneira do elemento personalizado "se comunicar" com o site Wix usando o Velo. Os eventos informam ao Velo que algo precisa ser tratado e os parâmetros podem ser enviados com o evento.

> **Observação** Não use APIs do Velo em seu elemento personalizado.

Crie uma classe para o elemento personalizado e registre o elemento personalizado.  
  
Aqui está um trecho de código de amostra:

```javascript
class MyCustomElement extends HTMLElement { constructor() { super(); console.log(...); } connectedCallback() { ... ... ... } } customElements.define('my-custom-element', MyCustomElement);
```

**Importante!**  
 Monitore o nome que você usou ao registrar o elemento com `customElements.define()`.Você precisará dele ao definir o nome da tag ao adicionar o elemento no Editor.Em nosso exemplo, o nome é `my-custom-element`.

## Hospedar o elemento personalizado com o Wix usando o Velo

Você pode hospedar o arquivo JavaScript do elemento personalizado com o Wix usando o Velo (recomendado) ou [em seu próprio servidor externo ou local.](https://support.wix.com/en/article/velo-custom-element-faqs#how-can-i-create-a-server-for-hosting-custom-elements-optional) (em inglês)  
  
 Para hospedar no Wix, você deve ativar o modo avançado do Velo.

Quando você hospedar no Wix, o local padrão para seus arquivos Javascript de elemento personalizado será: `Public\custom-elements`

Você cria arquivos JavaScript de elemento personalizado:

* Ao criar o arquivo em um IDE e fazer upload manualmente do arquivo para `Public\custom-elements` no menu lateral Estrutura do site.
* Ao [adicionar o elemento personalizado](https://support.wix.com/pt/article/editor-wix-adicionando-um-elemento-personalizado-ao-seu-site#adding-the-custom-element) no Editor Wix escolhendo **Novo arquivo**.
* Ao modificar o arquivo do template de amostra [wix-default-custom-element.js](https://support.wix.com/en/article/velo-example-coding-based-on-the-custom-element-template) (em inglês) fornecido pelo Velo.

## Adicionar o elemento personalizado no Editor Wix

Primeiro, revise as instruções gerais para [adicionar um elemento personalizado](https://support.wix.com/pt/article/editor-wix-adicionando-um-elemento-personalizado-ao-seu-site#adding-the-custom-element) no Editor Wix.  
  
Ao usar o Wix para hospedar ou o Velo para melhorar o elemento personalizado, faça o seguinte:

## Defina a localização do arquivo JavaScript

Nas configurações do elemento, configure o elemento personalizado para que ele se conecte ao arquivo JavaScript correspondente.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/76096845-8b12-44f1-91f6-3dc2e838fdd9/2021/01/04/6d339abe-3008-46c1-b26e-61fd1720838d/34b6ab36-bebd-459c-ab76-a77f51a62d92.png)

> **Observação** Essa ilustração mostra a hospedagem no Wix usando um arquivo Velo. Você também pode hospedar usando um URL de servidor externo ou local.

Quando você escolhe o **arquivo do Velo**, o Velo cria a pasta padrão **Public > custom-elements** se ela ainda não existir.  
  
Quando você cria um novo arquivo, ele é por definição chamado **wix-default-custom-element.js**.O arquivo contém automaticamente um template de um elemento personalizado que você pode alterar.

## Configure a tag como registrada

Insira o nome da tag. O nome da tag corresponde ao nome do elemento registrado usando a função `define()` no código do elemento personalizado.

## Codifique os comportamentos com o Velo

Os comportamentos do elemento personalizado são codificados no arquivo Javascript dos elementos personalizados e também no Velo.  
Você pode personalizar como o elemento personalizado se comporta para uma única página no site ou para todas as páginas do site.

Certifique-se de configurar manipuladores de eventos usando a função `on()` para os eventos definidos no arquivo Javascript do evento personalizado.

Crie e defina atributos no elemento personalizado usando `setAttribute()`.Essa é a maneira do Velo de "se comunicar" com o elemento personalizado.Podemos passar os atributos do elemento personalizado e seus valores para que a implementação do elemento personalizado se comporte de acordo.

## Exemplos

Confira esses artigos que demonstram como trabalhar com elementos personalizados e confira algumas ideias do que você pode fazer:

* [Exemplo básico de "Hello World"](https://support.wix.com/pt/article/editor-wix-adicionando-um-elemento-personalizado-ao-seu-site#custom-element-example)
* [Exemplo básico com imagens](https://support.wix.com/en/article/velo-example-coding-a-basic-custom-element-with-images)
* [Exemplo robusto com Velo](https://support.wix.com/en/article/velo-example-coding-a-more-robust-custom-element)
* [Exemplo de template](https://support.wix.com/en/article/velo-example-coding-based-on-the-custom-element-template)

Veja mais exemplos no site Velo by Wix [Explorar exemplos](https://www.wix.com/velo/examples), como:

* [Exemplo de elemento personalizado Chart.js](https://www.wix.com/velo/example/chart.js-custom-element)
* [Exemplo de elemento personalizado dropdown](https://www.wix.com/velo/example/dropdown-custom-element)
