التابع ‎‎jQuery.removeData()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.removeData( element [, name ] )‎

القيم المعادة

يعيد كائنًا من النوع jQuery.

الوصف

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

jQuery.removeData( element [, name ] )‎

أُضيفت مع الإصدار: 1.2.3.

element

عنصر DOM الذي يراد حذف البيانات المرفقة به.

name

سلسلة نصية تحتوي على اسم قطعة البيانات المراد حذفها.

ملاحظة: هذا التابع منخفض المستوى، لذا يجب عليك استعمال ‎.removeData()‎ عوضًا عنه.

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

أمثلة

تعيين مخزن بيانات لاسمين ثمَّ حذف أحدهما:
<!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>
نتيجة تنفيذ المثال السابق هي:
القيمة الأولى قبل إنشائها: undefined
القيمة الأولى بعد إنشائها: VALUE-1
القيمة الأولى بعد حذفها: undefined
القيمة الثانية بعد حذفها: VALUE-2

مصادر