Descripción

Activa la ventana emergente de información cuando se selecciona un elemento del mapa, ya sea entidad o primitivo. Para que funcione el popup de un elemento, no sólo debe de lanzarse esta función, sino que el elemento objetivo debe de ser seleccionable, y debe de tener habilitados los popup. En caso de que el elemento seleccionado no tenga ninguna propiedad dentro del objeto properties, el popup no se mostrará.

El título del popup corresponde con el contenido de la propiedad de nombre (properties.name). El contenido del popup será el resto de campos contenidos dentro de properties, o el contenido del campo de descripción (properties.description) en caso de que se configure el popup para mostrar una descripción en vez de una tabla.

Por defecto, el popup mostrará la información del elemento superior dentro de la pila de selección. Si se configura en modo múltiple, llevará a cabo un drill-picking, pudiendo visualizar las propiedades de los diferentes elementos seleccionados (esto es independiente de si la selección de entidades en individual o múltiple).

Invocación

popup(
	selectorHandler,
	showType,
	showZoomOption*,
	bannerColorFromFeature*
)

* Parámetros opcionales

Parámetros de entrada

selectorHandler

Parámetro que recoge el tipo de popup que se utilizará. Se toma como una cadena de texto, pudiendo ser una de las dos siguientes opciones:

1. single: para mostrar popups sencillos con la información del elemento selección más superficial.
2. multiple: para mostrar popups complejos con la información de todos los elementos en la vertical (drill-picking).

showType

Define la forma en la que se mostrará la información del elemento seleccionado. Se expone como una cadena de texto, tomando uno de estos dos valores:

1. table: mostrará la información contenida en el objeto properties como una tabla de llaves y valores.
2. description: mostrará el contenido del campo description del objeto properties formateado en HTML (acepta estilos).

showZoomOption

Parámetro opcional; de no incluirse, tomará el valor de 'showZoom'. Recibe una cadena de texto que define si aparecerá o no en el popup la opción de hacer zoom al elemento seleccionado. Acepta una de estas dos posibilidades:

1. showZoom: para mostrar la opción de hacer zoom.
2. hideZoom: para ocultar la opción de hacer zoom.

bannerColorFromFeature

Parámetro opcional. Si se incluye, el color del encabezado del banner tomará el color del fondo del billboard o punto que se selecciona. 

Ejemplos de uso

Este método tiene un funcionamiento pasivo. Para hacer uso de este método, únicamente hay que invocarlo tras definir el viewer en el código. No es posible utilizarlo en caliente (es decir, una vez que el visor se está ejecutando), ya que requiere recargar el DOM para su funcionamiento.

Popup sencillo, que muestra la información en forma de tabla, con la opción de mostrar zoom activado.

popup(
	'single',
	'table',
	'showZoom'
)

Popup sencillo, que muestra la información en forma de texto descriptivo, tomando el color de la entidad que selecciona, con la opción de mostrar zoom desactivado.

popup(
	'single',
	'table',
	'hideZoom',
	'bannerColorFromFeature'
)