AVISO LEGAL. POR FAVOR, LEE ATÉNTAMENTE LAS CONDICIONES DE USO ANTES DE UTILIZAR ESTE SERVICIO

Compatibilidad con navegadores

La API de Lonelydrops funciona correctamente en los siguientes navegadores:

• Firefox 2.0 o superior
• Internet Explorer 6.x o superior
• Safari 4.0 o superior

Requerimientos previos

Para ejecutar la API de LonelyDrops en un navegador web, necesitarás cargar previamente el archivo del núcleo de la librería de JQuery (en versión 1.2.6 o superior). La librería de JQuery puede descargarse del sitio web oficial:

http://jquery.com

o recuperarlo en tiempo de ejecución desde los servidores de javascript de Google simplemente insertando dos líneas de código en tus páginas html.

<script src="http://www.google.com/jsapi"></script>
<script> google.load("jquery", "1.2.6"); </script>

La API de Lonelydrops se encuentra separada en diferentes archivos Javascript, accesibles bajo los siguientes archivos:

ARCHIVO DEL NÚCLEO

http://www.lonelydrops.com/drops/1.0/core.js

Contiene las funciones Javascript principales y necesarias para el correcto funcionamiento del sistema (su inclusión es obligatoria)

ARCHIVO DE UNA LISTA (agrupado por la lista padre si existe)

http://www.lonelydrops.com/drops/1.0/list/language_code/list_code

Contiene todos los datos necesarios para construir una lista específica identificada por el código (list_code) bajo un idioma específico (language_code)

Por ejemplo,
http://www.lonelydrops.com/drops/1.0/list/es/countries

En caso de necesitar la lista desagrupada, la url debería ser llamada de la siguiente manera:

http://www.lonelydrops.com/drops/1.0/list/language_code/list_code/ungrouped

¿QUÉ ES ESO DE LAS LISTAS DESAGRUPADAS?

Normalmente, las listas se encuentran agrupadas por su lista padre (si existe). Por ejemplo, la lista de países se suele descargar agrupada por su lista padre que es la lista de continentes. En algunos casos, la agrupación de los valores de la lista puede no ser deseable. Por ejemplo, las zonas horarias se encuentran agrupadas por país, pero como la mayoría de países contienen una sola zona horaria, la agrupación por país no proporciona ninguna información adicional a la lista (pero sí que incrementa su tamaño inecesariamente). En estos casos, las listas pueden ser generadas de forma desagrupada, simplemente añadiendo ungrouped al final de la url.

Por ejemplo,
http://www.lonelydrops.com/drops/1.0/list/es/timezones_by_country/ungrouped

LISTAS DISPONIBLES

IDIOMAS DISPONIBLES

Código Contenido de la lista countries Contiene una lista con todos los países del mundo continents Contiene una lista con los continentes timezones_by_country Contiene una lista con las zonas horarias spain_autonomies Lista de comunidades autónomas de España spain_provinces Lista de provincias de España agrupadas por comunidad autónoma spain_towns Lista de poblaciones de España agrupadas por provincia

Código Idioma en Inglés es Español ca Catalán

drops.fillSelect(config)

Rellena y configura un elemento SELECT de HTML según el objeto config.

config puede contener los siguientes elementos etiquetados:


• id: Contiene el identificador del elemento SELECT
• code: Contiene el código principal asociado a la lista que va a cargarse en el elemento SELECT
• parent (opcional): Puede contener un valor de la lista padre con el que se filtrarán los valores de la lista actual
• lang (opcional): Define el idioma de los valores de la lista (el Inglés se tomará por defecto en caso de que este parámetro no se encuentre definido)
• allowVoid (opcional): Indica si el SELECT debe contener un valor inicial vacío (en caso de no estar definido, allowVoid tomará el valor falso)
• voidMessage: Contiene el mensaje que se mostrará en el elemento vacío inicial
• def (opcional): Define el valor seleccionado por defecto para esta lista
• onChange (opcional): Contiene la definición de una función que será llamada cada vez que el valor del SELECT cambie de valor. Esta función no recibirá ningún parámetro de entrada y no devolverá ninguno de salida (puedes revisar alguno de los ejemplos para entender cómo funciona)

NOTA: Es necesario cargar previamente un archivo con el formato siguiente:
http://www.lonelydrops.com/drops/1.0/list/language_code/list_code

drops.getLabel(code, currValue, lang)

Devuelve el texto del valor definido por currValue de la lista definida por code en el idioma identificado por lang

NOTA: Es necesario cargar previamente un archivo con el formato siguiente:
http://www.lonelydrops.com/drops/1.0/list/language_code/list_code