dom

dom.js

Membres

statique , constant $

Recherche un sélecteur de correspondance d'élément DOM unique dans le contexte facultatif d'un autre élément DOM ( document par défaut).

statique , constant $$

Recherche un sélecteur correspondant à tous les éléments DOM dans le contexte 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.

Retours :
module:dom~Position -

Position de l'élément qui a été transmis.

Voir :

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 ou faux , 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 (sauf X et oui 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é, le classeVersBasculer sera ajouté à la élément. Si faux , les classeVersBasculer sera retiré de la élément. Si indéfini , le rappel sera ignoré.