dom

dom.js que es

Miembros

estático , constante PS

Encuentra una coincidencia de un solo elemento DOM selector dentro de lo opcional contexto de otro elemento DOM (por defecto a documento).

estático , constante $$

Encuentra una coincidencia de todos los elementos DOM selector dentro de lo opcional contexto de otro elemento DOM (por defecto a documento).

Métodos

addClass estático (elemento, classToAdd) → {Elemento}

Agrega un nombre de clase a un elemento.

Parámetros:
Nombre Tipo Descripción
elemento Elemento

Elemento al que agregar nombre de clase.

Clase para agregar cuerda

Nombre de clase que se va a agregar.

Devoluciones:
Elemento -

El elemento DOM con el nombre de clase agregado.

appendContent estático (el, contenido) → {Elemento}

Normaliza y añade contenido a un elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento al que añadir contenido normalizado.

contenido Módulo: DOM ~ descriptor de contenido

Valor descriptor de contenido.

Devoluciones:
Elemento -

Elemento con contenido normalizado anexado.

estático blockTextSelection()

Intente bloquear la capacidad de seleccionar texto.

static createEl (tagName opt , propiedades opt , atributos opt , contenido) → {Elemento}

Crea un elemento y aplica propiedades, atributos e inserta contenido.

Parámetros:
Nombre Tipo Atributos Predeterminado Descripción
Nombre de etiqueta cuerda <optional>
«buceo»

Nombre de la etiqueta que se va a crear.

propiedades Objeto <optional>
{}

Propiedades de elemento que se van a aplicar.

atributos Objeto <optional>
{}

Atributos de elemento que se deben aplicar.

contenido Módulo: DOM ~ descriptor de contenido

Un objeto descriptor de contenido.

Devoluciones:
Elemento -

El elemento que se creó.

vacío estático El (el) → {Elemento}

Vacía el contenido de un elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento del que vaciar los hijos

Devoluciones:
Elemento -

El elemento sin hijos

static findPosition (el) → { módulo:dom~Posición }

Obtiene la posición de un elemento en el DOM.

Usos getBoundingClientRect técnica de John Resig.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento a partir del cual obtener la compensación.

Devoluciones:
módulo: dom ~ Posición -

Posición del elemento que se pasó.

Ver:

getAttribute estático (el, atributo) → {cadena}

Obtiene el valor del atributo de un elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Un elemento DOM.

atributo cuerda

Atributo para obtener el valor.

Devoluciones:
cadena -

El valor del atributo.

getAttributes estáticos (etiqueta) → {Objeto}

Obtenga los valores de atributo de un elemento, tal como se define en la etiqueta HTML.

Los atributos no son lo mismo que las propiedades. Están definidos en la etiqueta o con setAttribute.

Parámetros:
Nombre Tipo Descripción
etiqueta Elemento

Elemento del que se obtienen los atributos de etiqueta.

Devoluciones:
Objeto -

Todos los atributos del elemento. Los atributos booleanos serán cierto o falso , otros serán cadenas.

getBoundingClientRect estático (el) → {Objeto|indefinido}

Idéntico al nativo getBoundingClientRect , pero garantiza que el método sea compatible (está en todos los navegadores que afirmamos admitir) y que el elemento esté en el DOM antes de continuar.

Esta función contenedora también modifica las propiedades que no proporcionan algunos navegadores más antiguos (es decir, IE8).

Además, algunos navegadores no admiten la adición de propiedades a un ClientRect/DOMRect objeto; entonces, lo copiamos superficialmente con las propiedades estándar (excepto X y y que no son ampliamente compatibles). Esto ayuda a evitar implementaciones donde las claves no son enumerables.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento cuyo ClientRect queremos calcular.

Devoluciones:
Objeto | indefinido -

Siempre devuelve un objeto simple - o indefinido si no puede.

getPointerPosition estático (el, evento) → { módulo: dom ~ Coordenadas }

Obtiene la posición del puntero dentro de un elemento.

La base de las coordenadas está en la parte inferior izquierda del elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento sobre el que colocar la posición del puntero.

evento Objeto del evento~Evento

Objeto de evento.

Devoluciones:
módulo: dom ~ Coordenadas -

Un objeto de coordenadas correspondiente a la posición del mouse.

hasClass estática (elemento, classToCheck) → {boolean}

Compruebe si un elemento tiene un nombre de clase.

Parámetros:
Nombre Tipo Descripción
elemento Elemento

Elemento a comprobar

Clase a comprobar cuerda

Nombre de clase para comprobar

Lanzamientos:

Se produce un error si ClassToCheck tiene espacios en blanco.

Tipo
Error
Devoluciones:
booleano -

Estarán cierto si el elemento tiene una clase, falso de lo contrario.

insertContent estático (el, contenido) → {Elemento}

Normaliza e inserta contenido en un elemento; es idéntico a appendContent (), excepto que vacía primero el elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento en el que insertar contenido normalizado.

contenido Módulo: DOM ~ descriptor de contenido

Valor descriptor de contenido.

Devoluciones:
Elemento -

Elemento con contenido normalizado insertado.

isEl estático (valor) → {booleano}

Determina, mediante escritura de pato, si un valor es o no un elemento DOM.

Parámetros:
Nombre Tipo Descripción
valor mixto

El valor a comprobar.

Devoluciones:
booleano -

Estarán cierto si el valor es un elemento DOM, falso de lo contrario.

isInFrame estático () → {booleano}

Determina si el DOM actual está incrustado en un iframe.

Devoluciones:
booleano -

Estarán cierto si el DOM está incrustado en un iframe, falso de lo contrario.

isReal estático () → {booleano}

