عرض مصدر jQuery/jQuery/removeData

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

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

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

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

==== <code>element</code> ====
عنصر DOM الذي يراد حذف البيانات المرفقة به.

==== <code>name</code> ====
سلسلة نصية تحتوي على اسم قطعة البيانات المراد حذفها.

'''ملاحظة''': هذا التابع منخفض المستوى، لذا يجب عليك استعمال <code>[[jQuery/removeData|‎.removeData()]]</code>‎ عوضًا عنه.

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

=== أمثلة ===
تعيين مخزن بيانات لاسمين ثمَّ حذف أحدهما:<syntaxhighlight lang="html">
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.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>
var div = $( "div" )[ 0 ];
$( "span:eq(0)" ).text( "" + $( "div" ).data( "test1" ) );
jQuery.data( div, "test1", "VALUE-1" );
jQuery.data( div, "test2", "VALUE-2" );
$( "span:eq(1)" ).text( "" + jQuery.data( div, "test1" ) );
jQuery.removeData( div, "test1" );
$( "span:eq(2)" ).text( "" + jQuery.data( div, "test1" ) );
$( "span:eq(3)" ).text( "" + jQuery.data( div, "test2" ) );
</script>
 
</body>
</html>

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

</syntaxhighlight>

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