jQuery.is() 函數(shù)

2018-11-23 16:52 更新

jQuery.is() 函數(shù)

jQuery 選擇器 jQuery 選擇器


定義和用法

is()函數(shù)用于判斷當(dāng)前jQuery對象所匹配的元素是否符合指定的表達(dá)式。只要其中有至少一個元素符合該表達(dá)式就返回true,否則返回false

這里的表達(dá)式包括:選擇器(字符串)、DOM元素(Element)、jQuery對象、函數(shù)。

該函數(shù)屬于jQuery對象(實例)。


語法

jQueryObject.is( expr )

參數(shù)

參數(shù)描述
exprString/Element/jQuery/Function類型指定的表達(dá)式。

is()函數(shù)實際上是判斷當(dāng)前jQuery對象所匹配的元素與指定表達(dá)式expr所表示的元素是否存在交集,如果存在交集就返回true,否則返回false

如果expr參數(shù)為字符串,則將其視作jQuery選擇器,用以表示該選擇器所匹配的元素。

jQuery 1.6 新增支持:參數(shù)expr可以為DOM元素(Element)、jQuery對象函數(shù)。

如果expr參數(shù)為函數(shù),is()函數(shù)將根據(jù)匹配的所有元素遍歷執(zhí)行該函數(shù),函數(shù)中的this將指向當(dāng)前迭代的元素。is()還會為函數(shù)傳入一個參數(shù):即該元素在匹配元素中的索引。

函數(shù)expr的返回值應(yīng)該為true或者false。該函數(shù)的返回值將決定is()的返回值。循環(huán)執(zhí)行時,只要該函數(shù)的返回值有一次為trueis()函數(shù)就立即返回true,否則返回false。


返回值

is()函數(shù)的返回值為Boolean類型,以指示當(dāng)前jQuery對象所匹配的元素與參數(shù)expr所表示的元素是否存在交集,如果存在交集,則返回true,否則返回false


實例

實例

以下面這段代碼為例:

/* HTML代碼 */
<div id="n1">
    <div id="n2">
        <ul id="n3" data_id="12">
            <li id="n4">item1</li>
            <li id="n5" class="foo bar">item2</li>
            <li id="n6" class="level-2">item3</li>
        </ul>
    </div>
    <div id="n7">
        <input id="n8" name="username" type="text" value="1">
        <input id="n9" name="orders" type="checkbox" checked="checked" value="1">
    </div>
</div>

/* jQuery代碼 */
<script>
//在當(dāng)前頁面內(nèi)追加換行標(biāo)簽和指定的HTML內(nèi)容
function w( html ){
$(document.body).append("<br/>" + html);
}

var $n3 = $("#n3");
w( $n3.is("ul") ); // true
w( $n3.is("[data_id]") ); // true

var $n5 = $("#n5");
w( $n5.is(".foo") ); // true
w( $n5.is("li") ); // true
w( $n5.is("ul li") ); // true
w( $n5.is("p li") ); // false

var n5 = document.getElementById("n5");
w( $n5.is(n5) ); // true

var $li = $("li");
w( $n5.is($li) ); // true
// 判斷l(xiāng)i元素是否含有類名"level-index",這里的index表示li元素的索引值(0、1、2……)
w( $li.is( function(index){
return $(this).hasClass("level-" + index);
} ) ); // true

var $input = $("input");
w( $input.is(":text") ); // true
w( $input.is(":checked") ); // true

var div = document.getElementsByTagName("div");
var $n7 = $("#n7");
w( $n7.is(div) ); // true
</script>

嘗試一下 ?

點擊 "嘗試一下" 按鈕查看在線實例


jQuery 選擇器 jQuery 選擇器

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號