Estructura HTML de controles de la API SITNA

Seleccione un control de la lista y se mostrará en tiempo real su HTML y una explicación de sus clases CSS relevantes.


    

Uso de clases CSS en la API SITNA

Para crear la interfaz de usuario, la API SITNA dibuja en la página una gran cantidad de elementos HTML. Para marcarlos como elementos de la interfaz de usuario de los objetos de la API SITNA, se les añade una serie de clases CSS con un nombre convenido, de forma que es fácil modificar el aspecto de los controles de la API mediante reglas CSS, e identificar elementos de interfaz mediante selectores CSS.

El nombre de las clases CSS usadas en la API SITNA es sistemático: todas empiezan con el prefijo tc-, y si un elemento está anidado dentro de otro, generalmente su nombre empieza con el nombre del elemento padre (p.e. el elemento con la clase tc-ctl-lcat-search está dentro del elemento con la clase tc-ctl-lcat). Esta no es una regla estricta, porque ciertos elementos son muy genéricos y tienen un nombre más sencillo (p. e., dentro de un elemento con clase tc-ctl-lcat existe un elemento con clase tc-textbox, que se utiliza para dar estilo a todas las cajas de texto de la API SITNA).

Aparte de las clases CSS que definen elementos de la interfaz de usuario, hay otras clases CSS que definen estados de elementos que son relevantes desde el punto de vista de esa interfaz (p. e., el elemento está oculto, o es un nodo de un árbol que está replegado, o es una herramienta que está activa).

En general, cualquier cambio de estado en la interfaz de usuario se define añadiendo o quitando clases de este tipo a elementos HTML de la aplicación (p. e., si un elemento debe ocultarse de la interfaz, en vez de ponerle una regla de estilo display:none la API le añade la clase tc-hidden).

TODO: explicación de attribution
TODO: explicación de basemapSelector
TODO: explicación de coordinates

Clases que definen elementos de interfaz

Clase CSS Función que desempeña el elemento que tiene la clase
tc-map Interfaz de una instancia de la clase SITNA.Map. Generalmente un <div>, es el elemento cuyo id se pasa como parámetro al constructor de la clase SITNA.Map. En él se dibuja el viewport del mapa y todos los elementos del layout.
tc-ctl Interfaz de un control. Los controles se renderizan en un elemento definido por la opción div de la configuración propia del control.
tc-ctl-lcat Interfaz del control layerCatalog.
tc-ctl-lcat-search Parte de la interfaz que contiene el buscador de capas disponibles, con su cuadro de texto y su lista de resultados.
tc-group Un elemento de interfaz que contiene un grupo de subelementos.
tc-ctl-lcat-input Un elemento de introducción de texto en el control layerCatalog.
tc-textbox Un elemento de introducción de texto de un control.
tc-ctl-lcat-search-group En los resultados de búsqueda de capas, el conjunto de resultados que se corresponden con uno de los nodos raíz del árbol de capas disponibles. En la práctica, suele ser el conjunto de resultados de búsqueda de uno de los servicios WMS que tenemos añadidos al catálogo.
tc-ctl-lcat-search-btn-info Botón junto al nombre de la capa que nos abre el panel de información adicional de la capa.
tc-ctl-lcat-tree Elemento donde se muestra el árbol de capas disponibles.
tc-ctl-lcat-branch Lista de nodos del árbol de capas disponibles.
tc-ctl-lcat-node Nodo del árbol de capas disponibles.
tc-ctl-lcat-info Panel que muestra información adicional de la capa (descripción, enlaces a metadatos).
tc-ctl-lcat-info-close Botón para cerrar el panel de información adicional de la capa.
tc-ctl-lcat-title En el panel de información adicional de la capa, título de la capa.
tc-ctl-lcat-abstract Texto descriptivo de la capa.
tc-ctl-lcat-metadata Sección con los enlaces a los metadatos de la capa.

Clases que definen estados

Clase CSS Función que desempeña el elemento que tiene la clase
tc-collapsed Un elemento desplegable de la interfaz (por ejemplo, una rama del árbol de capas disponibles) está replegado.
tc-checked En un nodo de capas disponibles, indica que la capa ya está añadida.
tc-hidden El elemento está oculto a la vista del usuario.
tc-selectable El elemento corresponde a una capa que es elegible para ser añadida al mapa.
tc-loading El elemento es un nodo del árbol o de los resultados de búsqueda que ha sido seleccionado por el usuario para añadirse al mapa, pero la carga de la capa en el mapa no ha terminado todavía.
tc-active Elemento biestado que está activo. Por ejemplo, el botón del idioma en el que está el visor actualmente.
TODO: explicación de legend
TODO: explicación de measure
TODO: explicación de TOC
TODO: explicación de workLayerManager