عرض مصدر jQuery/removeData

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.removeData()‎</code>‎ في jQuery}}</noinclude>
== <code>‎.removeData( [name ] )‎</code> ==

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

=== الوصف ===
يحذف هذا التابع جزءًا من البيانات المخزَّنة مسبقًا.

=== <code>‎.removeData( [name ] )‎</code> ===
أُضيف مع الإصدار: 1.2.3.

==== <code>name</code> ====
سلسلة نصيِّة تمثِّل اسم جزء البيانات المراد حذفها.

=== <code>‎.removeData( [list ] )‎</code> ===
أُضيف مع الإصدار: 1.7.

==== <code>list</code> ====
مصفوفة أو سلسلة نصية تحتوي على أسماء أجزاء البيانات المراد حذفها، وتفصل الأسماء في السلسلة النصية بفراغ.

يسمح لنا التابع ‎<code>.removeData()‎</code> بحذف القيم التي ضُبطت مسبقًا باستعمال التابع <code>[[jQuery/data|‎.data()]]</code>‎. إن مرِّر إلى التابع اسم مفتاح الجزء المراد حذفه، فستُحذف تلك القيم المحدَّدة فقط. إن لم يمرَّر إلى التابع أي وسيط، فستُحذف جميع القيم.

الجدير بالذكر أنَّ التابع <code>‎.removeData()</code>‎ سيحذف البيانات من مخزن البيانات الداخلي في jQuery فقط، بينما لن يحذف أية خاصِّيَّات (attributes) مقابلة تبدأ بالاسم <code>data-</code>‎ في العنصر. الاستدعاء اللاحق للتابع <code>[[jQuery/data|data()]]</code>‎ سيسترجع القيمة من الخاصِّيَّة <code>data-</code>‎؛ ولمنع ذلك، يجب استعمال التابع <code>[[jQuery/removeAttr|‎.removeAttr()]]</code>‎ والتابع <code>‎.removeData()</code>‎ جنبًا إلى جنب لحذف الخاصِّيَّات <code>data-</code>‎ أيضًا. بما أنَّه لم يستعمل التابع <code>[[jQuery/data|data()‎]]</code> الخاصِّيَّات <code>data-‎</code> قبل الإصدار jQuery 1.4.3، فلم يكن لهذا الأمر أي أهمية تذكر.

بدءًا من الإصدار jQuery 1.7، أصبح بالإمكان تمرير مصفوفة من المفاتيح أو سلسلة من المفاتيح المفصولة بفراغ إلى التابع <code>‎.removeData()‎</code>، وهذا سيؤدي بدوره إلى حذف قيمة كل مفتاح معطى في تلك المصفوفة أو السلسلة.

=== أمثلة ===
تعيين مخزن بيانات لاسمين ثمَّ حذف أحدهما:<syntaxhighlight lang="html">
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>removeData مثالٌ عن استعمال التابع</title>
  <style>
  div {
    margin: 2px;
    color: blue;
  }
  span {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div>القيمة الأولى قبل إنشائها: <span></span></div>
<div>القيمة الأولى بعد إنشائها: <span></span></div>
<div>القيمة الأولى بعد حذفها: <span></span></div>
<div>القيمة الثانية بعد حذفها: <span></span></div>
 
<script>
$( "span:eq(0)" ).text( "" + $( "div" ).data( "test1" ) );
$( "div" ).data( "test1", "VALUE-1" );
$( "div" ).data( "test2", "VALUE-2" );
$( "span:eq(1)" ).text( "" + $( "div").data( "test1" ) );
$( "div" ).removeData( "test1" );
$( "span:eq(2)" ).text( "" + $( "div" ).data( "test1" ) );
$( "span:eq(3)" ).text( "" + $( "div" ).data( "test2" ) );
</script>
 
</body>
</html>

</syntaxhighlight>نتيجة تنفيذ المثال السابق هي:<syntaxhighlight lang="text">
القيمة الأولى قبل إنشائها: undefined
القيمة الأولى بعد إنشائها: VALUE-1
القيمة الأولى بعد حذفها: undefined
القيمة الثانية بعد حذفها: VALUE-2
</syntaxhighlight>

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