Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Última atualização: 18/07/2024

Em algumas regiões do Brasil, é comum você ter endereços de casas com números e letras (ex.: Rua Taltaltal, número 12A). Porém tivemos casos de clientes tendo problemas ao subir o cadastro com o número da casa digitado dessa forma (como quebrando a geração de contratos, subida de arquivos de documentos…). Notamos também que este problema ocorre quando a pessoa insere “0“ ou sequência de “0“ como número da casa.

Fazendo alguns testes com uma versão mais antiga deste snippet (anterior a 05/2024), notamos que o corte que ele fazia em dígitos diferentes de 0 a 9 não tinha efeito, visto que o quê a pessoa digitasse já ia para o carrinho, estando ou não em um formato aceitável pelo IXC.

Sendo assim, fizemos um trecho de código para restringir essa inserção de informação. O código se encontra abaixo. Os trechos de código (snippets) devem ser inseridos com os comentários para ficar mais fácil de achar e dar manutenção ou personalizar.

1 - Estilização em CSS. Insira em “Sistema - Config - Core Website“, na seção “Custom Style“

...

abrir um alerta sobre o formato correto, com um tooltip e um aviso adicional no rótulo do campo “número da casa“. Abaixo explicarei os trechos mais importantes do código, e explicarei quais partes são editáveis.

Gatilho HTML

Este primeiro trecho é o gatilho para o código começar a rodar. Da forma que está escrito, começará a rodar a partir do momento em que o elemento (no caso, uma imagem invisível) carregar na página.

Este gatilho deve ser colado na página do WDA do cliente (ex.: no assine, fora do <plugin-provider-checkout></plugin-provider-checkout>).

Para este gatilho funcionar, pegue o link de uma imagem qualquer na mídia do provedor (uma imagem leve de se carregar, por garantia), e insira entre as aspas em src="". Se quiser, pode apagar o comentário <!-- Não apagar. Script em "core" -->; ele serve mais como um aviso para outra pessoa que for mexer no site e estranhar o trecho.

Bloco de código
<div class="d-none">
    <img src="" width="0" height="0" onload="searchForNumCasaWrp()">
    <!-- Não apagar. Script em "core" -->
</div>

Estilização CSS

Na mesma página que o gatilho acima foi colado, cole este trecho de código abaixo:

Bloco de código
<style>
    /* Estilização aviso número da casa IXC */
    .numres-tooltip-text {
          text-align: center;
          padding: 5px;
   
        border: 2px solid red;
   
        width: 200px;
   250px;
        font-size: 12px;
   
        display: none;
          font-weight: 500;
   
        color: red;
   
        background-color: rgb(255, 216, 216);
   
        margin-left: auto;
           margin-right: auto;
   
        margin-top: 2rem;
    }

    /*Fim*/

2 - Código em Javascript

Bloco de código
// v.2.2.0 - 28/07/2023
// Cria restrição de número da residência.ixcs-d-none {
        display: none;
    }
</style>

Esta parte é mais tranquila de mexer; se você tem conhecimentos básicos de CSS, pode adaptá-la conforme o cliente pedir. Só garanta que os display: none; ficarão desta forma, e teste as alterações em uma página de testes.

Javascript

O código abaixo é o que faz o aviso aparecer. Este código deve ser colado no Core Website do provedor, em “Custom script“.