Si la interfaz DOM actual parece ser real (es decir, no simulada).

Devoluciones:
booleano -

Estarán cierto si el DOM parece ser real, falso de lo contrario.

estático isSingleLeftClick (evento) → {booleano}

Compruebe si un evento fue un solo clic izquierdo.

Parámetros:
Nombre Tipo Descripción
evento Objeto del evento~Evento

Objeto de evento.

Devoluciones:
booleano -

Estarán cierto si un solo clic izquierdo, falso de lo contrario.

isTextNode estático (valor) → {booleano}

Determina, mediante la escritura de pato, si un valor es o no un nodo de texto.

Parámetros:
Nombre Tipo Descripción
valor mixto

Compruebe si este valor es un nodo de texto.

Devoluciones:
booleano -

Estarán cierto si el valor es un nodo de texto, falso de lo contrario.

normalizeContent estático (contenido) → {Array}

Normaliza el contenido para su posterior inserción en el DOM.

Esto permite una amplia gama de métodos de definición de contenido, pero ayuda a evitar caer en la trampa de simplemente escribir en innerHTML , lo que podría ser un problema de XSS.

El contenido de un elemento se puede pasar en varios tipos y combinaciones, cuyo comportamiento es el siguiente:

Parámetros:
Nombre Tipo Descripción
contenido Módulo: DOM ~ descriptor de contenido

Valor descriptor de contenido.

Devoluciones:
Matriz -

Todo el contenido que se pasó, normalizado a una matriz de elementos o nodos de texto.

estático anteponer(hijo, padre)

Insertar un elemento como primer nodo hijo de otro

Parámetros:
Nombre Tipo Descripción
niño Elemento

Elemento para insertar

padre Elemento

Elemento en el que insertar hijo

estático removeAttribute(el, atributo)

Elimina el atributo de un elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Un elemento DOM.

atributo cuerda

Atributo para eliminar.

removeClass estático (elemento, classToRemove) → {Elemento}

Elimina el nombre de una clase de un elemento.

Parámetros:
Nombre Tipo Descripción
elemento Elemento

Elemento del que quitar un nombre de clase.

Clase que se eliminará cuerda

Nombre de clase que se debe quitar

Devoluciones:
Elemento -

El elemento DOM con el nombre de la clase eliminado.

estático setAttribute(el, atributo, valor)

Establece el valor del atributo de un elemento.

Parámetros:
Nombre Tipo Descripción
el Elemento

Un elemento DOM.

atributo cuerda

Atributo para configurar.

valor cuerda

Valor en el que establecer el atributo.

estático setAttributes(el, atributosoptar)

Aplicar atributos a un elemento HTML.

Parámetros:
Nombre Tipo Atributos Descripción
el Elemento

Elemento al que añadir atributos.

atributos Objeto <optional>

Atributos que se van a aplicar.

Contenido de texto estático (el, texto) → {Elemento}

Inyecta texto en un elemento y reemplaza por completo cualquier contenido existente.

Parámetros:
Nombre Tipo Descripción
el Elemento

Elemento al que agregar contenido de texto

texto cuerda

El contenido de texto que se va a agregar.

Devoluciones:
Elemento -

Elemento con contenido de texto agregado.

static toggleClass (elemento, classToToggle, predicado opt ) → {Elemento}

Agrega o elimina un nombre de clase a / de un elemento dependiendo de una condición opcional o la presencia / ausencia del nombre de la clase.

Parámetros:
Nombre Tipo Atributos Descripción
elemento Elemento

Elemento en el que cambiar el nombre de una clase.

Clase para alternar cuerda

La clase que debería alternarse.

predicado booleano | módulo: dom ~ PredicateCallback <optional>

Ver el valor de retorno de módulo: dom ~ PredicateCallback

Devoluciones:
Elemento -

Elemento con una clase que se ha alternado.

estático unblockTextSelection()

Desactive el bloqueo de selección de texto.

Definiciones de tipo

ContentDescriptor()

Este es un valor mixto que describe el contenido que se inyectará en el DOM a través de algún método. Puede ser de los siguientes tipos:

Tipo Descripción
cuerda El valor se normalizará en un nodo de texto.
Elemento El valor se aceptará tal cual.
TextNode El valor se aceptará tal cual.
Matriz Matriz unidimensional de cadenas, elementos, nodos de texto o funciones. Estas funciones deben devolver una cadena, un elemento o un nodo de texto (se ignorará cualquier otro valor de retorno, como una matriz).
Función Una función, que se espera que devuelva una cadena, elemento, nodo de texto o matriz, cualquiera de los otros valores posibles descritos anteriormente. Esto significa que un descriptor de contenido podría ser una función que devuelva una matriz de funciones, pero esas funciones de segundo nivel deben devolver cadenas, elementos o nodos de texto.

Coordenadas

Representa las coordenadas xey de un elemento DOM o puntero del mouse.

Propiedades:
Nombre Tipo Descripción
X número

coordenada x en píxeles

y número

coordenada y en píxeles

Posición

Representa la posición de un elemento DOM en la página.

Propiedades:
Nombre Tipo Descripción
izquierda número

Pixeles a la izquierda.

cima número

Píxeles de la parte superior.

PredicateCallback (elemento, classToToggle) → {booleano|indefinido}

La definición de devolución de llamada para toggleClass.

Parámetros:
Nombre Tipo Descripción
elemento Elemento

El elemento DOM del componente.

Clase para alternar cuerda

los nombre de la clase que quiere ser activado

Devoluciones:
boolean | undefined -

Si cierto se devuelve, el classToToggle se agregará a la elemento. Si falso , los classToToggle será eliminado de la elemento. Si indefinido , la devolución de llamada será ignorada.