El Campo oculto es el único control en los complementos maestros Creador de widgets que los editores nunca ven. Tiene un valor fijo que estableces una vez en el generador, digamos una cadena de versión o una clave de diseño. El valor viaja con el widget e imprime a través de un token de plantilla, pero no aparece ninguna entrada en ninguna parte del panel Elementor.
Incluso el campo Oculto lo admite Condiciones, y su valor almacenado se imprime a través del Motor de plantilla de sintaxis de ramita como cualquier otro token, puedes hacer referencia a él {% if %} consulta toda tu plantilla. Ambas guías cubren los detalles.
Eso lo convierte en el hogar adecuado para las constantes que necesita su plantilla, pero los usuarios no deben editar. Cualquier cosa que un cliente curioso pueda cambiar por accidente permanece fuera de su alcance. Sus paneles HTML, CSS y JS aún pueden leerlo como cualquier otro valor.
Lo que hace el campo Oculto #
- Almacena un valor de cadena fijo definido en el constructor, sin control visible en Elementor.
- Imprime ese valor en cualquier parte del panel HTML, CSS o JS del widget
{{ your_field_name }}. - Mantiene las constantes de configuración fuera de la interfaz de usuario de edición, por lo que no se pueden cambiar por página.
- Se comporta como un valor de texto en lógica de plantilla, por lo que condicionales como
{% if mode == 'embed' %}trabajar.
Si este es su primer widget personalizado, lea el Descripción general del creador de widgets antes de esta página; cubre el diseño del editor que asumen los documentos de campo.
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.
- Se abre un widget personalizado en el editor Widget Builder. Nuestro ejemplo es un widget de inserción de mapas donde se nombra un campo oculto
map_style_keylleva el identificador de estilo de mapa fijo que espera el script de inserción.
Cómo agregar un campo oculto #
Arrastra el Oculto campo desde el panel de campos a cualquier sección. La pestaña no importa aquí, ya que nada se representa en el panel de ninguna manera. Sus opciones se abren a la izquierda tan pronto como aterriza.
Se explican las opciones de campo ocultas #
La lista de opciones es corta por diseño:
- Etiqueta: un nombre para tu propia referencia dentro del constructor. Nunca se muestra en Elementor.
- Nombre: el identificador único al que se refieren sus plantillas. Sólo letras, números y guiones bajos, por ejemplo
map_style_key. - Predeterminado: el valor que tiene el campo. Dado que no hay una interfaz de usuario que la cambie más tarde, este es efectivamente el valor, punto.
Conecte el campo Oculto con su token #
El campo Oculto es un campo de token. Imprímelo exactamente como un valor de texto, en cualquiera de los tres paneles:
<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>
// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);La lógica de plantilla también puede bifurcarse en él. Si envía dos modos internos del mismo widget, un campo oculto puede elegir la rama sin exponer la elección:
{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}Un modo de falla silencioso que debes conocer: si cambias el nombre del campo más tarde, cada token que aún apunta al nombre anterior imprime una cadena vacía. Nada de error, el widget simplemente se representa en blanco donde solía estar la constante. Después de cambiar el nombre, busque en los tres paneles el nombre anterior antes de guardarlo.
Ai grijă: un campo oculto es invisible, no secreto. Su valor aún se representa en el marcado de la página o en el script que los visitantes pueden ver-fuente. Mantenga fuera de él las claves y credenciales de API privadas; es para constantes de configuración, no para secretos.
Utilice el campo Oculto en Elementor #
Agregue su widget personalizado a una página en Elementor. El panel muestra todos los demás controles que definió y nada para el campo Oculto. Esa ausencia es la característica. El valor ya está aplicado y el widget renderizado lo refleja desde la primera caída.
Casos de uso comunes #
- Claves de diseño que CSS o JS interno se ramifica, corregido por widget.
- Cadenas de versión estampado en un atributo de datos para depurar widgets enviados.
- Banderas de modo API como un tipo de inserción que lee el script del widget.
- Se corrigieron fragmentos de nombres de clases impreso en el marcado para que una familia de widgets comparta ganchos de estilo.
- Plantilla de conmutadores de rama cuando exporta un widget en dos variantes internas.
Consejos para trabajar con el campo Oculto #
- Nómbralo como la constante que es.
map_style_keyle dice al siguiente mantenedor qué significa el token;hidden_1no. - Establezca el valor predeterminado antes de guardarlo. No hay una segunda oportunidad desde el lado Elementor; un valor predeterminado vacío representa una cadena vacía en todos los lugares donde aparece el token.
- Cítelo en JS. El valor es una cadena, así que escribe
var key = "{{ map_style_key }}";con citas. - Prefiera un campo visible una vez que los usuarios necesiten control. En el momento en que un valor debe diferir por página, cambie el campo Oculto por a Texto o Seleccionar campo en lugar de pedir a los usuarios que editen los componentes internos del widget.
- Sin secretos. El valor termina en la salida de la página pública, así que trátelo como visible para cualquiera que lea la fuente.
Preguntas frecuentes #
¿cuál es el campo Oculto en Master Addons Widget Builder?
El campo Oculto almacena un valor fijo dentro de un widget Elementor personalizado sin representar ningún control en el panel. Usted establece el valor una vez en el generador y las plantillas lo imprimen {{ field_name }} en el panel HTML, CSS o JS. Los editores no pueden verlo ni cambiarlo.
¿por qué usaría un campo oculto en lugar de codificar el valor en mi HTML?
Centralización. Cuando aparece la misma constante en varios lugares de los paneles HTML, CSS y JS, un campo Oculto los mantiene sincronizados y actualizar el widget más tarde significa cambiar un valor predeterminado en lugar de buscar en tres paneles.
¿pueden los usuarios cambiar el valor de un campo oculto en Elementor?
No. El campo no representa ninguna entrada en el panel, por lo que su valor se fija en cualquier valor predeterminado que establezca en el generador. Cambiarlo requiere editar el widget en el propio Widget Builder.
¿puedo usar el valor del campo Oculto en los condicionales de plantilla?
Sí. Se comporta como cualquier valor de texto, entonces {% if widget_mode == 'compact' %} funciona. Esto permite que la definición de un widget lleve un conmutador interno con el que los usuarios nunca interactúan.
¿el valor del campo Oculto es privado?
No. Está oculto del panel de edición, pero se representa en la página como cualquier otro token, donde cualquiera puede leerlo en el origen de la página. No almacene secretos o credenciales de API en él.
¿el campo Oculto está disponible en la versión gratuita?
El campo Oculto pertenece al conjunto de control gratuito, junto con conceptos básicos como Texto y Área de texto. La experiencia completa de Widget Builder con la biblioteca de campos completa es parte de Master Addons Pro; ver el página de precios para detalles.
Envolviendo #
El campo Oculto del Creador de widgets resuelve un problema silencioso pero real: los valores que un widget depende de que ningún editor debe tocar. Defínelo una vez, imprima su token cuando sea necesario y la constante se envía con el widget a todas partes donde se utiliza. Cuando un valor debe ser editable después de todo, busque un campo visible como Número o Texto en su lugar. Explora el resto del Widgets y extensiones de complementos maestros, y mira el página de precios por lo que incluye cada plan.
