Autocomplete de moradas no Wix

O checkout do Wix é uma página fechada: configura-se no painel, não se edita no Editor e não aceita código. O widget do Moradas não se liga aos campos de morada do checkout; serve em formulários próprios inseridos como HTML.

Funciona no checkout: Não

A página de checkout não se abre no Editor; o que se configura, no painel (Checkout Settings), são o logótipo, as políticas e campos extra de texto ou escolha múltipla. Email, nome e morada são campos fixos. O Velo trabalha com elementos do Editor através de $w, sem acesso ao DOM, e o Custom Code insere scripts nas páginas mas não tem forma documentada de se ligar aos campos do checkout.

Para que serve o widget no Wix: um formulário próprio num elemento Embed HTML (iframe) ou num Custom Element — pedido de orçamento, registo da morada de entrega para contacto posterior — e sistemas fora do Wix (back-office, CRM).

Não testado num site Wix real: as afirmações acima vêm da documentação do Wix verificada a 2 de outubro de 2026.

Formulário próprio num Embed HTML

O elemento Embed HTML (Add Elements › Embed Code › Popular Embeds › Embed HTML) mostra o seu código num iframe. Lá dentro, o widget funciona como em qualquer página HTML. Um formulário mínimo:

<form action="https://o-seu-servidor.example/morada" method="post">
  <label>Morada <input id="morada" name="morada" autocomplete="off"></label>
  <label>Código postal <input id="cp7" name="cp7"></label>
  <label>Localidade <input id="localidade" name="localidade"></label>
  <button type="submit">Enviar</button>
</form>
<script src="https://moradas.dev/widget.js"></script>
<script>
  PTAddress.attach(document.querySelector('#morada'), {
    fill: { postal: '#cp7', city: '#localidade' }
  });
</script>

O iframe é uma página isolada: o que o cliente escreve não chega ao checkout nem ao painel do Wix por si. Para guardar os dados, envie o formulário para o seu servidor ou para um serviço de formulários.
A lista de sugestões abre dentro do iframe; dê ao elemento altura suficiente para a lista não ficar cortada.
Só HTTPS: o Wix não mostra código com endereços HTTP.

Custom Element

Um Custom Element — um web component com JavaScript alojado no seu servidor — também pode conter um formulário com o widget, na própria página e sem iframe. Exige plano Premium e domínio ligado; faz sentido quando já tem programador.

E as moradas das encomendas?

Se precisa de moradas certas nas encomendas do Wix, a verificação fica para depois do checkout: a partir das encomendas exportadas, ou no seu sistema de expedição, use a API — /suggest com a morada e o número de porta devolve o CP7 exato, e /cp/{cp7} confirma um código postal — antes de imprimir a etiqueta.

O que o widget faz

O widget.js carrega-se com uma linha e liga-se ao campo da morada com PTAddress.attach. Enquanto o cliente escreve aparecem sugestões de ruas e localidades portuguesas; ao escolher, os campos indicados em fill recebem o código postal, a localidade, o concelho e o distrito. Numa rua com vários códigos postais, o CP7 exato chega com o número de porta. Se o serviço não responder, o formulário continua a funcionar como antes. Todas as opções — endpoint, fill, onSelect, onResolve, lang, beacon — estão na documentação do widget.

Porque é que o CP7 exato importa

Em Portugal uma rua pode ter vários códigos postais, por troços e pela paridade dos números. Na Avenida da Liberdade, em Lisboa, o n.º 196 tem o código 1250-147, e os números ímpares de 1 a 57 têm o 1250-139. Uma gralha no código postal pode mandar a encomenda para a morada errada.

E os dados dos clientes?

O Moradas não usa cookies e não guarda o texto pesquisado — só contagens agregadas de utilização e, se o beacon ficar ligado, um relatório mínimo quando o serviço falha. Pode remeter para a página de privacidade na política da sua loja.

Fontes (verificadas a 2 de outubro de 2026)

Experimentar a demo Documentação do widget