prop() 函式用於設定或回傳目前 jQuery 物件所匹配元素的屬性值。它屬於 jQuery 物件(實例)的方法,自 jQuery 1.6 起新增。若需要刪除 DOM 元素的屬性,則應改用 removeProp()。
用法一:
jQueryObject.prop( propertyName [, value ] )
用來設定或回傳指定屬性 propertyName 的值。若提供了 value 參數,即表示設定該屬性;若未提供,則表示回傳該屬性的值。
值得注意的是,value 也可以是函式。prop() 會針對所有匹配元素逐一執行該函式,函式中的 this 指向對應的 DOM 元素,並會傳入兩個參數:第一個是該元素在匹配集合中的索引,第二個是該屬性目前的值,函式的回傳值即為設定給該元素的新值。
用法二:
jQueryObject.prop( object )
以物件形式一次設定多個屬性,物件中每個鍵對應 propertyName,鍵值則對應 value。
特別提醒:所有「設定屬性」的操作都會作用於目前 jQuery 物件匹配的每一個元素;而所有「讀取屬性」的操作只針對第一個匹配元素。
propertyName(String 類型)指定的屬性名稱。
value(可選,Object/Function 類型)指定的屬性值,或回傳屬性值的函式。
object(Object 類型)封裝多組鍵值對,用於一次設定多項屬性。value 可以是包含物件與陣列在內的任意類型。
prop() 的回傳值型別取決於執行的是「設定」還是「讀取」操作。若是設定操作,回傳目前 jQuery 物件本身;若是讀取操作,則回傳讀取到的屬性值。若匹配多個元素,讀取時只以第一個元素為準;若該元素沒有指定屬性,則回傳 undefined。
prop() 和 attr() 的主要差別在於:prop() 針對的是 DOM 元素(JS Element 物件)本身的屬性,而 attr() 針對的是該 DOM 元素所對應文件節點的屬性。
1、若透過 prop() 更改 <input> 和 <button> 元素的 type 屬性,在多數瀏覽器上會拋出錯誤,因為該屬性一般不允许在後期更改。
2、若使用 prop() 操作表單元素的 checked、selected、disabled 等屬性,元素被選中(或禁用)時回傳 true,否則回傳 false。
3、prop() 也能設定或回傳 DOM 元素上的某些屬性,例如 tagName、selectedIndex、nodeName、nodeType、ownerDocument、defaultChecked、defaultSelected 等。
4、在 IE9 及更早版本中,若透過 prop() 設定的屬性值並非簡單的原始值(String、Number、Boolean),且在對應 DOM 元素被銷毀前該屬性未被移除,可能導致記憶體洩漏。若只是為了儲存資料,建議改用 data() 函式以避免此問題。
以下面這段 HTML 為例:
<div id="n1">
<p id="n2" class="demo test" data-key="UUID" data_value="1235456465">CodePlayer</p>
<input id="n3" name="order_id" type="checkbox" value="1">
<input id="n4" name="order_id" type="checkbox" checked="checked" value="2">
</div>
我們編寫如下 jQuery 程式碼:
var $n2 = $("#n2");
// prop()操作針對的是元素(Element對象)的屬性,而不是元素節點(HTML文檔)的屬性
document.writeln( $n2.prop("data-key") ); // undefined
document.writeln( $n2.prop("data_value") ); // undefined
document.writeln( $n2.prop("id") ); // n2
document.writeln( $n2.prop("tagName") ); // P
document.writeln( $n2.prop("className") ); // demo test
document.writeln( $n2.prop("innerHTML") ); // CodePlayer
document.writeln( typeof $n2.prop("getAttribute") ); // function
// prop()設置的屬性也是針對元素(Element對象),因此也可以通過元素本身直接訪問
$n2.prop("prop_a", "CodePlayer");
document.writeln( $n2[0].prop_a ); // CodePlayer
var n2 = document.getElementById("n2");
document.writeln( n2.prop_a ); // CodePlayer
// 以對象形式同時設置多個屬性,屬性值可以是對象、數組等任意類型
$n2.prop( { prop_b: "baike", prop_c: 18, site: { name: "CodePlayer", url: "https://www.jb51.net/" } } );
document.writeln( $n2[0].prop_c ); // 18
document.writeln( $n2[0].site.url ); // https://www.jb51.net/
// 反選所有的復選框(沒選中的改為選中,選中的改為取消選中)
$("input:checkbox").prop("checked", function(index, oldValue){
return !oldValue;
});
以上就是本文的全部內容,希望大家能夠喜歡。