2.1.1.6. Secciones

API-IDEE contempla en su modelo de datos el concepto de Agrupación de Capas o Section. Esta agrupación nace con el fin de facilitar la gestión de aquellas capas que, por cuestiones conceptuales u organizativas, deban alojarse dentro de un mismo contenedor, proporcionando una serie de métodos para su manipulación.

// Creación de una capa Section
let section = new IDEE.layer.Section({
  idSection: 'id_section_1',
  title:  'Sección 1',
  collapsed: true,
  zIndex: 100000,
  children: [provincias, campamentos, capaWMS],
  order: 0
 }
);

Donde:

• idSection: Identificador interno de la sección.
• title: Identificador externo, que generalmente se muestra al usuario.
• children: Array con las capas que se desea agrupar.
• collapsed: (opcional) Booleano que indica si ante un posible TOC la agrupación debiera aparecer inicialmente plegada (true) o desplegada (false).
• zIndex: (opcional) Zindex de la agrupación. Las capas internas parten de este valor.
• order: (opcional) Orden de la sección en un posible TOC.

Una sección puede contener y combinar capas ráster y vectoriales, tal y como puede comprobarse en el ejemplo funcional anterior.

Desde la api se proporcionan también los siguientes métodos para trabajar con ellas:

// El método getLayers del mapa sigue devolviendo únicamente Capas:
let todasLasCapas =  mapajs.getLayers();

// Obtener un array con las secciones:
let sections = mapajs.getSections();

// Obtener un array con los elementos de una sección:
let children = section.getChildren();

// Sacar un elemento de la sección
section.ungroup(provincias);

// Activar o desactivar todas los elementos de la sección a la vez
section.setVisible(false);

Los métodos addChild, addChildren, deleteChild y deleteChildren permiten gestionar los hijos o capas de una sección.

También es posible definir secciones de WMS dentro de los contextos de mapas WMC.

<General>
   ...
     <Extension>
          ...
          <ol:group xmlns:ol="http://openlayers.org/context" id="nivel0" title="Layers" orderInsideGroupDisplay="0">
	     <ol:group id="GROUP_363" title="Divisones" orderInsideGroupDisplay="1" />
	     <ol:group id="GROUP_364" title="Infraestructuras" orderInsideGroupDisplay="0" />
          </ol:group>
     </Extension>		
   ...
 </General>
 <LayerList>
     <Layer hidden="0" queryable="1">
	...
        <Extension>
	   ...
	   <ol:groupDisplayLayerSwitcher xmlns:ol="http://openlayers.org/context">GROUP_364</ol:groupDisplayLayerSwitcher>
	   <ol:orderInsideGroupDisplayLayerSwitcher xmlns:ol="http://openlayers.org/context">1</ol:orderInsideGroupDisplayLayerSwitcher>
        </Extension>
	...
     </Layer>
 </LayerList>