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

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى التنقل اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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("    مرحبًا، كيف حالك؟    ");

سنحصل بعد تنفيذ هذه الشيفرة على النتيجة التالية:

"مرحبًا، كيف حالك؟"

مصادر