Resumindo o funcionamento: o código carrega junto com a página, e fica esperando um certo elemento aparecer (no caso, de id #bfc_numberOfAddress) durante o tempo definido por tempoSleepEmSegundos. Quando aparece, ele cria todos os elementos necessários, para de rodar a função que gera tudo isso, e só mostra os avisos se a pessoa clicar no campo de número da casa, ou no tooltip (i) no rótulo.

Por buscar o elemento pelo ID, nenhuma adaptação precisa ser feita entre páginas (como /assine e /assine-revendedor).

Os trechos editáveis (com cuidado):

tempoSleepEmSegundos: tempo que o código tentará achar o elemento #bfc_numberOfAddress, em segundos. Insira quanto você achar melhor, pois assim que o elemento for encontrado, a função já parará de buscá-lo, não consumindo recursos.

numCasaLabelContent: texto que substituirá o rótulo do número da casa. Só garanta que o tooltip aparecerá com todas as suas classes.

tooltipTxtContent: texto que aparecerá no quadro de aviso, mencionando as restrições.

Bloco de código
// Restringe input de número de casa para aceitar apenas números e seq. diferente 

...

de 0.
// v.4.0.0 - 18/07/2024
//START

var tempoSleepEmSegundos = 

...

120;
var numCasa = null;
var numCasaWrp;
var numCasaLabel;
var toolTipIcon;
var 

...

numCasaLabelContent = 

...

'Nº da Residência (apenas números)

...

 <i class="fas fa-info-circle tooltip-info-circle"></i>';
var tooltipTxtContent = "Insira apenas números, ou \"SN\" para \"Sem Número\". Se necessário, insira letras no campo \"Complemento\" mais à frente. Número de casa com apenas \"0\" ou sequência de \"0\" é inválida.";

function sleepSearchForNumCasaWrp(ms) {
    return new Promise((resolve) => {setTimeout(resolve, ms)} )
}

async function searchForNumCasaWrp() {
    for (i = tempoSleepEmSegundos; i > 0; i--) {
        if (numCasa == null) {
            console.log("looking for numCasa");
            fillsNumCasaInfo ();
        } else {
            break;
        }
        await sleepSearchForNumCasaWrp(1000);
    }
}

function createToolTip () {
    let toolTip = document.createElement("p")

...

 

...

 

...

 

...

 let toolTipTxtNode = document.createTextNode(

...

tooltipTxtContent);

...

 

...

 

...

 

...

 toolTip.classList.add("numres-tooltip-text");

...

 

...

 

...

 

...

 toolTip.appendChild(toolTipTxtNode);

...

 

...

 

...

 

...

 toolTipIcon = document.querySelector(".tooltip-info-circle");

...

    numCasaWrp.append(toolTip);
}

function fillsNumCasaInfo () {
    try {
        numCasa = document.querySelector(

...

"#bfc_numberOfAddress");
        numCasaWrp = document.querySelector("#bfc_numberOfAddress").parentNode;
        numCasaLabel = document.querySelector("#bfc_numberOfAddress").previousSibling;
        numCasaLabel.innerHTML = (numCasaLabelContent);
        console.log("NumCasa filled");
        createWarning ();
    } catch (error) {
        console.log("numCasa ainda não preenchido", error)
    }
}

function createWarning () {
    numCasa.placeholder = "1234"; // É aplicado só após o numCasa estar preenchido 
    
    createToolTip ();
    
    let toolTipWrp = document.querySelector(".numres-tooltip-text");
    
    toolTipIcon.addEventListener("click", () => {

...

  

...

 

...

 

...

 

...

 

...

 

...

 (

...

toolTipWrp.style.display == "none") 

...

? toolTipWrp.style.display = "block"

...

 

...

: toolTipWrp.style.display = "none";

...

 

...

 

...

 

...

 

...

})

...


...

 

...

 

...

 

...

Nota: nas linhas 26 e 35 foi feita a seleção do seletor, elemento por elemento. Dependendo de como estiver o checkout do cliente (ex.: campos a mais, pre_check_customer…), isso altera a ordem e quantidade de campos, então pode ser necessária a correção desses trechos. Estou enviando abaixo o endereço de cada elemento e a qual variável ele deve ser atrelado. Use o modo “Inspecionar“ do seu navegador, selecione o elemento e clique em “Copy selector“, “Copiar seletor CSS“ ou equivalente.

...

TESTE: para testar se está tudo certo, insira os trechos, depois limpe o cache em “Ações manuais - Limpar cache“ e abra uma janela anônima. Após 5 segundos, é para aparecer as modificações no campo.

...

 numCasa.addEventListener("click", () => {
        (toolTipWrp.style.display == "none") ? toolTipWrp.style.display = "block" : toolTipWrp.style.display = "none";
    })
}

// END

Ao final da inserção de tudo, se nada foi alterado, as páginas com o gatilho devem ficar com o campo da forma abaixo:

image-20240603-175040.pngImage Added

image-20240603-175117.pngImage Added