dom.js
Membres
-
statique , constant $
-
Recherche un
sélecteur de correspondance d'élément DOM uniquedans lecontexte facultatifd'un autre élément DOM (document par défaut). -
statique , constant $$
-
Recherche un
sélecteur correspondant à tous les éléments DOMdans lecontexte facultatifd'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émentElement Élément auquel ajouter un nom de classe.
Classe à ajouterchaî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 elElement Élément auquel ajouter du contenu normalisé.
contenuModule : 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 tagchaîne <facultatif>
« Plonge » Nom de la balise à créer.
propriétésObjet <facultatif>
{} Propriétés des éléments à appliquer.
attributsObjet <facultatif>
{} Attributs d'élément à appliquer.
contenuModule : 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 elElement 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
getBoundingClientRecttechnique de John Resig.Paramètres :
Prénom Type Description elElement É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 elElement Un élément DOM.
attributchaî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 étiquetteElement Élément à partir duquel obtenir les attributs de balise.
Retours :
Objet -Tous les attributs de l'élément. Les attributs booléens seront
vraioufaux, d'autres seront des chaînes. -
statique getBoundingClientRect(el) → {Objet|non défini}
-
Identique à l'indigène
getBoundingClientRectfonction, 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/DOMRectobjet; donc, nous le copions superficiellement avec les propriétés standard (saufXetouiqui 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 elElement Élément dont
ClientRecton veut calculer.Retours :
Objet | non défini -Renvoie toujours un objet simple - ou
indéfinis'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 elElement Élément sur lequel obtenir la position du pointeur.
événementCible 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émentElement Élément à vérifier
Cours à vérifierchaîne Nom de classe à vérifier
Lancers :
-
Émet une erreur si
ClassToCheckdispose d'espaces blancs. - Type
- Erreur
Retours :
booléen -Sera
vraisi l'élément a une classe,fauxautrement. -
-
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 elElement Élément dans lequel insérer du contenu normalisé.
contenuModule : 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 valeurMixte La valeur à vérifier.
Retours :
booléen -Sera
vraisi la valeur est un élément DOM,fauxautrement. -
statique isInFrame() → {boolean}
-
Détermine si le DOM actuel est intégré dans un iframe.
Retours :
booléen -Sera
vraisi le DOM est embarqué dans un iframe,fauxautrement. -
statique isReal() → {boolean}
-
Si l'interface DOM actuelle semble être réelle (c'est-à-dire non simulée).
Retours :
booléen -Sera
vraisi le DOM semble réel,fauxautrement. -
statique isSingleLeftClick(event) → {boolean}
-
Vérifiez si un événement était un simple clic gauche.
Paramètres :
Prénom Type Description événementCible de l'événement ~ événement Objet événement.
Retours :
booléen -Sera
vraisi un seul clic gauche,fauxautrement. -
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 valeurMixte Vérifiez si cette valeur est un nœud de texte.
Retours :
booléen -Sera
vraisi la valeur est un nœud de texte,fauxautrement. -
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 contenuModule : 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 enfantElement Élément à insérer
parentElement É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 elElement Un élément DOM.
attributchaî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émentElement Elément dont vous pouvez supprimer un nom de classe.
Classe à supprimerchaî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 elElement Un élément DOM.
attributchaîne Attribut à définir.
valeurchaî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 elElement Élément auquel ajouter des attributs.
attributsObjet <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 elElement L'élément dans lequel ajouter du contenu texte
textechaî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émentElement L'élément sur lequel activer un nom de classe.
Classe à basculechaîne La classe qui doit être basculée.
prédicatboolé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îneLa valeur sera normalisée dans un nœud de texte. ElementLa valeur sera acceptée telle quelle. TextNode La valeur sera acceptée telle quelle. baieTableau 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). FonctionUne 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 Xnuméro coordonnée x en pixels
ouinumé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 gauchenuméro Pixels à gauche.
Hautnuméro Pixels du haut.
-
PredicateCallback(element, classToToggle) → {boolean|undefined}
-
La définition de rappel pour toggleClass.
Paramètres :
Prénom Type Description élémentElement L'élément DOM du composant.
Classe à basculechaîne Les
nom du coursqui veut être basculéRetours :
booléen | indéfini -Si
vraiest retourné, leclasseVersBasculersera ajouté à laélément. Sifaux, lesclasseVersBasculersera retiré de laélément. Siindéfini, le rappel sera ignoré.