O Campo alternador coloca o familiar sim/não do Elementor alternar em um widget personalizado Um filme no painel e um emblema aparece, um layout se aperta ou um bloco inteiro de marcação desliga-se Dentro dos Master Addons Construtor de widgets, o Switcher é a maneira padrão de tornar opcional qualquer parte de um widget.
O Switcher é o campo de origem mais comum Condições: armazena yes quando ligado, então outros controles podem mostrar ou esconder com base nele Na extremidade frontal, o Mecanismo de modelo de sintaxe dupla permite encerrar a marcação {% if my_toggle %} portanto, a alternância também controla a saída. Ambas as guias cobrem a configuração e as limitações.
Seu valor é deliberadamente simples: uma string como yes quando o alternador está ligado, uma string vazia quando está desligada Que mapeia diretamente para condicionais de modelo Na prática, quase todos os Switcher acabam embrulhados em um {% if %} bloquear ou conduzir as Condições de outros controlos.
O que o campo Switcher faz #
- O botão liga/desliga do Renders Elementor no painel de widgets, com suas próprias etiquetas liga/desliga.
- Retorna uma string configurável (padrão
yes) quando ligado e uma string vazia quando desligado. - Conduz
{% if %}blocos no modelo, portanto, a marcação é renderizada somente quando a alternância está ativada. - Comuta as classes CSS em linha, por exemplo
class="card {% if compact_mode %}is-compact{% endif %}". - Atua como o driver habitual para Condições em outros campos, mostrando ou ocultando grupos inteiros de controles.
Construindo seu primeiro widget? Comece com o Visão geral do Widget Builder, então volte aqui.
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 cartão de preços com um Switcher nomeado
show_badgeisso revela uma fita “Popular” no cartão.
Como adicionar um campo Switcher #
Arraste o Comutador campo do painel de campos em uma seção abaixo do Conteúdo ou Estilo aba. Suas opções abrem à esquerda assim que pousar.
Opções de campo do switcher explicadas #
- Etiqueta: o texto mostrado ao lado da alternância no Elementor, por exemplo “Show Badge”.
- Nome: o identificador exclusivo a que seus modelos se referem. Apenas letras, números e sublinhados, por exemplo
show_badge. - Etiqueta ligada/etiqueta desligada: os textos curtos sobre a alternância em si, “Yes” e “No” por padrão.
- Valor de retorno: a string que o campo segura enquanto está ligado,
yespor padrão. altere-o quando seu modelo ou script espera uma string específica. - Predefinição: defina-o como Valor de Retorno para iniciar a alternância; deixe-o vazio para começar.
Observe que o valor padrão e de retorno deve corresponder exatamente para que a alternância comece. Se você alterar o valor de retorno para enabled mas deixe o padrão em yes, o widget aparece com a alternância e nenhum erro informa por quê.
Conecte o Switcher com um bloco {% if %} #
O Switcher é um campo de token, mas raramente você imprime seu token por conta própria Desligado significa string vazia, e uma string vazia é falsidade na lógica do modelo, então o padrão natural é uma condicional no painel HTML:
{% if show_badge %}
<span class="pc-badge">Popular</span>
{% endif %}Alternar, o emblema renderiza Alternar, a marcação desaparece completamente, não deixando nenhum invólucro vazio para trás O mesmo padrão troca de classes sem marcação extra:
<article class="pc-card {% if compact_mode %}is-compact{% endif %}">O outro trabalho do Switcher é dirigir Condições. Qualquer campo no widget pode ser definido para aparecer somente quando o Switcher estiver ligado, portanto, alternar “Show Badge” também pode revelar um campo Texto do emblema e um controle de cor do emblema no painel Isso mantém o painel curto até que a opção esteja realmente em uso.
Cuidado: se você comparar o valor explicitamente, compare com a string Return Value, não com o rótulo. {% if show_badge == 'yes' %} corresponde ao Valor de Retorno padrão; {% if show_badge == 'Yes' %} nunca corresponde, porque “Yes” é apenas o texto de exibição do alternador Bare truthiness, {% if show_badge %}, contorna o problema.
Use o controle Switcher no Elementor #
Adicione seu widget personalizado a uma página no Elementor (recarregue o editor se a página já estiver aberta).O Switcher mostra como o Elementor padrão alternar sob seu rótulo Clique nele e a visualização atualize imediatamente; quaisquer campos condicionados a ele aparecem ou desaparecem no painel ao mesmo tempo.
Casos de uso comum #
- Crachás e fitas opcionais em cartões, embrulhados em um
{% if %}bloquear. - Variantes de layout como um modo compacto, aplicado como uma classe modificadora.
- Mostrar/ocultar seções como uma nota de rodapé, um ícone ou um botão secundário.
- Interruptores de recursos para scripts, onde o painel JS lê o valor para ativar a reprodução automática ou animação.
- Guardião painel, revelando um grupo de controles relacionados somente quando seu recurso estiver ativado.
Dicas para trabalhar com o campo Switcher #
- Teste a veracidade, não os rótulos.
{% if show_badge %}a maioria dos modelos precisa; o estado ligado é uma string não vazia e o estado desligado está vazio. - Enrole todo o bloco opcional. Coloque o
{% if %}em torno da marcação completa, wrapper incluído, portanto, uma alternância não deixa elementos vazios para quebrar o espaçamento. - Predefinição deliberadamente. Inicie a alternância (Padrão = Valor de retorno) para recursos que a maioria dos sites deseja, desativado para extras.
- Combine-o com Condições. Um Switcher mais dois ou três campos condicionados tem uma leitura muito melhor no painel do que cinco controles sempre visíveis.
- Nomeie-o como uma pergunta que a alternância responde.
show_badgeecompact_modeleia naturalmente por dentro{% if %}blocos.
Perguntas frequentes #
Qual é o campo Switcher no Master Addons Widget Builder?
O campo Switcher adiciona o botão liga/desliga do Elementor a um widget personalizado Quando ativado, ele mantém sua string Return Value (Valor de Retorno)yes por padrão); quando desligado, ele contém uma string vazia. Os modelos normalmente envolvem a marcação opcional {% if field_name %} ... {% endif %} para reagir a isso.
Qual o valor que o Switcher realmente armazena?
Uma string. On significa o Valor de Retorno que você configurou, off significa uma string vazia Não existe um booleano verdadeiro/falso, e é por isso que comparações explícitas devem corresponder exatamente ao Valor de Retorno.
Como mostro marcação somente quando a alternância está ativada?
Envolva-o em um condicional no painel HTML: {% if show_badge %}<span class="badge">Popular</span>{% endif %}. O bloco não renderiza nada enquanto a alternância está desligada.
Um Switcher pode mostrar ou ocultar outros campos no painel?
Sim, e é o driver mais comum para isso Defina o Condições em qualquer outro campo para exigir o valor do Switcher, e esses controles aparecem no Elementor somente enquanto o alternador está ligado.
Por que minha verificação {% if show_badge == 'Yes' %} nunca passa?
Porque “Yes” é o texto Label On do alternador, não o seu valor O valor armazenado é o Valor de Retorno, yes em minúsculas por omissão Compare com isso, ou simplesmente use {% if show_badge %}.
Posso alterar o que o campo retorna quando ligado?
Sim, através da opção Return Value Isto é útil quando o painel JS espera uma cadeia de sinalização específica, ou quando imprime o valor directamente num atributo de dados.
Embrulhando #
O campo Widget Builder Switcher é o menor controle com o alcance mais amplo: uma alternância pode adicionar marcação, trocar classes e remodelar o painel por meio de Condições de uma só vez. Combine-o com um Campo numérico para recursos ajustáveis ou a Campo repetidor cujos extras opcionais revela Explore o resto do Widgets e extensões Master Addons, e veja o página preços para o que cada plano inclui.
