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

من موسوعة حسوب
< jQuery‏ | jQuery
مراجعة 06:53، 1 يوليو 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

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

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

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

مصادر