dom.js que es
Miembros
-
estático , constante PS
-
Encuentra una coincidencia de un solo elemento DOM
selector
dentro de lo opcionalcontexto
de otro elemento DOM (por defecto adocumento
). -
estático , constante $$
-
Encuentra una coincidencia de todos los elementos DOM
selector
dentro de lo opcionalcontexto
de otro elemento DOM (por defecto adocumento
).
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.
-
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
ofalso
, 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 (exceptoX
yy
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 activadoDevoluciones:
boolean | undefined -Si
cierto
se devuelve, elclassToToggle
se agregará a laelemento
. Sifalso
, losclassToToggle
será eliminado de laelemento
. Siindefinido
, la devolución de llamada será ignorada.