الفرق بين المراجعتين لصفحة: «jQuery/jQuery/removeData»

→ التعديل السابق

مرئينص الويكي

المراجعة الحالية بتاريخ 13:27، 1 يوليو 2018

`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

مصادر

صفحة التابع jQuery.removeData في توثيق jQuery الرسمي.

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