jsdoc externo node

Node

Métodos y propiedades añadidos al prototipo de Node.

Métodos

removerArrastre()

removerDestino()

arrastrable(opciones)

Hace a los elementos arrastrables. Establecer opciones=false para deshabilitar.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
opciones

crearDestino(opciones)

Hace que los elementos admitan que se suelte otro elemento dentro de sí. Establecer opciones=false para deshabilitar.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
opciones

crearDestinoArchivo(opciones)

Hace que los elementos acepten arrastrar y soltar archivos desde el escritorio del cliente sobre ellos. Establecer opciones=false para deshabilitar.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
opciones

pausarArrastre([pausar])

Detiene momentáneamente o reestablece las operaciones de arrastre para el elemento.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
pausar	boolean	Pausar (true) o restaurar (false).	Si	true

Devuelve: Node

pausarArrastreArbol(estado)

Aplica pausarArrastre(estado) en el elemento y toda su ascendencia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
estado	boolean	Activar o adesactivar.

Devuelve: Node

pausarArrastreArbolDesc(estado)

Aplica pausarArrastre(estado) en el elemento y toda su descendencia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
estado	boolean	Activar o adesactivar.

Devuelve: Node

obtenerId()

Devuelve el ID del elemento, inicializandolo si es necesario.
Devuelve: number

inicializarMetadatos()

Inicializa los metadatos de un elemento del DOM. Trabaja con una instancia de Element (no objetoDom).

metadato(clave,valor)

Establece o devuelve matadatos del elemento. Trabaja con un almacén de metadatos común a todos los elementos.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
clave
valor

metadatos()

Devuelve todos los metadatos del elemento.

dato(clave,valor)

Establece o devuelve datos (dataset) del elemento.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
clave
valor

datos()

Devuelve todos los datos (dataset) del elemento.

buscar(sel)

Acceso directo a querySelectorAll(sel).

Parámetro	Tipo	Descripción	Opcional	Predeterminado
sel

buscarEnfocables()

Devuelve los elementos que puedan recibir foco. Nótese que devuelve un array (no NodeList).
Devuelve: Node[]

hijos([filtro])

Devuelve los hijos directos del elemento.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
filtro	Object	Filtra los elementos resultantes.	Si

valor(valor)

Devuelve o establece el valor del campo.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
valor

anexar(elemento)

Agrega los elementos especificados a los elementos de esta instancia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento

anteponer(elemento)

Agrega los elementos especificados antes del primer hijo de esta instancia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento	Node	Elemento a anteponer.

Devuelve: Node

insertarAntes(elemento)

Agrega los elementos especificados a antes de los elementos de esta instancia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento

insertarDespues(elemento)

Agrega los elementos especificados después de los elementos de esta instancia.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento

anexarA(elemento)

Agrega este elemento a los elementos especificados.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento

anteponerA(elemento)

Agrega este elemento como primer hijo de los elementos especificados.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
elemento	Node	Elemento de destino.

Devuelve: Node

es(filtro)

Determina si el elemento coincide con el filtro. Todas las propiedades deben coincidir, pero todos fitros con múltiples elementos se evalúan como OR. Los valores de los filtros se evalúan como cadena (no es sensible al tipo).

Parámetro	Tipo	Descripción	Opcional	Predeterminado
filtro	Object	Filtro.

Propiedades de filtro

Propiedad	Tipo	Descripción	Opcional	Predeterminado
clase	string|RegExp	Tiene la(s) clase(s) css. Coincidencia exacta o RegExp.	Si
nombre	string|RegExp	Atributo name. Coincidencia exacta o RegExp.	Si
id	string|RegExp	Atributo id. Coincidencia exacta o RegExp.	Si
etiqueta	string|RegExp	Nombre de tag. Coincidencia exacta o RegExp.	Si
atributos	string|RegExp	Valor de atributos. Objeto {atributo:valor}. Coincidencia exacta o RegExp.	Si
propiedades	string|string[]	Propiedades (readonly, disabled, etc.). Cadena o Array. Coincidencia exacta.	Si
datos	string|RegExp	Datos (dataset). Objeto {nombre:valor}. Coincidencia exacta o RegExp.	Si
metadatos	string|RegExp	Metadatos (internos). Objeto. Coincidencia exacta o RegExp.	Si
tipo	string|RegExp	Tipo de campo {nombre:valor}. Coincidencia exacta o RegExp.	Si
elemento	Node	Instancia de un nodo o elemento.	Si
visible	boolean	Visibilidad. Nótese que un elemento oculto mediande visibility u opacidad se considera visible ya que forma parte del DOM.	Si

Devuelve: boolean

esCampo()

Determina si el nodo es un campo de formulario.

padre(filtro)

Busca en la ascendencia el elemento que coincida con el filtro, o devuelve el padre directo si filtro no está definido.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
filtro

padres(filtro)

Busca en la ascendencia todos los elementos que coincidan con el filtro.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
filtro

agregarClase(clase)

Agrega una clase css a los elementos. Soporta múltiples clases separadas por espacios.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
clase

removerClase(clase)

Remueve una clase css de los elementos. Soporta RegExp o múltiples clases separadas por espacios.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
clase

alternarClase(clase)

Alterna una clase css en los elementos. Soporta RegExp o múltiples clases separadas por espacios.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
clase

atributo(nombre,valor)

Establece o devuelve el valor de un atributo.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
nombre
valor

removerAtributo(nombre)

Remueve un atributo.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
nombre

propiedad(nombre,valor)

Devuelve o asigna una propiedad.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
nombre
valor

posicion()

Devuelve un objeto {x,y} con la posición relativa del elemento.

posicionEstilos()

Devuelve un objeto {x,y} con la posición del elemento según está establecido en sus estilos.

posicionAbsoluta()

Devuelve un objeto {x,y} con la posición absoluta del elemento.

estilos(estilo,valor)

Devuelve el valor del estilo, si valor no está definido, o asigna el mismo. Estilo puede ser un objeto para establecer múltiples estilos a la vez.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
estilo
valor

estilo(estilo,valor)

Alias de estilos(estilo,valor).

Parámetro	Tipo	Descripción	Opcional	Predeterminado
estilo
valor

ancho()

Devuelve el ancho del elemento, incluyendo bordes (pero no márgenes). Si el elemento es document, devolverá el ancho de la página. Si el elemento es window, devolverá el ancho de la ventana (viewport).

alto()

Devuelve el alto del elemento, incluyendo bordes (pero no márgenes). Si el elemento es document, devolverá el alto de la página. Si el elemento es window, devolverá el alto de la ventana (viewport).

obtener(i)

Devuelve a sí mismo. El único propósito es que pueda llamarse obtener(x) en un elemento tal como si fuera NodeList, ahorrando verificar el tipo primero.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
i

obtenerHtml()

Acceso a innerHTML.

establecerHtml(html)

Acceso a innerHTML.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
html

establecerTexto(texto)

Acceso a innerText.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
texto

Devuelve: Node

obtenerTexto()

Acceso a innerText.
Devuelve: string

clonar(conEventosDatos)

Clona el elemento.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
conEventosDatos

remover()

Elimina el elemento.

desacoplar()

Desacopla el elemento del DOM (sin eliminarlo).

editable(estado)

Establece la propiedad contentEditable.

Parámetro	Tipo	Descripción	Opcional	Predeterminado
estado

iniciarEdicion()

Activa el modo de edición.

finalizarEdicion()

Desactiva el modo de edición.