التابع jQuery.trim() في 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(" مرحبًا، كيف حالك؟ ");
سنحصل بعد تنفيذ هذه الشيفرة على النتيجة التالية:
"مرحبًا، كيف حالك؟"