متى تستخدم هذه الدوال؟
استخدم هذه الدوال لتنظيف النص وتنسيقه والبحث فيه وتقسيمه وعرضه بأمان. حافظ على المعرفات مستقرة ولا تستبدل قيمة العمل المخزنة بتحويل للعرض.طريقة الكتابة
استخدم الدالة بصيغةtrim($.request_reference). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
camelCase
تحول النص إلى صيغة camelCase المناسبة لمفتاح برمجي أو داخلي.
التوقيع: camelCase(str)
مثال:
value | camelCase(...).
capitalize
تحول الحرف الأول من النص إلى حرف كبير وتبقي بقية النص كما هي وفق تنفيذ الدالة.
التوقيع: capitalize(str)
مثال:
value | capitalize(...).
charCount
تعيد عدد المحارف في النص.
التوقيع: charCount(str)
مثال:
value | charCount(...).
count
تعد مرات ظهور جزء نصي داخل النص.
التوقيع: count(str, search)
مثال:
value | count(...).
countRegex
تعد المطابقات التي يحددها تعبير نمطي داخل النص.
التوقيع: countRegex(str, regex, flags?)
مثال:
value | countRegex(...).
endsWith
تتحقق من انتهاء النص باللاحقة المعطاة.
التوقيع: endsWith(str, substring)
مثال:
value | endsWith(...).
escapeHtml
تهرّب محارف HTML في النص لعرضه كنص لا كوسم.
التوقيع: escapeHtml(str)
مثال:
value | escapeHtml(...).
initials
تستخرج الأحرف الأولى من كلمات النص.
التوقيع: initials(str)
مثال:
value | initials(...).
kebabCase
تحول النص إلى صيغة kebab-case المفصولة بشرطات.
التوقيع: kebabCase(str)
مثال:
value | kebabCase(...).
lines
تقسم النص إلى قائمة من الأسطر.
التوقيع: lines(str)
مثال:
value | lines(...).
lower
تحول أحرف النص إلى أحرف صغيرة.
التوقيع: lower(str)
مثال:
value | lower(...).
mask
تخفي جزءاً من النص وفق إعدادات الإظهار ورمز الإخفاء؛ راجع النتيجة قبل إظهار بيانات حساسة.
التوقيع: mask(str, maskChar, start, end)
مثال:
value | mask(...).
matchRegex
تعيد المطابقات التي يجدها تعبير نمطي في النص.
التوقيع: matchRegex(str, regex, flags?)
مثال:
value | matchRegex(...).
normalizeSpace
توحّد المسافات المتتابعة وتزيل المسافات غير الضرورية من النص.
التوقيع: normalizeSpace(str)
مثال:
value | normalizeSpace(...).
pad
تملأ جانبي النص حتى طول محدد باستخدام محارف معينة.
التوقيع: pad(str, targetLength, padString?)
مثال:
value | pad(...).
padEnd
تملأ نهاية النص حتى طول محدد باستخدام محارف معينة.
التوقيع: padEnd(str, targetLength, padString?)
مثال:
value | padEnd(...).
padStart
تملأ بداية النص حتى طول محدد باستخدام محارف معينة.
التوقيع: padStart(str, targetLength, padString?)
مثال:
value | padStart(...).
pascalCase
تحول النص إلى صيغة PascalCase.
التوقيع: pascalCase(str)
مثال:
value | pascalCase(...).
repeat
تكرر النص العدد المعطى من المرات.
التوقيع: repeat(str, count)
مثال:
value | repeat(...).
replace
تستبدل أول تطابق للنص المطلوب بالقيمة البديلة.
التوقيع: replace(str, oldStr, newStr)
مثال:
value | replace(...).
replaceAll
تستبدل كل التطابقات للنص المطلوب بالقيمة البديلة.
التوقيع: replaceAll(str, oldStr, newStr)
مثال:
value | replaceAll(...).
replaceLast
تستبدل آخر تطابق للنص المطلوب بالقيمة البديلة.
التوقيع: replaceLast(str, search, replace)
مثال:
value | replaceLast(...).
replaceRegex
تستبدل المطابقات التي يحددها تعبير نمطي.
التوقيع: replaceRegex(str, regex, replace, flags?)
مثال:
value | replaceRegex(...).
slug
تحول النص إلى بادئة مقروءة مناسبة لمسار أو معرف غير معروض كقيمة عمل.
التوقيع: slug(str)
مثال:
value | slug(...).
snakeCase
تحول النص إلى صيغة snake_case المفصولة بشرطات سفلية.
التوقيع: snakeCase(str)
مثال:
value | snakeCase(...).
split
تقسم النص إلى قائمة باستخدام الفاصل المعطى.
التوقيع: split(str, separator)
مثال:
value | split(...).
startsWith
تتحقق من بدء النص بالبادئة المعطاة.
التوقيع: startsWith(str, substring)
مثال:
value | startsWith(...).
substr
تستخرج جزءاً من النص من موضع وطول محددين.
التوقيع: substr(str, start, end?)
مثال:
value | substr(...).
titleCase
تحول كلمات النص إلى صيغة عناوين.
التوقيع: titleCase(str)
مثال:
value | titleCase(...).
trim
تزيل المسافات من بداية النص ونهايته.
التوقيع: trim(str)
مثال:
value | trim(...).
trimEnd
تزيل المسافات من نهاية النص فقط.
التوقيع: trimEnd(str)
مثال:
value | trimEnd(...).
trimStart
تزيل المسافات من بداية النص فقط.
التوقيع: trimStart(str)
مثال:
value | trimStart(...).
truncate
تقص النص إلى طول محدد وتضيف لاحقة عند الحاجة وفق إعدادات الدالة.
التوقيع: truncate(str, length)
مثال:
value | truncate(...).
unescapeHtml
تعيد محارف HTML المهربة إلى شكلها النصي الأصلي.
التوقيع: unescapeHtml(str)
مثال:
value | unescapeHtml(...).
upper
تحول أحرف النص إلى أحرف كبيرة.
التوقيع: upper(str)
مثال:
value | upper(...).
wordCount
تعيد عدد الكلمات في النص بعد تحليله إلى كلمات.
التوقيع: wordCount(str)
مثال:
value | wordCount(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
