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

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

jQuery.trim( str )‎

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

يعيد سلسلة نصية (String).

الوصف

يزيل هذا التابع جميع المسافات البيضاء (whitespace) من بداية ونهاية السلسلة النصية المُمرَّرة إليه.

jQuery.trim( str )‎

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

str

السلسلة النصية المُراد إزالة المسافات البيضاء من بدايتها ونهايتها.

يزيل التابع ‎$.trim()‎ جميع محارف الأسطر الجديدة، والمسافات الفارغة (تدخل المسافات غير المقطوعة [non-breaking spaces] من ضمنها)، ومسافات الجدولة (tabs) من بداية ونهاية السلسلة النصية المعطاة. لن تتأثر محارف المسافات البيضاء إن وقعت في منتصف السلسلة النصيَّة.

أمثلة

إزالة المسافات البيضاء من بداية ونهاية سلسلةٍ نصيَّةٍ:
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.trim مثالٌ عن استعمال التابع</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<pre id="original"></pre>
<pre id="trimmed"></pre>
 
<script>
var str = "         هنالك الكثير من المسافات الفارغة قبل وبعد هذه الجملة         ";
$( "#original" ).html( "Original String: '" + str + "'" );
$( "#trimmed" ).html( "$.trim()'ed: '" + $.trim(str) + "'" );
</script>
 
</body>
</html>
سنحصل بعد تنفيذ هذه الشيفرة على النتيجة التالية:
'         هنالك الكثير من المسافات الفارغة قبل وبعد هذه الجملة         '
$.trim()'ed: 'هنالك الكثير من المسافات الفارغة قبل وبعد هذه الجملة'
إزالة المسافات البيضاء من بداية ونهاية سلسلةٍ نصيَّةٍ:
$.trim("    مرحبًا، كيف حالك؟    ");
سنحصل بعد تنفيذ هذه الشيفرة على النتيجة التالية:
"مرحبًا، كيف حالك؟"

مصادر