عرض مصدر jQuery/removeProp

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.removeProp()‎</code>‎ في jQuery}}</noinclude>
== <code>‎.removeProp( propertyName )‎</code> ==

=== القيم المعادة ===
يعيد كائنًا من النوع [[jQuery/jQuery|jQuery]].

=== الوصف ===
يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة.

=== <code>‎.removeProp( propertyName )‎</code> ===
أُضيف مع الإصدار: 1.6.

==== <code>propertyName</code> ====
سلسلة نصية تمثِّل اسم الخاصِّيَّة الكائنية المراد حذفها.

يحذف التابع <code>‎.removeProp()‎</code> الخاصِّيَّات التي ضُبطَت باستعمال التابع ‎<code>[[jQuery/prop|.prop()‎]]</code>.

قد تولِّد المتصفحات خطأً عند محاولة حذف بعض الخاصِّيَّات المضمَّنة لعنصر DOM أو الكائن <code>window</code>. تسند الخاصِّيَّة jQuery آنذاك القيمة <code>[[JavaScript/undefined|undefined]]</code> للخاصِّيَّة وتتجاهل أي خطأ ولَّده المتصفح. من المهم عمومًا حذف الخاصِّيَّات المخصصة التي ضبطت قيمتها لعنصر، وليس الخاصِّيَّات المضمنة (الأساسية).

'''ملاحظة''': لا تستعمل هذا التابع لحذف الخاصِّيَّات الأساسية مثل الخاصِّيَّة <code>checked</code>، أو <code>disabled</code>، أو <code>selected</code>. هذا سيؤدي إلى حذف الخاصِّيَّة نهائيًا، ولا يمكن إعادتها مجدَّدًا إلى العنصر بعد حذفها آنذاك. استعمل التابع <code>[[jQuery/prop|‎.prop()‎]]</code> لضبط قيمة هذه الخاصِّيَّات إلى <code>false</code> عوضًا عن حذفها.

=== ملاحظات إضافية ===
يؤدّي استخدام التّابع ‎<code>[[jQuery/prop|.prop()‎]]</code> في متصفّح Internet Explorer قبل الإصدار التاسع لضبط خاصِّيَّة كائن لعنصر DOM إلى أي شيء بخلاف قيمة أولية بسيطة (مثل عدد، أو سلسلة نصيّة، أو قيمة منطقيّة) إلى تسريب في الذاكرة (memory leak) إن لم تُزال الخاصِّيَّة الكائنيِّة (باستخدام التّابع ‎<code>.removeProp()‎</code>) وذلك قبل إزالة عنصر DOM من المستند. ولتعيين قيم كائنات DOM بأمان دون حدوث تسريبات في الذّاكرة، استخدم التّابع ‎<code>[[jQuery/data|.data()‎]]</code>.

=== أمثلة ===
تعيين خاصِّيَّة رقمية لفقرة <code>[[HTML/p|<nowiki><p></nowiki>]]</code> ثمَّ حذفها:<syntaxhighlight lang="html">
<!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>

</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/removeProp/ صفحة التابع ‎‎.removeProp()‎ في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Attributes]]
[[تصنيف:jQuery Manipulation]]