dom.js
Mitglieder
-
statisch , Konstante $
-
Findet einen einzelnen
DOM-Element-Abstimmungsselektorim optionalenKontexteines anderen DOM-Elements (standardmäßig aufDokument). -
statisch , Konstante $$
-
Findet einen
Selektorfür alle DOM-Elemente im optionalenKontexteines anderen DOM-Elements (standardmäßig aufDokument).
Methoden
-
statisch addClass(Element, classToAdd) → {Element}
-
Fügen Sie einem Element einen Klassennamen hinzu.
Parameter:
Nennen Typ Beschreibung ElementElement Element, dem der Klassennamen hinzugefügt werden soll.
ClassToAddString Der hinzuzufügende Klassenname.
Gibt zurück:
Element -Das DOM-Element mit dem hinzugefügten Klassennamen.
-
statischer AppendContent(el, Inhalt) → {Element}
-
Normalisiert und hängt Inhalt an ein Element an.
Parameter:
Nennen Typ Beschreibung elElement Element, an das normalisierten Inhalt angehängt werden soll.
InhaltModul:DOM~contentDescriptor Ein Wert für Inhaltsdeskriptor.
Gibt zurück:
Element -Das Element mit angehängtem normalisiertem Inhalt.
-
statisch blockTextSelection()
-
Versuchen Sie, die Textauswahl zu blockieren.
-
statisch creaTeel(TagNameopt, Eigenschaftenopt, Attributeopt, Inhalt) → {Element}
-
Erstellt ein Element und wendet Eigenschaften und Attribute an und fügt Inhalte ein.
Parameter:
Nennen Typ Attribute Standardwert Beschreibung tagNameString <optional>
'tauch' Name des zu erstellenden Tags.
immobilienObjekt <optional>
{} Anzuwendende Elementeigenschaften.
AttributeObjekt <optional>
{} Anzuwendende Elementattribute.
InhaltModul:DOM~contentDescriptor Ein Inhaltsdeskriptorobjekt.
Gibt zurück:
Element -Das Element, das erstellt wurde.
-
statisch emptyEl(el) → {Element}
-
Leert den Inhalt eines Elements.
Parameter:
Nennen Typ Beschreibung elElement Das Element zum Leeren von Kindern
Gibt zurück:
Element -Das Element ohne Kinder
-
statische FindPosition(el) → {module:dom~Position}
-
Rufen Sie die Position eines Elements im DOM ab.
Verwendet
getBoundingClientRectTechnik von John Resig.Parameter:
Nennen Typ Beschreibung elElement Element, von dem der Offset abgerufen werden soll.
-
statisches getAttribute(el, Attribut) → {string}
-
Rufen Sie den Wert des Attributs eines Elements ab.
Parameter:
Nennen Typ Beschreibung elElement Ein DOM-Element.
AttributString Attribut, um den Wert zu erhalten.
Gibt zurück:
string -Der Wert des Attributs.
-
statisches getAttributes(Tag) → {Objekt}
-
Rufen Sie die Attributwerte eines Elements ab, wie im HTML-Tag definiert.
Attribute sind nicht dasselbe wie Eigenschaften. Sie werden im Tag oder mit setAttribute definiert.
Parameter:
Nennen Typ Beschreibung EtikettElement Element, von dem Tag-Attribute abzurufen sind.
Gibt zurück:
Objekt -Alle Attribute des Elements. Boolesche Attribute sind
wahroderfalsch, andere werden Strings sein. -
static getBoundingClientRect(el) → {object|undefiniert}
-
Identisch mit den Einheimischen
getBoundingClientRectFunktion, sondern stellt sicher, dass die Methode überhaupt unterstützt wird (es ist in allen Browsern die wir behaupten zu unterstützen) und dass sich das Element im DOM befindet, bevor Sie fortfahren.Diese Wrapper-Funktion verschiebt auch Eigenschaften, die von einigen älteren Browsern (namentlich IE8) nicht bereitgestellt werden.
Darüber hinaus unterstützen einige Browser das Hinzufügen von Eigenschaften zu a . nicht
ClientRect/DOMRectObjekt; Also kopieren wir es flach mit den Standardeigenschaften (außerxundjadie nicht weit verbreitet sind). Dies hilft, Implementierungen zu vermeiden, bei denen Schlüssel nicht aufzählbar sind.Parameter:
Nennen Typ Beschreibung elElement Element, dessen
ClientRectwir wollen rechnen.Gibt zurück:
Objekt | unbestimmtes -Gibt immer ein einfaches Objekt zurück - oder
nicht definiertwenn es nicht kann. -
static getPointerPosition(el, event) → {module:DOM~Coordinates}
-
Rufen Sie die Zeigerposition innerhalb eines Elements ab.
Die Basis auf den Koordinaten ist unten links vom Element.
Parameter:
Nennen Typ Beschreibung elElement Element, für das die Zeigerposition abgerufen werden soll.
EreigniseventTarget~Event Event-Objekt.
-
statisch hasClass(element, classToCheck) → {boolean}
-
Prüfen Sie, ob ein Element einen Klassennamen hat.
Parameter:
Nennen Typ Beschreibung ElementElement Zu überprügendes Element
ClasstoCheckString Klassenname, auf den geprüft werden soll
Wirft:
-
Löst einen Fehler aus, wenn
ClassToCheck Leerzeichenhat. - Typ
- Fehler
Gibt zurück:
boolescher Wert -Wird sein
wahrWenn das Element eine Klasse hat,falschAndernfalls. -
-
statischer InsertContent(el, Inhalt) → {Element}
-
Normalisiert und fügt Inhalt in ein Element ein; dies ist identisch mit
appendContent (), außer dass es das Element zuerst leert.Parameter:
Nennen Typ Beschreibung elElement Element, in das normalisierten Inhalt eingefügt werden soll.
InhaltModul:DOM~contentDescriptor Ein Wert für Inhaltsdeskriptor.
Gibt zurück:
Element -Das Element mit eingefügtem normalisiertem Inhalt.
-
statischer ISel(Wert) → {boolean}
-
Bestimmt durch Enteneingabe, ob ein Wert ein DOM-Element ist oder nicht.
Parameter:
Nennen Typ Beschreibung WertGemischt Der zu überprüfende Wert.
Gibt zurück:
boolescher Wert -Wird sein
wahrwenn der Wert ein DOM-Element ist,falschAndernfalls. -
statischer isFrame() → {boolean}
-
Bestimmt, ob das aktuelle DOM in einen iframe eingebettet ist.
Gibt zurück:
boolescher Wert -Wird sein
wahrwenn das DOM in einen iframe eingebettet ist,falschAndernfalls. -
statisch isReal() → {boolean}
-
Ob die aktuelle DOM-Schnittstelle real erscheint (dh nicht simuliert).
Gibt zurück:
boolescher Wert -Wird sein
wahrwenn das DOM echt zu sein scheint,falschAndernfalls. -
static isSingleLeftClick(Ereignis) → {boolean}
-
Überprüfen Sie, ob ein Ereignis ein einzelner Linksklick war.
Parameter:
Nennen Typ Beschreibung EreigniseventTarget~Event Event-Objekt.
Gibt zurück:
boolescher Wert -Wird sein
wahrwenn ein einzelner Linksklick,falschAndernfalls. -
statischer isTextNode(Wert) → {boolean}
-
Bestimmt durch Duck-Typisierung, ob ein Wert ein Textknoten ist oder nicht.
Parameter:
Nennen Typ Beschreibung WertGemischt Prüfen Sie, ob dieser Wert ein Textknoten ist.
Gibt zurück:
boolescher Wert -Wird sein
wahrwenn der Wert ein Textknoten ist,falschAndernfalls. -
statischer normalizeContent(Inhalt) → {Array}
-
Normalisiert den Inhalt für das eventuelle Einfügen in das DOM.
Dies ermöglicht eine breite Palette von Methoden zur Inhaltsdefinition, schützt jedoch davor, in die Falle zu tappen, einfach an . zu schreiben
innerHTML, was ein XSS-Problem sein könnte.Der Inhalt eines Elements kann in mehreren Typen und Kombinationen übergeben werden, deren Verhalten wie folgt lautet:
Parameter:
Nennen Typ Beschreibung InhaltModul:DOM~contentDescriptor Ein Wert für Inhaltsdeskriptor.
Gibt zurück:
Array -Der gesamte übergebene Inhalt, normalisiert auf ein Array von Elementen oder Textknoten.
-
statisch prependTo(Kind, Elternteil)
-
Fügen Sie ein Element als ersten untergeordneten Knoten eines anderen
Parameter:
Nennen Typ Beschreibung KindElement Einzufügendes Element
ElternteilElement Element, in das Kind eingefügt werden soll
-
statisch Attribut entfernen(el, Attribut)
-
Entfernen Sie das Attribut eines Elements.
Parameter:
Nennen Typ Beschreibung elElement Ein DOM-Element.
AttributString Zu entfernendes Attribut.
-
static removeClass(element, classToRemove) → {Element}
-
Entfernen Sie einen Klassennamen aus einem Element.
Parameter:
Nennen Typ Beschreibung ElementElement Element, aus dem ein Klassennamen entfernt werden soll.
ClassToRemoveString Zu entfernende Klassenname
Gibt zurück:
Element -Das DOM-Element mit entferntem Klassennamen.
-
statisch setAttribute(el, Attribut, Wert)
-
Legen Sie den Wert des Attributs eines Elements fest.
Parameter:
Nennen Typ Beschreibung elElement Ein DOM-Element.
AttributString Zu setzendes Attribut.
WertString Wert, auf den das Attribut festgelegt werden soll.
-
statisch setAttribute(el, Attributeopt)
-
Wenden Sie Attribute auf ein HTML-Element an.
Parameter:
Nennen Typ Attribute Beschreibung elElement Element, dem Attribute hinzugefügt werden sollen.
AttributeObjekt <optional>
Zu anwendende Attribute.
-
statischer TextContent(el, Text) → {Element}
-
Injiziert Text in ein Element und ersetzt alle vorhandenen Inhalte vollständig.
Parameter:
Nennen Typ Beschreibung elElement Das Element, in das Textinhalt hinzugefügt werden soll
TextString Der hinzuzufügende Textinhalt.
Gibt zurück:
Element -Das Element mit hinzugefügtem Textinhalt.
-
static toggleClass(element, classToToggle, Prädikatopt) → {Element}
-
Fügt einem Element je nach einer optionalen Bedingung oder dem Vorhandensein/Fehlen des Klassennamens einen Klassennamen hinzu oder entfernt ihn.
Parameter:
Nennen Typ Attribute Beschreibung ElementElement Das Element, für das ein Klassennamen umschalten soll.
ClassToggleString Die Klasse, die umgeschaltet werden soll.
Prädikatboolesch | module:dom~PredicateCallback <optional>
Siehe Rückgabewert für module:dom~PredicateCallback
Gibt zurück:
Element -Das Element mit einer Klasse, die umgeschaltet wurde.
-
statisch unblockTextSelection()
-
Deaktivieren Sie die Blockierung der Textauswahl.
Geben Sie Definitionen ein
-
Inhaltsbeschreibung()
-
Dies ist ein gemischter Wert, der den Inhalt beschreibt, der über eine Methode in das DOM eingefügt werden soll. Es kann von den folgenden Typen sein:
Typ Beschreibung StringDer Wert wird in einen Textknoten normalisiert. ElementDer Wert wird unverändert akzeptiert. TextNode Der Wert wird unverändert akzeptiert. ReiheEin eindimensionales Array von Zeichenfolgen, Elementen, Textknoten oder Funktionen. Diese Funktionen sollten einen String, ein Element oder einen Textknoten zurückgeben (jeder andere Rückgabewert, wie ein Array, wird ignoriert). FunktionEine Funktion, von der erwartet wird, dass sie einen String, ein Element, einen Textknoten oder ein Array zurückgibt – einen der anderen oben beschriebenen möglichen Werte. Dies bedeutet, dass ein Inhaltsdeskriptor eine Funktion sein kann, die ein Array von Funktionen zurückgibt, diese Funktionen der zweiten Ebene jedoch Zeichenfolgen, Elemente oder Textknoten zurückgeben müssen. -
Koordinaten
-
Stellt x- und y-Koordinaten für ein DOM-Element oder einen Mauszeiger dar.
Eigenschaften:
Nennen Typ Beschreibung x Zahl x-Koordinate in Pixel
jaZahl y-Koordinate in Pixel
-
Position
-
Stellt die Position eines DOM-Elements auf der Seite dar.
Eigenschaften:
Nennen Typ Beschreibung linksZahl Pixel nach links.
obenZahl Pixel von oben.
-
PredicateCallback(Element, classToToggle) → {boolesch | undefiniert}
-
Die Callback-Definition für toggleClass.
Parameter:
Nennen Typ Beschreibung ElementElement Das DOM-Element der Komponente.
ClassToggleString Die
Klassennamedas will umgeschaltet werdenGibt zurück:
boolean | undefined -Wenn
wahrzurückgegeben wird, dieclassToTogglewird hinzugefügtElement. Wennfalsch, dasclassToTogglewird aus der entferntElement. Wennnicht definiert, wird der Rückruf ignoriert.