jsdoc componentedesplegable

componenteDesplegable

Componente concreto Campo desplegable.

Extiende: componente

Métodos

inicializar()

Inicializa la instancia tras ser creada o restaurada.

crear()

Crea el elemento del DOM para esta instancia.

listo()

Evento Listo.

propiedadModificada(propiedad,valor,tamano,valorAnterior)

Actualiza el componente.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
propiedad
valor
tamano
valorAnterior

establecerGrupos(grupos)

Establece las opciones del desplegable agrupadas (en <optgroup>s).

Parámetro	Tipo	Descripción	Opcional	Predeterminado
grupos	Object[]	Listado de objetos, cada un representando un grupo de opciones.

Propiedades de grupos

Propiedad	Tipo	Descripción	Opcional	Predeterminado
etiqueta	string	Etiqueta del grupo.
opciones	Object|Object[]	Listado de opciones (objeto o array, compatible con establecerOpciones()). El tipo de listado (objeto o array) debe ser el mismo en todos los grupos.
nombre	string	Nombre del grupo. Si opciones es un array, el nombre se utilizará como prefijo en los valores (nombre_0, nombre_1, etc.). Si se omite, en lugar del nombre, se utilizará el índice del grupo (comenzando desde 0).	Si

Devuelve: componente

establecerOpciones(obj)

Establece las opciones del desplegable.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
obj	Object|Object[]	Listado u objeto.

Devuelve: Componente

obtenerOpciones()

Devuelve las opciones del desplegable. Nótese que no devuelve el objeto original, sino las opciones efectivas del desplegable, siempre como objeto {valor:etiqueta,...}. Si se utilizaron grupos, sus opciones estarán combinadas en este objeto (en un solo nivel, sin las etiquetas originales).
Devuelve: Object

actualizar()

Actualiza el componente.

obtenerItem()

Devuelve el objeto correspondiente al item seleccionado.
Devuelve: Object|null

valor([valor])

Devuelve o establece el valor del campo.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
valor	*	Valor a establecer. Si se omite, devolverá el valor actual.	Si

Devuelve: *|undefined