dom.js que es
Miembros
-
estático , constante PS
-
Encuentra una coincidencia de un solo elemento DOM
selectordentro de lo opcionalcontextode otro elemento DOM (por defecto adocumento). -
estático , constante $$
-
Encuentra una coincidencia de todos los elementos DOM
selectordentro de lo opcionalcontextode 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 elementoElemento Elemento al que agregar nombre de clase.
Clase para agregarcuerda 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 elElemento Elemento al que añadir contenido normalizado.
contenidoMó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 etiquetacuerda <optional>
«buceo» Nombre de la etiqueta que se va a crear.
propiedadesObjeto <optional>
{} Propiedades de elemento que se van a aplicar.
atributosObjeto <optional>
{} Atributos de elemento que se deben aplicar.
contenidoMó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 elElemento 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
getBoundingClientRecttécnica de John Resig.Parámetros:
Nombre Tipo Descripción elElemento 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 elElemento Un elemento DOM.
atributocuerda 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 etiquetaElemento Elemento del que se obtienen los atributos de etiqueta.
Devoluciones:
Objeto -Todos los atributos del elemento. Los atributos booleanos serán
ciertoofalso, 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/DOMRectobjeto; entonces, lo copiamos superficialmente con las propiedades estándar (exceptoXyyque no son ampliamente compatibles). Esto ayuda a evitar implementaciones donde las claves no son enumerables.Parámetros:
Nombre Tipo Descripción elElemento Elemento cuyo
ClientRectqueremos calcular.Devoluciones:
Objeto | indefinido -Siempre devuelve un objeto simple - o
indefinidosi 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 elElemento Elemento sobre el que colocar la posición del puntero.
eventoObjeto 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 elementoElemento Elemento a comprobar
Clase a comprobarcuerda Nombre de clase para comprobar
Lanzamientos:
-
Se produce un error si
ClassToChecktiene espacios en blanco. - Tipo
- Error
Devoluciones:
booleano -Estarán
ciertosi el elemento tiene una clase,falsode 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 elElemento Elemento en el que insertar contenido normalizado.
contenidoMó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 valormixto El valor a comprobar.
Devoluciones:
booleano -Estarán
ciertosi el valor es un elemento DOM,falsode lo contrario. -
isInFrame estático () → {booleano}
-
Determina si el DOM actual está incrustado en un iframe.
Devoluciones:
booleano -Estarán
ciertosi el DOM está incrustado en un iframe,falsode lo contrario. -
isReal estático () → {booleano}
-
Si la interfaz DOM actual parece ser real (es decir, no simulada).
Devoluciones:
booleano -Estarán
ciertosi el DOM parece ser real,falsode lo contrario. -
estático isSingleLeftClick (evento) → {booleano}
-
Compruebe si un evento fue un solo clic izquierdo.
Parámetros:
Nombre Tipo Descripción eventoObjeto del evento~Evento Objeto de evento.
Devoluciones:
booleano -Estarán
ciertosi un solo clic izquierdo,falsode 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 valormixto Compruebe si este valor es un nodo de texto.
Devoluciones:
booleano -Estarán
ciertosi el valor es un nodo de texto,falsode 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 contenidoMó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ñoElemento Elemento para insertar
padreElemento Elemento en el que insertar hijo
-
estático removeAttribute(el, atributo)
-
Elimina el atributo de un elemento.
Parámetros:
Nombre Tipo Descripción elElemento Un elemento DOM.
atributocuerda Atributo para eliminar.
-
removeClass estático (elemento, classToRemove) → {Elemento}
-
Elimina el nombre de una clase de un elemento.
Parámetros:
Nombre Tipo Descripción elementoElemento 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 elElemento Un elemento DOM.
atributocuerda Atributo para configurar.
valorcuerda 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 elElemento Elemento al que añadir atributos.
atributosObjeto <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 elElemento Elemento al que agregar contenido de texto
textocuerda 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 elementoElemento Elemento en el que cambiar el nombre de una clase.
Clase para alternarcuerda La clase que debería alternarse.
predicadobooleano | 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 cuerdaEl valor se normalizará en un nodo de texto. ElementoEl valor se aceptará tal cual. TextNode El valor se aceptará tal cual. MatrizMatriz 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ónUna 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 Xnú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 izquierdanúmero Pixeles a la izquierda.
cimanú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 elementoElemento El elemento DOM del componente.
Clase para alternarcuerda los
nombre de la claseque quiere ser activadoDevoluciones:
boolean | undefined -Si
ciertose devuelve, elclassToTogglese agregará a laelemento. Sifalso, losclassToToggleserá eliminado de laelemento. Siindefinido, la devolución de llamada será ignorada.