#עיצוב טקסט

סעיף זה מציג מגוון של מעצבי תמליל (formatters) עבור נתוני טקסט. הסעיפים הבאים יציגו את התחביר, הדוגמאות והתוצאות של כל מעצב.

#1. :lowerCase

#הסבר תחביר

ממיר את כל האותיות לאותיות קטנות.

#דוגמה

'My Car':lowerCase()   // פלט "my car"
'my car':lowerCase()   // פלט "my car"
null:lowerCase()       // פלט null
1203:lowerCase()       // פלט 1203

#תוצאה

הפלט של כל דוגמה מוצג בהערות.

#2. :upperCase

#הסבר תחביר

ממיר את כל האותיות לאותיות גדולות.

#דוגמה

'My Car':upperCase()   // פלט "MY CAR"
'my car':upperCase()   // פלט "MY CAR"
null:upperCase()       // פלט null
1203:upperCase()       // פלט 1203

#תוצאה

הפלט של כל דוגמה מוצג בהערות.

#3. :ucFirst

#הסבר תחביר

ממיר רק את האות הראשונה של המחרוזת לאות גדולה, ומשאיר את השאר ללא שינוי.

#דוגמה

'My Car':ucFirst()     // פלט "My Car"
'my car':ucFirst()     // פלט "My car"
null:ucFirst()         // פלט null
undefined:ucFirst()    // פלט undefined
1203:ucFirst()         // פלט 1203

#תוצאה

הפלט מוצג בהערות.

#4. :ucWords

#הסבר תחביר

ממיר את האות הראשונה של כל מילה במחרוזת לאות גדולה.

#דוגמה

'my car':ucWords()     // פלט "My Car"
'My cAR':ucWords()     // פלט "My CAR"
null:ucWords()         // פלט null
undefined:ucWords()    // פלט undefined
1203:ucWords()         // פלט 1203

#תוצאה

הפלט מוצג בדוגמאות.

#5. :print(message)

#הסבר תחביר

תמיד מחזיר את ההודעה שצוינה, ללא קשר לנתונים המקוריים, ומשמש כמעצב חלופי (fallback formatter). פרמטר:

• message: הטקסט להדפסה.

#דוגמה

'My Car':print('hello!')   // פלט "hello!"
'my car':print('hello!')   // פלט "hello!"
null:print('hello!')       // פלט "hello!"
1203:print('hello!')       // פלט "hello!"

#תוצאה

בכל המקרים, מוחזרת המחרוזת "hello!" שצוינה.

#6. :printJSON

#הסבר תחביר

ממיר אובייקט או מערך למחרוזת בפורמט JSON.

#דוגמה

[{'id':2,'name':'homer'},{'id':3,'name':'bart'}]:printJSON()
// פלט "[
  {"id": 2, "name": "homer"},
  {"id": 3, "name": "bart"}
]"
'my car':printJSON()   // פלט ""my car""

#תוצאה

הפלט בדוגמאות הוא המחרוזת בפורמט JSON לאחר ההמרה.

#7. :unaccent

#הסבר תחביר

מסיר סימני הטעמה (דיאקריטיים) מהטקסט, וממיר אותו לפורמט ללא סימני הטעמה.

#דוגמה

'crème brulée':unaccent()   // פלט "creme brulee"
'CRÈME BRULÉE':unaccent()   // פלט "CREME BRULEE"
'être':unaccent()           // פלט "etre"
'éùïêèà':unaccent()       // פלט "euieea"

#תוצאה

בכל הדוגמאות, הפלט הוא הטקסט ללא סימני הטעמה.

#8. :convCRLF

#הסבר תחביר

ממיר תווי חזרה לשורה וירדה שורה (\r\n או \n) לתווי מעבר שורה ספציפיים למסמך. זה שימושי עבור פורמטים כמו DOCX, PPTX, ODT, ODP ו-ODS. שימו לב: כאשר משתמשים ב-:html לפני המעצב :convCRLF, התו \r\n יומר לתגית <br>.

#דוגמה

// עבור פורמט ODT:
'my blue 
 car':convCRLF()    // פלט "my blue <text:line-break/> car"
'my blue 
 car':convCRLF()    // פלט "my blue <text:line-break/> car"

// עבור פורמט DOCX:
'my blue 
 car':convCRLF()    // פלט "my blue </w:t><w:br/><w:t> car"
'my blue 
 car':convCRLF()    // פלט "my blue </w:t><w:br/><w:t> car"

#תוצאה

הפלט מציג את סימני מעבר השורה המתאימים לפורמט המסמך הספציפי.

#9. :substr(begin, end, wordMode)

#הסבר תחביר

מבצע פעולות חיתוך (substring) על מחרוזת, החל מהאינדקס begin (מבוסס 0) ועד לפני האינדקס end. פרמטר אופציונלי wordMode (ערך בוליאני או last) קובע אם לשמור על שלמות מילים, כדי לא לחתוך מילה באמצע.

#דוגמה

'foobar':substr(0, 3)            // פלט "foo"
'foobar':substr(1)               // פלט "oobar"
'foobar':substr(-2)              // פלט "ar"
'foobar':substr(2, -1)           // פלט "oba"
'abcd efg hijklm':substr(0, 11, true)  // פלט "abcd efg "
'abcd efg hijklm':substr(1, 11, true)  // פלט "abcd efg "

