dom.js
Membres
-
statique , constant $
-
Recherche un
sélecteur de correspondance d'élément DOM unique
dans lecontexte facultatif
d'un autre élément DOM (document par défaut
). -
statique , constant $$
-
Recherche un
sélecteur correspondant à tous les éléments DOM
dans lecontexte facultatif
d'un autre élément DOM (document par défaut
).
Méthodes
-
statique addClass(element, classToAdd) → {Element}
-
Ajoutez un nom de classe à un élément.
Paramètres :
Prénom Type Description élément
Element Élément auquel ajouter un nom de classe.
Classe à ajouter
chaîne Nom de classe à ajouter.
Retours :
Élément -L'élément DOM avec le nom de classe ajouté.
-
statique appendContent(el, content) → {Element}
-
Normalise et ajoute du contenu à un élément.
Paramètres :
Prénom Type Description el
Element Élément auquel ajouter du contenu normalisé.
contenu
Module : DOM ~ Content Descriptor Une valeur de descripteur de contenu.
Retours :
Élément -L'élément dont le contenu normalisé est ajouté.
-
statique blockTextSelection()
-
Essayez de bloquer la possibilité de sélectionner du texte.
-
statique createEl(tagNameopt, propertiesopt, attributesopt, content) → {Element}
-
Crée un élément et applique des propriétés, des attributs et insère du contenu.
Paramètres :
Prénom Type Attributs Défaut Description Nom du tag
chaîne <facultatif>
« Plonge » Nom de la balise à créer.
propriétés
Objet <facultatif>
{} Propriétés des éléments à appliquer.
attributs
Objet <facultatif>
{} Attributs d'élément à appliquer.
contenu
Module : DOM ~ Content Descriptor Un objet descripteur de contenu.
Retours :
Élément -L'élément qui a été créé.
-
statique emptyEl(el) → {Element}
-
Vide le contenu d'un élément.
Paramètres :
Prénom Type Description el
Element L'élément dans lequel vider les enfants
Retours :
Élément -L'élément sans enfants
-
statique findPosition(el) → {module:dom~Position}
-
Obtenir la position d'un élément dans le DOM.
Les usages
getBoundingClientRect
technique de John Resig.Paramètres :
Prénom Type Description el
Element Élément à partir duquel obtenir le décalage.
-
statique getAttribute(el, attribute) → {string}
-
Récupère la valeur de l'attribut d'un élément.
Paramètres :
Prénom Type Description el
Element Un élément DOM.
attribut
chaîne Attribut pour obtenir la valeur de.
Retours :
corde -la valeur de l'attribut.
-
statique getAttributes(tag) → {Objet}
-
Obtenez les valeurs d'attribut d'un élément, telles que définies sur la balise HTML.
Les attributs ne sont pas les mêmes que les propriétés. Ils sont définis sur la balise ou avec setAttribute.
Paramètres :
Prénom Type Description étiquette
Element Élément à partir duquel obtenir les attributs de balise.
Retours :
Objet -Tous les attributs de l'élément. Les attributs booléens seront
vrai
oufaux
, d'autres seront des chaînes. -
statique getBoundingClientRect(el) → {Objet|non défini}
-
Identique à l'indigène
getBoundingClientRect
fonction, mais s'assure que la méthode est prise en charge (c'est dans tous les navigateurs que nous prétendons prendre en charge) et que l'élément est dans le DOM avant de continuer.Cette fonction wrapper cale également les propriétés qui ne sont pas fournies par certains navigateurs plus anciens (à savoir, IE8).
De plus, certains navigateurs ne prennent pas en charge l'ajout de propriétés à un
ClientRect
/DOMRect
objet; donc, nous le copions superficiellement avec les propriétés standard (saufX
etoui
qui ne sont pas largement pris en charge). Cela permet d'éviter les implémentations où les clés ne sont pas énumérables.Paramètres :
Prénom Type Description el
Element Élément dont
ClientRect
on veut calculer.Retours :
Objet | non défini -Renvoie toujours un objet simple - ou
indéfini
s'il ne le peut pas. -
statique getPointerPosition(el, event) → {module:dom~Coordinates}
-
Récupère la position du pointeur dans un élément.
La base des coordonnées se trouve en bas à gauche de l'élément.
Paramètres :
Prénom Type Description el
Element Élément sur lequel obtenir la position du pointeur.
événement
Cible de l'événement ~ événement Objet événement.
Retours :
module:dom~Coordonnées -Un objet de coordonnées correspondant à la position de la souris.
-
statique hasClass(element, classToCheck) → {boolean}
-
Vérifiez si un élément a un nom de classe.
Paramètres :
Prénom Type Description élément
Element Élément à vérifier
Cours à vérifier
chaîne Nom de classe à vérifier
Lancers :
-
Émet une erreur si
ClassToCheck
dispose d'espaces blancs. - Type
- Erreur
Retours :
booléen -Sera
vrai
si l'élément a une classe,faux
autrement. -
-
statique insertContent(el, content) → {Element}
-
Normalise et insère du contenu dans un élément, ce qui est identique à
appendContent ()
, sauf qu'il vide l'élément en premier.Paramètres :
Prénom Type Description el
Element Élément dans lequel insérer du contenu normalisé.
contenu
Module : DOM ~ Content Descriptor Une valeur de descripteur de contenu.
Retours :
Élément -Élément dont le contenu normalisé est inséré.
-
statique isEl(valeur) → {booléen}
-
Détermine, via la frappe de canard, si une valeur est un élément DOM ou non.
Paramètres :
Prénom Type Description valeur
Mixte La valeur à vérifier.
Retours :
booléen -Sera
vrai
si la valeur est un élément DOM,faux
autrement. -
statique isInFrame() → {boolean}
-
Détermine si le DOM actuel est intégré dans un iframe.
Retours :
booléen -Sera
vrai
si le DOM est embarqué dans un iframe,faux
autrement. -
statique isReal() → {boolean}
-
Si l'interface DOM actuelle semble être réelle (c'est-à-dire non simulée).
Retours :
booléen -Sera
vrai
si le DOM semble réel,faux
autrement. -
statique isSingleLeftClick(event) → {boolean}
-
Vérifiez si un événement était un simple clic gauche.
Paramètres :
Prénom Type Description événement
Cible de l'événement ~ événement Objet événement.
Retours :
booléen -Sera
vrai
si un seul clic gauche,faux
autrement. -
statique isTextNode(value) → {boolean}
-
Détermine, en tapant un canard, si une valeur est un nœud de texte ou non.
Paramètres :
Prénom Type Description valeur
Mixte Vérifiez si cette valeur est un nœud de texte.
Retours :
booléen -Sera
vrai
si la valeur est un nœud de texte,faux
autrement. -
statique normalizeContent(content) → {Array}
-
Normalise le contenu pour une éventuelle insertion dans le DOM.
Cela permet un large éventail de méthodes de définition de contenu, mais aide à éviter de tomber dans le piège de simplement écrire sur
interneHTML
, ce qui pourrait être un problème XSS.Le contenu d'un élément peut être transmis en plusieurs types et combinaisons, dont le comportement est le suivant :
Paramètres :
Prénom Type Description contenu
Module : DOM ~ Content Descriptor Une valeur de descripteur de contenu.
Retours :
Array -Tout le contenu qui a été transmis, normalisé à un tableau d'éléments ou de nœuds de texte.
-
statique ajouter à(enfant, parent)
-
Insérer un élément en tant que premier nœud enfant d'un autre
Paramètres :
Prénom Type Description enfant
Element Élément à insérer
parent
Element Élément dans lequel insérer un enfant
-
statique removeAttribute(el, attribut)
-
Supprimer l'attribut d'un élément.
Paramètres :
Prénom Type Description el
Element Un élément DOM.
attribut
chaîne Attribut à supprimer.
-
statique removeClass(élément, classToRemove) → {Element}
-
Supprimer un nom de classe d'un élément.
Paramètres :
Prénom Type Description élément
Element Elément dont vous pouvez supprimer un nom de classe.
Classe à supprimer
chaîne Nom de classe à supprimer
Retours :
Élément -L'élément DOM avec le nom de classe supprimé.
-
statique setAttribute(el, attribut, valeur)
-
Définit la valeur d'un attribut d'élément.
Paramètres :
Prénom Type Description el
Element Un élément DOM.
attribut
chaîne Attribut à définir.
valeur
chaîne Valeur sur laquelle définir l'attribut.
-
statique setAttributes(el, attributsopter)
-
Appliquez des attributs à un élément HTML.
Paramètres :
Prénom Type Attributs Description el
Element Élément auquel ajouter des attributs.
attributs
Objet <facultatif>
Attributs à appliquer.
-
statique textContent(el, text) → {Element}
-
Injecte du texte dans un élément, en remplaçant entièrement tout contenu existant.
Paramètres :
Prénom Type Description el
Element L'élément dans lequel ajouter du contenu texte
texte
chaîne Le contenu texte à ajouter.
Retours :
Élément -Élément avec du contenu textuel ajouté.
-
statique toggleClass(element, classToToggle, predicateopt) → {Element}
-
Ajoute ou supprime un nom de classe à/d'un élément en fonction d'une condition facultative ou de la présence/absence du nom de classe.
Paramètres :
Prénom Type Attributs Description élément
Element L'élément sur lequel activer un nom de classe.
Classe à bascule
chaîne La classe qui doit être basculée.
prédicat
booléen | module : dom~Rappel de prédicat <facultatif>
Voir la valeur de retour pour module : dom~Rappel de prédicat
Retours :
Élément -Élément dont la classe a été basculée.
-
statique unblockTextSelection()
-
Désactivez le blocage de la sélection de texte.
Définitions de types
-
Descripteur de contenu()
-
Il s'agit d'une valeur mixte qui décrit le contenu à injecter dans le DOM via une méthode. Il peut être des types suivants :
Type Description chaîne
La valeur sera normalisée dans un nœud de texte. Element
La valeur sera acceptée telle quelle. TextNode La valeur sera acceptée telle quelle. baie
Tableau unidimensionnel de chaînes, d'éléments, de nœuds de texte ou de fonctions. Ces fonctions doivent renvoyer une chaîne, un élément ou un nœud de texte (toute autre valeur de retour, comme un tableau, sera ignorée). Fonction
Une fonction qui devrait renvoyer une chaîne, un élément, un nœud de texte ou un tableau - n'importe laquelle des autres valeurs possibles décrites ci-dessus. Cela signifie qu'un descripteur de contenu peut être une fonction qui renvoie un tableau de fonctions, mais ces fonctions de second niveau doivent renvoyer des chaînes, des éléments ou des nœuds de texte. -
Coordonnées
-
Représente les coordonnées x et y pour un élément DOM ou un pointeur de souris.
Propriétés :
Prénom Type Description X
numéro coordonnée x en pixels
oui
numéro coordonnée y en pixels
-
Poste
-
Représente la position d'un élément DOM sur la page.
Propriétés :
Prénom Type Description la gauche
numéro Pixels à gauche.
Haut
numéro Pixels du haut.
-
PredicateCallback(element, classToToggle) → {boolean|undefined}
-
La définition de rappel pour toggleClass.
Paramètres :
Prénom Type Description élément
Element L'élément DOM du composant.
Classe à bascule
chaîne Les
nom du cours
qui veut être basculéRetours :
booléen | indéfini -Si
vrai
est retourné, leclasseVersBasculer
sera ajouté à laélément
. Sifaux
, lesclasseVersBasculer
sera retiré de laélément
. Siindéfini
, le rappel sera ignoré.