HOWTO · jQuery

jQueryでデータ属性を持つ要素を見つける方法

jQueryの.find()、.filter()、またはCSS属性セレクターを使用してデータ属性を持つ要素を選択します。子孫と要素自体を区別する例付きです。

このページの内容

HTML要素を data-* 属性で選択するには、jQueryの .find() または .filter() でCSS属性セレクターを使用するか、セレクターをjQueryに直接渡します。対象が現在の選択範囲の下にあるか、選択された要素自体であるかに応じて選択してください。

jQueryの .find() メソッドを使用してデータ属性を検索する

jQueryの .find() メソッドは、現在のjQueryコレクション内の要素の子孫を検索します。たとえば、$("ul").find("[data-name='Edison']") は、リスト内にある data-name="Edison" を持つリスト項目を選択します。.css("font-size", "3em") のようなアクションをチェーンして、一致した項目のフォントサイズを変更できます。

このメソッドは ul 自体をテストしません。その下にある要素を検索します。属性の値に一致するセレクターを使用し、返された要素にアクションを適用してください。セレクターが要素を返さない場合は、属性のスペルを確認し、対象が選択された ul の下にネストされていることを確認してください。

CSS属性セレクターを使用してデータ属性を検索する

CSS属性セレクターは [attribute="value"] という形式です。リスト内にある data-iso="MRT" を持つリスト項目を選択するには、$("ul [data-iso='MRT']") を使用します。ul と角括弧の間のスペースは「ulの一致する子孫」を意味します。選択される要素はMauritaniaのリスト項目であるため、.css("color", "magenta") のようなチェーンされた呼び出しでその項目にスタイルを適用します。

属性が ul 自体に属する場合は、スペースのない複合セレクターを使用します:$("ul[data-viruses='computer-viruses']")。そのセレクターはリスト自体に一致します。スペースを追加すると、代わりにその属性を持つ子孫を求めることになります。data-iso と MRT をマークアップ内の属性名と値に置き換え、値の周りの角括弧と引用符は保持してください。セレクターは、書かれたとおりの属性値を比較します。要素のテキストや別のJavaScriptプロパティを検索するものではありません。HTMLに存在する正確な値を使用してください。

この小さなJavaScriptデータモデルは、セレクターの例と同じ国名と属性値を使用しています。どの項目が data-iso の値に一致するかを示します。

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

このデータモデルは値の比較を説明するものであり、ブラウザやjQueryを実行するものではありません。上記のjQueryセレクターパターンは、ブラウザ側の構文例です。

.filter() メソッドを使用してデータ属性を検索する

jQueryの .filter() を使用して、既存のコレクションをセレクターに一致する要素に絞り込みます。たとえば、$("li").filter('[data-esolang="Chef"]') は、現在のリスト項目の集合からChefのリスト項目を選択します。.addClass("style-chef") をチェーンして、その一致にクラスを追加します。

違いは開始コレクションにあります。.find() はその要素の下を検索し、.filter() はすでにコレクション内にある要素をチェックします。子孫である可能性も親自体である可能性もある対象については、マークアップ内で data-* 属性がどこに現れるかを確認し、それに応じてセレクターを選択してください。