O Campo numérico adiciona uma entrada numérica simples ao painel de um widget personalizado Contagens de colunas, larguras de pixels, itens por slide, classificações por estrelas: qualquer configuração que só faça sentido como um número pertence aqui Dentro dos Complementos Mestres Construtor de widgets, você define o intervalo permitido uma vez e o editor obtém uma entrada que só aceita números dentro dele.
O campo Número suporta Condições por mostrar ou ocultar o controle baseado em outro campo, e seu token renderiza através do construtor Mecanismo de modelo de sintaxe dupla, onde comparações numéricas como {% if price > 0 %} trabalhe fora da caixa Ambas as guias cobrem a configuração e as limitações.
O valor se conecta ao seu widget por meio de um token de modelo. Escrever {{ your_field_name }} no painel HTML, CSS ou JS e o número é impresso lá no momento da renderização Um controle pode conduzir marcação, estilo e comportamento de script ao mesmo tempo.
O que o campo Número faz #
- Rende uma entrada numérica no painel Elementor do widget, com setas giratórias do navegador.
- Reforça um alcance através Min, Máximo, e Passo opções que você define no construtor.
- Produz um número simples onde quer que você coloque o seu
{{ token }}no painel HTML, CSS ou JS. - Funciona em comparações, para que o modelo possa ser ramificado
{% if my_number > 3 %}. - Suporta o mecanismo de seletores do Elementor como uma fiação alternativa, escrevendo o valor diretamente em uma regra CSS.
Nunca construiu um widget com o construtor antes? o Visão geral do Widget Builder percorre o próprio editor e vale dez minutos antes de entrar em campos individuais.
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 carrossel de logotipo do cliente onde um campo Número nomeado
logos_per_slidecontrola quantos logotipos mostram de uma vez.
Como adicionar um campo Número #
Arraste o Número campo do painel de campos em uma seção abaixo do Conteúdo ou Estilo tab. Assim que aterrar, as opções do campo abrem-se no lado esquerdo do construtor.
Opções de campo numérico explicadas #
- Etiqueta: o texto mostrado ao lado da entrada em Elementor, por exemplo “Logos Per Slide”.
- Nome: o identificador exclusivo a que seus modelos se referem. Apenas letras, números e sublinhados, por exemplo
logos_per_slide. - Predefinição: o número com o qual o widget começa em uma nova gota.
- Espaço reservado: texto de dica mostrado enquanto a entrada está vazia.
- Mínimo/máx: os valores mais baixos e mais altos que a entrada aceita.
- Etapa: o incremento pelo qual as setas giratórias se movem, por exemplo
1para números inteiros ou0.5para meios passos. - Descrição: texto auxiliar opcional sob o controle.
- Mostrar etiqueta, bloco de etiquetas, separador: o display padrão alterna, além de condições para mostrar o campo somente quando outro controle tiver um determinado valor.
Conecte o campo Número com seu token #
O campo Número é um campo de token. Onde quer que {{ logos_per_slide }} aparece num painel, o valor actual imprime no seu lugar Todos os três painéis aceitam:
<!-- HTML panel -->
<div class="logo-track" data-count="{{ logos_per_slide }}">
/* CSS panel */
.logo-track { grid-template-columns: repeat({{ logos_per_slide }}, 1fr); }
.logo-item { min-width: {{ logo_min_width }}px; }
// JS panel
var perSlide = {{ logos_per_slide }};Uma coisa que falha silenciosamente aqui: um campo vazio imprime uma string vazia e repeat(, 1fr) não é CSS válido, então o navegador descarta toda a regra sem reclamação. Se o token alimentar uma expressão CSS ou JS, defina um padrão para que um novo widget nunca seja renderizado com um buraco nele.
Como o valor é um número, as comparações funcionam na lógica do modelo Um carrossel pode pular suas setas de navegação quando tudo já cabe em um slide:
{% if logos_per_slide > 4 %}
<button class="logo-nav">→</button>
{% endif %}O campo também suporta o da Elementor seletores fiação como alternativa Observe que, para Número, o Elementor injeta o valor simples em vez de uma declaração completa, portanto, a entrada dos seletores deve soletrar toda a propriedade, por exemplo width: {{VALUE}}px;.
Cuidado: quando o token cair dentro de uma expressão CSS ou JS, coloque a unidade fora do aparelho. width: {{ logo_min_width }}px funciona; esperar que o campo carregue sua própria unidade não, porque o valor é um número simples Se você precisar que o editor escolha a unidade também, o campo Slider será o melhor ajuste.
Use o controle Número no Elementor #
Solte seu widget personalizado em uma página no Elementor (recarregue o editor primeiro se a página já estiver aberta).O campo Número aparece como uma pequena entrada com setas giratórias sob o rótulo que você definiu Digite um valor ou clique nas setas As atualizações de visualização ao vivo, e os valores fora do intervalo Min/Max são rejeitados pela própria entrada.
Casos de uso comum #
- Contagens de colunas e itens impresso em uma grade CSS ou regra flexível.
- Configurações carrossel como slides por visualização ou atraso de reprodução automática, lidos pelo painel JS.
- Valores de pixel e porcentagem onde uma única unidade é fixada pelo widget, como uma largura ou lacuna de unidade fixa.
- Classificações e pontuações que o modelo se compara aos limites.
- Limites como “show no máximo N posts”, passado para o script do widget.
Dicas para trabalhar com o campo Número #
- Definir Min e Max. Uma contagem de colunas de 0 ou 40 quebrará a maioria dos layouts; delimitar a entrada no construtor é mais barato do que guardá-la no modelo.
- Corresponder Passo ao significado do valor. Itens inteiros obtêm
1; valores de estilo de opacidade obtêm0.1. - Envie um padrão sensato portanto, o widget é renderizado corretamente no momento em que é descartado.
- Compare com números, não com rótulos.
{% if logos_per_slide > 4 %}é lógica de modelo válida; não há rótulo de opção para comparar aqui, ao contrário de a Selecione campo. - Declarações completas em entradas de seletores. Se você conectar o campo através da opção Seletor em vez de um token, escreva a propriedade completa, pois o Elementor injeta apenas o valor simples para Número.
Perguntas frequentes #
Qual é o campo Número no Master Addons Widget Builder?
O campo Número adiciona uma entrada numérica ao painel de um widget Elementor personalizado, com opções Min, Max, Step, Default e Placeholder Seu valor é impresso por meio de um {{ token }} no painel HTML, CSS ou JS do widget, a lógica do modelo pode compará-lo com operadores como > e ==.
Posso usar o valor do campo Número no painel CSS?
Sim. Coloque o token dentro de qualquer regra, por exemplo grid-template-columns: repeat({{ columns }}, 1fr); ou width: {{ box_width }}px;. Lembre-se de escrever a unidade sozinho, já que o campo armazena apenas o número.
Como leio o valor em JavaScript?
Imprima o token diretamente no painel JS: var perSlide = {{ logos_per_slide }};. O número é renderizado no script antes de ser executado, portanto, nenhuma pesquisa DOM é necessária.
O modelo pode ramificar no valor?
Sim. Os condicionais aceitam comparações: {% if my_number > 3 %} ... {% endif %}, junto com <, >=, <=, ==, e !=. Isso é útil para ocultar navegação, crachás ou marcação extra abaixo de um limite.
O que acontece se o usuário digitar um valor fora de Min e Max?
A entrada impõe o intervalo, de modo que os valores fora de alcance não atingem o modelo Defina Min e Max no construtor para o que quer que mantenha o layout do widget intacto.
Quando devo usar o Slider em vez do Número?
Use o campo Slider quando o editor também deve escolher a unidade (px, %, em) ou arrastar uma alça dentro de um intervalo; seu valor carrega tanto um tamanho quanto uma unidade Use o Número quando um número simples for suficiente e você controlar a unidade no modelo.
Embrulhando #
O campo Número do Construtor de Widgets faz um trabalho exato: uma entrada numérica limitada, um token e o valor cai onde quer que o widget precise, em marcação, estilos ou script. Emparelhe-o com o Campo alternador para comportamento on/off e o Campo repetidor quando a contagem deve vir de itens reais em vez de uma configuração Explore o resto do Widgets e extensões Master Addons, e veja o página preços para o que cada plano inclui.