---
title: "(ES) popup()"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/2216693165/(ES)%20popup()"
format: markdown
---
> ℹ️ **Información**
> ℹ️ 
> ℹ️ Versión de implementación: beta 1.00
> ℹ️ 
> ℹ️ Actualizado en: beta 1.09

# Descripción

<span style="color: #091e42">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á.</span>

<span style="color: #091e42">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.</span>

<span style="color: #091e42">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 </span>*<span style="color: #091e42">drill-picking</span>*<span style="color: #091e42">, pudiendo visualizar las propiedades de los diferentes elementos seleccionados (esto es independiente de si la selección de entidades en individual o múltiple).</span>

# Invocación

```javascript
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

<span style="color: #091e42">Parámetro opcional; de no incluirse, tomará el valor de 'showZoom'.</span> 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~~

<span style="color: #091e42">~~Parámetro opcional. Si se incluye, el color del encabezado del banner tomará el color del fondo del billboard o punto que se selecciona~~</span><span style="color: #091e42">.</span> 

# Ejemplos de uso

<span style="color: #091e42">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.</span>


<span style="color: #091e42">Popup sencillo, que muestra la información en forma de tabla, con la opción de mostrar zoom activado.</span>

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

<span style="color: #091e42">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.</span>

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