#תוצאה

הפלט הוא קטע המחרוזת שחולץ בהתאם לפרמטרים.

#10. :split(delimiter)

#הסבר תחביר

מפצל מחרוזת למערך באמצעות התו המפריד (delimiter) שצוין. פרמטר:

• delimiter: מחרוזת התו המפריד.

#דוגמה

'abcdefc12':split('c')    // פלט ["ab", "def", "12"]
1222.1:split('.')         // פלט ["1222", "1"]
'ab/cd/ef':split('/')      // פלט ["ab", "cd", "ef"]

#תוצאה

תוצאת הדוגמה היא מערך מפוצל לפי התו המפריד שצוין.

#11. :padl(targetLength, padString)

#הסבר תחביר

מרפד את הצד השמאלי של מחרוזת בתווים שצוינו עד שאורך המחרוזת הסופי מגיע ל-targetLength. אם אורך היעד קטן מאורך המחרוזת המקורית, המחרוזת המקורית מוחזרת. פרמטרים:

• targetLength: האורך הכולל הרצוי.
• padString: המחרוזת המשמשת לריפוד (ברירת המחדל היא רווח).

#דוגמה

'abc':padl(10)              // פלט "       abc"
'abc':padl(10, 'foo')       // פלט "foofoofabc"
'abc':padl(6, '123465')     // פלט "123abc"
'abc':padl(8, '0')          // פלט "00000abc"
'abc':padl(1)               // פלט "abc"

#תוצאה

הפלט של כל דוגמה הוא המחרוזת המרופדת משמאל.

#12. :padr(targetLength, padString)

#הסבר תחביר

מרפד את הצד הימני של מחרוזת בתווים שצוינו עד שאורך המחרוזת הסופי מגיע ל-targetLength. הפרמטרים זהים לאלה של :padl.

#דוגמה

'abc':padr(10)              // פלט "abc       "
'abc':padr(10, 'foo')       // פלט "abcfoofoof"
'abc':padr(6, '123465')     // פלט "abc123"
'abc':padr(8, '0')          // פלט "abc00000"
'abc':padr(1)               // פלט "abc"

#תוצאה

הפלט הוא המחרוזת המרופדת מימין.

#13. :ellipsis(maximum)

#הסבר תחביר

אם הטקסט חורג ממספר התווים שצוין, מוסיף שלוש נקודות ("...") בסופו. פרמטר:

• maximum: מספר התווים המרבי המותר.

#דוגמה

'abcdef':ellipsis(3)      // פלט "abc..."
'abcdef':ellipsis(6)      // פלט "abcdef"
'abcdef':ellipsis(10)     // פלט "abcdef"

#תוצאה

תוצאות הדוגמאות מציגות טקסט קטוע עם שלוש נקודות בסופו, במידת הצורך.

#14. :prepend(textToPrepend)

#הסבר תחביר

מוסיף את הטקסט שצוין כתחילית (prefix) בתחילת המחרוזת. פרמטר:

• textToPrepend: טקסט התחילית.

#דוגמה

'abcdef':prepend('123')     // פלט "123abcdef"

#תוצאה

הפלט הוא המחרוזת עם התחילית שנוספה.

#15. :append(textToAppend)

#הסבר תחביר

מוסיף את הטקסט שצוין כסיומת (suffix) בסוף המחרוזת. פרמטר:

• textToAppend: טקסט הסיומת.

#דוגמה

'abcdef':append('123')      // פלט "abcdef123"

#תוצאה

הפלט הוא המחרוזת עם הסיומת שנוספה.

#16. :replace(oldText, newText)

#הסבר תחביר

מחליף את כל המופעים של oldText בטקסט ב-newText. פרמטרים:

• oldText: הטקסט שיש להחליף.
• newText: הטקסט החדש שיחליף. שימו לב: אם newText הוא null, זה מציין שיש להסיר את הטקסט התואם.

#דוגמה

'abcdef abcde':replace('cd', 'OK')    // פלט "abOKef abOKe"
'abcdef abcde':replace('cd')          // פלט "abef abe"
'abcdef abcde':replace('cd', null)      // פלט "abef abe"
'abcdef abcde':replace('cd', 1000)      // פלט "ab1000ef ab1000e"

#תוצאה

הפלט הוא המחרוזת לאחר החלפת הקטעים שצוינו.

#17. :len

#הסבר תחביר

מחזיר את האורך של מחרוזת או מערך.

#דוגמה

'Hello World':len()     // פלט 11
'':len()                // פלט 0
[1,2,3,4,5]:len()       // פלט 5
[1,'Hello']:len()       // פלט 2

#תוצאה

הפלט הוא ערך האורך המתאים.

#18. :t

#הסבר תחביר

מתרגם את הטקסט באמצעות מילון תרגום. הדוגמאות והתוצאות תלויות בתצורת מילון התרגום בפועל.

#19. :preserveCharRef

#הסבר תחביר

כברירת מחדל, תווים לא חוקיים מסוימים מ-XML (כמו &, >, <, וכו') מוסרים. מעצב זה שומר על הפניות לתווים (לדוגמה, § נשאר ללא שינוי) ומתאים לתרחישי יצירת XML ספציפיים. הדוגמאות והתוצאות תלויות במקרה השימוש הספציפי.