HOWTO · jQuery

Wie man in jQuery ein Element mit Datenattribut findet

Wählen Sie Elemente mit Datenattributen mithilfe von jQuery .find(), .filter() oder CSS-Attributselektoren aus, mit Beispielen, die Nachkommen vom Element selbst unterscheiden.

Auf dieser Seite

Um ein HTML-Element anhand eines data-*-Attributs auszuwählen, verwenden Sie einen CSS-Attributselektor mit jQuerys .find() oder .filter() oder übergeben Sie den Selektor direkt an jQuery. Wählen Sie je nachdem, ob sich das Ziel unterhalb Ihrer aktuellen Auswahl befindet oder das ausgewählte Element selbst ist.

Ein Datenattribut mit der jQuery-Methode .find() finden

Die jQuery-Methode .find() durchsucht die Nachkommen der Elemente in der aktuellen jQuery-Sammlung. Beispielsweise wählt $("ul").find("[data-name='Edison']") das Listenelement mit data-name="Edison" innerhalb einer Liste aus. Sie können eine Aktion wie .css("font-size", "3em") verketten, um die Schriftgröße des übereinstimmenden Elements zu ändern.

Diese Methode prüft nicht das ul selbst; sie durchsucht Elemente darunter. Verwenden Sie einen Selektor, der mit dem Wert des Attributs übereinstimmt, und wenden Sie dann die Aktion auf das zurückgegebene Element an. Wenn der Selektor keine Elemente zurückgibt, überprüfen Sie die Schreibweise des Attributs und stellen Sie sicher, dass das Ziel unterhalb des ausgewählten ul verschachtelt ist.

Ein Datenattribut mit einem CSS-Attributselektor finden

Ein CSS-Attributselektor hat die Form [attribute="value"]. Um ein Listenelement mit data-iso="MRT" innerhalb einer Liste auszuwählen, verwenden Sie $("ul [data-iso='MRT']"). Das Leerzeichen zwischen ul und der Klammer bedeutet „ein übereinstimmender Nachkomme eines ul“. Das ausgewählte Element ist das Listenelement von Mauritania, sodass ein verketteter Aufruf wie .css("color", "magenta") dieses Element formatiert.

Wenn das Attribut zum ul selbst gehört, verwenden Sie einen zusammengesetzten Selektor ohne Leerzeichen: $("ul[data-viruses='computer-viruses']"). Dieser Selektor stimmt mit der Liste selbst überein; ein hinzugefügtes Leerzeichen würde stattdessen nach einem Nachkommen mit dem Attribut suchen. Ersetzen Sie data-iso und MRT durch den Attributnamen und -wert in Ihrem Markup und behalten Sie dabei die Klammern und Anführungszeichen um den Wert bei. Der Selektor vergleicht den Attributwert so, wie er geschrieben ist; er durchsucht weder den Text eines Elements noch eine separate JavaScript-Eigenschaft. Verwenden Sie den exakten Wert, der im HTML vorhanden ist.

Dieses kleine JavaScript-Datenmodell verwendet dieselben Ländernamen und Attributwerte wie das Selektorbeispiel. Es zeigt, welches Element mit dem Wert von data-iso übereinstimmt.

const countries = [
  { name: "Mauritania", "data-iso": "MRT" },
  { name: "Luxembourg", "data-iso": "LUX" },
  { name: "Croatia", "data-iso": "HRV" }
];

const match = countries.filter((country) => country["data-iso"] === "MRT")[0];
console.log(match.name);
Mauritania

Das Datenmodell veranschaulicht den Wertvergleich; es führt weder einen Browser noch jQuery aus. Die obigen jQuery-Selektormuster sind Syntaxbeispiele für die Browserseite.

Ein Datenattribut mit der Methode .filter() finden

Verwenden Sie jQuerys .filter(), um eine bestehende Sammlung auf Elemente einzugrenzen, die mit einem Selektor übereinstimmen. Beispielsweise wählt $("li").filter('[data-esolang="Chef"]') das Chef-Listenelement aus der aktuellen Menge von Listenelementen aus. Verketten Sie .addClass("style-chef"), um dieser Übereinstimmung eine Klasse hinzuzufügen.

Der Unterschied liegt in der Ausgangssammlung: .find() sucht unterhalb seiner Elemente, während .filter() die Elemente überprüft, die sich bereits in seiner Sammlung befinden. Prüfen Sie bei einem Ziel, das entweder ein Nachkomme oder das übergeordnete Element selbst sein kann, wo das data-*-Attribut im Markup erscheint, und wählen Sie den Selektor entsprechend.