التابع .removeProp() في jQuery
.removeProp( propertyName )
القيم المعادة
يعيد كائنًا من النوع jQuery.
الوصف
يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة.
.removeProp( propertyName )
أُضيف مع الإصدار: 1.6.
propertyName
سلسلة نصية تمثِّل اسم الخاصِّيَّة الكائنية المراد حذفها.
يحذف التابع .removeProp() الخاصِّيَّات التي ضُبطَت باستعمال التابع .prop().
قد تولِّد المتصفحات خطأً عند محاولة حذف بعض الخاصِّيَّات المضمَّنة لعنصر DOM أو الكائن window. تسند الخاصِّيَّة jQuery آنذاك القيمة undefined للخاصِّيَّة وتتجاهل أي خطأ ولَّده المتصفح. من المهم عمومًا حذف الخاصِّيَّات المخصصة التي ضبطت قيمتها لعنصر، وليس الخاصِّيَّات المضمنة (الأساسية).
ملاحظة: لا تستعمل هذا التابع لحذف الخاصِّيَّات الأساسية مثل الخاصِّيَّة checked، أو disabled، أو selected. هذا سيؤدي إلى حذف الخاصِّيَّة نهائيًا، ولا يمكن إعادتها مجدَّدًا إلى العنصر بعد حذفها آنذاك. استعمل التابع .prop() لضبط قيمة هذه الخاصِّيَّات إلى false عوضًا عن حذفها.
ملاحظات إضافية
يؤدّي استخدام التّابع .prop() في متصفّح Internet Explorer قبل الإصدار التاسع لضبط خاصِّيَّة كائن لعنصر DOM إلى أي شيء بخلاف قيمة أولية بسيطة (مثل عدد، أو سلسلة نصيّة، أو قيمة منطقيّة) إلى تسريب في الذاكرة (memory leak) إن لم تُزال الخاصِّيَّة الكائنيِّة (باستخدام التّابع .removeProp()) وذلك قبل إزالة عنصر DOM من المستند. ولتعيين قيم كائنات DOM بأمان دون حدوث تسريبات في الذّاكرة، استخدم التّابع .data().
أمثلة
تعيين خاصِّيَّة رقمية لفقرة <p> ثمَّ حذفها:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>removeProp مثالٌ عن استعمال التابع</title>
<style>
img {
padding: 10px;
}
div {
color: red;
font-size: 24px;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<p></p>
<script>
para = $( "p" );
para
.prop( "luggageCode", 1234 )
.append( "The secret luggage code is: ", String( para.prop( "luggageCode" ) ), ". " )
.removeProp( "luggageCode" )
.append( "Now the secret luggage code is: ", String( para.prop( "luggageCode" ) ), ". " );
</script>
</body>
</html>