Campo `map`
Campo map
El campo map almacena datos estructurados orientados a la ubicación.
Ideal para
- ubicaciones de oficinas
- bloques de direcciones
- secciones de contacto impulsadas por mapas
- información estructurada de lugares
Ejemplo de esquema
{ "name": "officeLocation", "label": "Office Location", "type": "map" }Uso en plantillas
<div class="office-location">
{{ officeLocation.address }}
</div>Ejemplo de renderizado del mapa:
<div class="location-map">
{officeLocation.size(800,500)}
</div>Cuándo usarlo
Usa map cuando el contenido esté verdaderamente orientado a un lugar y deba permanecer estructurado como datos de ubicación.
Cuándo no usarlo
No uses map para:
- direcciones en texto plano sin necesidad de ubicación estructurada
- detalles de contacto genéricos
Usa textarea o text si el contenido es solo texto simple.
Comportamiento en tiempo de ejecución
El campo map está diseñado para datos de ubicación estructurados y renderizado de mapas en tiempo de ejecución.
Los patrones de uso típicos incluyen:
{officeLocation}para la salida de mapa predeterminada{officeLocation.width(600)}para salida con ancho limitado{officeLocation.height(400)}para salida con alto limitado{officeLocation.size(800,500)}para dimensiones explícitas
Esto hace que map sea diferente de los campos de dirección en texto plano. El valor no es solo texto. Es una entrada de ubicación estructurada que puede renderizar un contenedor de mapa interactivo.
Notas técnicas
- usa
mapcuando la sección necesite comportamiento real de ubicación, no solo una cadena de dirección - mantén campos de texto cercanos para etiquetas, indicaciones o nombres de oficina en lugar de forzar prosa dentro del campo
map - usa dimensionamiento mediante métodos cuando el diseño necesite dimensiones controladas para el mapa
- si la página solo necesita una línea de dirección en texto plano, usa
textotextareaen su lugar