El Campo conmutador coloca el familiar cambio de sí/no de Elementor en un widget personalizado. Aparece un movimiento en el panel y aparece una insignia, se ajusta el diseño o se desactiva un bloque completo de marcado. Dentro de los complementos maestros Creador de widgets, Switcher es la forma estándar de hacer opcional cualquier parte de un widget.
El conmutador es el campo fuente más común Condiciones: se almacena yes cuando está activado, otros controles pueden mostrarse u ocultarse según él. En la parte frontal, el Motor de plantilla de sintaxis de ramita le permite completar el marcado {% if my_toggle %} entonces, el interruptor también controla la salida. Ambas guías cubren la configuración y las limitaciones.
Su valor es deliberadamente simple: una cadena como yes cuando el interruptor está activado, una cadena vacía cuando está desactivado. Eso se asigna directamente a los condicionales de la plantilla. En la práctica, casi todos los Switcher terminan envueltos en un {% if %} bloquear o conducir las Condiciones de otros controles.
Qué hace el campo Switcher #
- Renderiza el interruptor de encendido/apagado de Elementor en el panel de widgets, con sus propias etiquetas de encendido/apagado.
- Devuelve una cadena configurable (predeterminada
yes) cuando está activado y una cadena vacía cuando está desactivado. - Accionamientos
{% if %}se bloquea en la plantilla, por lo que el marcado se representa solo cuando el interruptor está activado. - Cambia clases CSS en línea, por ejemplo
class="card {% if compact_mode %}is-compact{% endif %}". - Actúa como conductor habitual Condiciones en otros campos, mostrando u ocultando grupos enteros de controles.
¿Construyendo tu primer widget? Comience con el Descripción general del creador de widgets, entonces vuelve aquí.
Antes de empezar #
- WordPress con Elementor instalado y activo.
- Complementos maestros para Elementor instalado y activo. ¿Nuevo en el complemento? Ver el guía de instalación.
- Un widget personalizado abierto en el editor Widget Builder. Nuestro ejemplo es un widget de tarjeta de precios con un conmutador llamado
show_badgeeso revela una cinta “Popular” en la tarjeta.
Cómo agregar un campo Switcher #
Arrastra el Conmutador campo desde el panel de campos a una sección debajo del Contenido o Estilo pestaña. Sus opciones se abren a la izquierda tan pronto como aterriza.
Se explican las opciones de campo del conmutador #
- Etiqueta: el texto que se muestra junto al interruptor en Elementor, por ejemplo “Mostrar insignia”.
- Nombre: el identificador único al que se refieren sus plantillas. Sólo letras, números y guiones bajos, por ejemplo
show_badge. - Etiqueta activada / Etiqueta desactivada: los textos breves del interruptor, “Sí” y “No”, de forma predeterminada.
- Valor de devolución: la cuerda que mantiene el campo mientras está encendido,
yesde forma predeterminada. Cámbielo cuando su plantilla o script espere una cadena específica. - Predeterminado: configúrelo en el valor de retorno para iniciar el cambio; déjelo vacío para comenzar.
Tenga en cuenta que el valor predeterminado y el valor de retorno deben coincidir exactamente para que se inicie la alternancia. Si cambia el valor de retorno a enabled pero deje el valor predeterminado en yes, el widget aparece con el interruptor desactivado y ningún error le indica por qué.
Conecte el conmutador con un bloque {% if %} #
El conmutador es un campo de token, pero rara vez imprime su token por sí solo. Desactivado significa cadena vacía, y una cadena vacía es falsa en la lógica de la plantilla, por lo que el patrón natural es un condicional en el panel HTML:
{% if show_badge %}
<span class="pc-badge">Popular</span>
{% endif %}Alternar, la insignia se representa. Alternar, el marcado desaparece por completo, sin dejar ningún envoltorio vacío. El mismo patrón cambia de clase sin marcado adicional:
<article class="pc-card {% if compact_mode %}is-compact{% endif %}">El otro trabajo del Switcher es conducir Condiciones. Cualquier campo en el widget se puede configurar para que aparezca solo cuando el conmutador está activado, por lo que al alternar “Mostrar insignia” también se puede revelar un campo Texto de insignia y un control de color de insignia en el panel. Eso mantiene el panel corto hasta que la opción esté realmente en uso.
Ai grijă: si compara el valor explícitamente, compárelo con la cadena Valor de retorno, no con la etiqueta. {% if show_badge == 'yes' %} coincide con el valor de retorno predeterminado; {% if show_badge == 'Yes' %} nunca coincide, porque “Sí” es sólo el texto mostrado del interruptor. Pura veracidad, {% if show_badge %}, evita el problema.
Utilice el control Switcher en Elementor #
Agregue su widget personalizado a una página en Elementor (recargue el editor si la página ya estaba abierta). El conmutador se muestra como el Elementor estándar alternar debajo de su etiqueta. Haga clic en él y la vista previa se actualizará inmediatamente; cualquier campo condicionado aparece o desaparece en el panel al mismo tiempo.
Casos de uso comunes #
- Insignias y cintas opcionales en cartas, envuelto en un
{% if %}bloque. - Variantes de diseño como un modo compacto, aplicado como clase modificadora.
- Mostrar/ocultar secciones como una nota al pie de página, un icono o un botón secundario.
- Cambios de funciones para scripts, donde el panel JS lee el valor para habilitar la reproducción automática o la animación.
- Control de panel, revelando un grupo de controles relacionados solo cuando su función está activada.
Consejos para trabajar con el campo Switcher #
- Pruebe la veracidad, no las etiquetas.
{% if show_badge %}es todo lo que necesitan la mayoría de las plantillas; el estado activado es una cadena no vacía y el estado desactivado está vacío. - Envuelva todo el bloque opcional. Pon el
{% if %}alrededor del marcado completo, incluido el contenedor, por lo que una palanca de apagado no deja elementos vacíos para romper el espacio. - Defectuosamente. Inicie el interruptor activado (predeterminado = valor de retorno) para las funciones que la mayoría de los sitios desean, desactivado para extras.
- Combínalo con Condiciones. Un conmutador más dos o tres campos condicionados se lee mucho mejor en el panel que cinco controles siempre visibles.
- Nómbralo como una pregunta que responda el alternar.
show_badgeycompact_modelee naturalmente en el interior{% if %}bloques.
Preguntas frecuentes #
¿cuál es el campo Switcher en Master Addons Widget Builder?
El campo Switcher agrega el interruptor de encendido/apagado de Elementor a un widget personalizado. Cuando está activado, mantiene presionada su cadena Valor de retorno (yes de forma predeterminada); cuando está desactivado, contiene una cadena vacía. Las plantillas normalmente incluyen el marcado opcional {% if field_name %} ... {% endif %} reaccionar ante ello.
¿qué valor almacena realmente el Switcher?
Una cadena. Activado significa el valor de retorno que configuró, desactivado significa una cadena vacía. No existe un booleano verdadero/falso, razón por la cual las comparaciones explícitas deben coincidir exactamente con el valor de retorno.
¿cómo muestro el marcado sólo cuando la palanca está activada?
Envuélvalo en un condicional en el panel HTML: {% if show_badge %}<span class="badge">Popular</span>{% endif %}. El bloque no representa nada en absoluto mientras la palanca está desactivada.
¿puede un Switcher mostrar u ocultar otros campos en el panel?
Sí, y es el controlador más común para eso. Establecer el Condiciones en cualquier otro campo para requerir el valor del Switcher, y esos controles aparecen en Elementor solo mientras el interruptor está activado.
¿por qué mi {% si show_badge == 'Sí' %} verifica nunca pasa?
Porque “Sí” es la etiqueta de alternancia en el texto, no su valor. El valor almacenado es el valor de retorno, yes en minúsculas por defecto. Compárese con eso o simplemente úselo {% if show_badge %}.
¿Puedo cambiar lo que devuelve el campo cuando está activado?
Sí, a través de la opción Valor de retorno. Esto es útil cuando el panel JS espera una cadena de bandera específica o cuando imprime el valor directamente en un atributo de datos.
Envolviendo #
El campo Widget Builder Switcher es el control más pequeño con el alcance más amplio: una palanca puede agregar marcado, intercambiar clases y remodelar el panel a través de Condiciones, todo a la vez. Combínalo con a Campo numérico para funciones sintonizables o a Campo repetidor cuyos extras opcionales revela. Explora el resto del Widgets y extensiones de complementos maestros, y mira el página de precios por lo que incluye cada plan.
