Escondido

O Campo oculto é o único controle nos Master Addons Construtor de widgets que os editores nunca veem Ele contém um valor fixo que você definiu uma vez no construtor, digamos uma string de versão ou uma chave de layout O valor viaja com o widget e imprime através de um token de modelo, mas nenhuma entrada para ele aparece em qualquer lugar do painel Elementor.

Até o campo Oculto suporta Condições, e seu valor armazenado é impresso através do Mecanismo de modelo de sintaxe dupla como qualquer outro token, você pode fazer referência a ele {% if %} verifica em todo o seu modelo Ambos os guias cobrem os detalhes.

Isso o torna o lar certo para constantes que seu modelo precisa, mas os usuários não devem editar. Qualquer coisa que um cliente curioso possa mudar por acidente permanece fora de alcance. Seus painéis HTML, CSS e JS ainda podem lê-lo como qualquer outro valor.

O que o campo Oculto faz #

• Armazena um valor de string fixo definido no construtor, sem controle visível no Elementor.
• Imprime esse valor em qualquer lugar do painel HTML, CSS ou JS do widget {{ your_field_name }}.
• Mantém as constantes de configuração fora da UI de edição, para que não possam ser alteradas por página.
• Comporta-se como um valor de texto na lógica de modelo, portanto, condicionais como {% if mode == 'embed' %} trabalho.

Se este for seu primeiro widget personalizado, leia o Visão geral do Widget Builder antes desta página; cobre o layout do editor que os documentos de campo assumem.

Antes de começar #

• WordPress com Elementor instalado e ativo.
• Complementos Mestres para Elementor instalado e ativo. Novo no plugin? veja o guia instalação.
• Um widget personalizado aberto no editor Widget Builder Nosso exemplo é um widget de incorporação de mapa onde um campo Oculto nomeado map_style_key carrega o identificador de estilo de mapa fixo que o script de incorporação espera.

Como adicionar um campo Oculto #

Arraste o Escondido campo do painel de campos em qualquer seção A guia não importa aqui, uma vez que nada renderiza no painel de qualquer maneira Suas opções abrem à esquerda assim que ele pousa.

Opções de campo oculto explicadas #

A lista de opções é curta por design:

• Etiqueta: um nome para sua própria referência dentro do construtor Nunca aparece no Elementor.
• Nome: o identificador exclusivo a que seus modelos se referem. Apenas letras, números e sublinhados, por exemplo map_style_key.
• Predefinição: o valor que o campo detém Como não há UI para alterá-lo mais tarde, este é efetivamente o valor, ponto final.

Conecte o campo Oculto com seu token #

O campo Oculto é um campo de token Imprima exatamente como um valor de texto, em qualquer um dos três painéis:

<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>

// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);

A lógica de modelo também pode ramificar nele Se você enviar dois modos internos do mesmo widget, um campo Oculto poderá escolher o ramo sem expor a escolha:

{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}

Um modo de falha silenciosa para saber sobre: se você renomear o campo mais tarde, cada token ainda apontando para o nome antigo imprime uma string vazia Nada de erros, o widget apenas renderiza com um espaço em branco onde a constante costumava ser Depois de uma renomeação, procure todos os três painéis para o nome antigo antes de salvar.

Cuidado: um campo Oculto é invisível, não secreto Seu valor ainda é renderizado na marcação de página ou script que os visitantes podem visualizar-fonte Mantenha chaves e credenciais de API privadas fora dele; é para constantes de configuração, não segredos.

Use o campo Oculto no Elementor #

Adicione seu widget personalizado a uma página no Elementor O painel mostra todos os outros controles que você definiu, e nada para o campo Oculto Essa ausência é o recurso O valor já está aplicado, e o widget renderizado reflete desde a primeira gota.

Casos de uso comum #

• Chaves layout esse CSS ou JS interno é ramificado em um widget fixo.
• Version strings carimbado em um atributo de dados para depuração de widgets enviados.
• Sinalizadores de modo API como um tipo de incorporação que o script do widget lê.
• Fragmentos fixos de nomes de classe impresso na marcação para que uma família de widgets compartilhe ganchos de estilo.
• Interruptores de ramificação de modelo quando você exporta um widget em duas variantes internas.

Dicas para trabalhar com o campo Oculto #

• Diga-lhe o nome como a constante que é. map_style_key diz ao próximo mantenedor o que significa o token; hidden_1 não.
• Defina o Padrão antes de salvar. Não há segunda chance do lado do Elementor; um padrão vazio renderiza uma string vazia em todos os lugares onde o token aparece.
• Cite em JS. O valor é uma string, então escreva var key = "{{ map_style_key }}"; com citações.
• Prefira um campo visível quando os usuários precisarem de controle. No momento em que um valor deve diferir por página, troque o campo Oculto por a Texto ou Selecione campo em vez de pedir aos usuários para editar widget interno.
• Sem segredos. O valor acaba na saída da página pública, portanto, trate-o como visível para qualquer pessoa que leia a fonte.

Perguntas frequentes #

Embrulhando #

O campo Oculto do Construtor de Widgets resolve um problema silencioso, mas real: valores um widget depende que nenhum editor deve tocar Defini-lo uma vez, imprimir seu token onde necessário, e as constantes navios com o widget em todos os lugares onde ele é usado Quando um valor deve ser editável, afinal, alcance um campo visível como Número ou Texto em vez disso Explore o resto do Widgets e extensões Master Addons, e veja o página preços para o que cada plano inclui.