Special Features

Respectful Handling of Sacred Words

The package automatically excludes the word (اللّٰه) and its variations from Kashida application, preserving its traditional appearance.

// The word "اللّٰه" will never automatically receive Kashida
ArabicJustifiedText('بسم اللّٰه الرحمن الرحيم')
// Result: بـسـم اللّٰه الـرحمـن الـرحيـم (اللّٰه remains unchanged)

Automatically excluded variations:

  • اللّٰه، اللَّه، ٱللّٰه، للّٰه، وللّٰه، واللّٰه، باللّٰه، تاللّٰه

Custom Word Exclusions

You can exclude additional words from Kashida application:

ArabicJustifiedText(
  'اللهم صل وسلم وبارك على نبينا محمد وعلى آله وصحبه أجمعين',
  excludedWords: ['محمد', 'اللهم'],
)

Use cases:

  • 📖 Religious texts (prophets' names, sacred terms)
  • 📚 Brand names or proper nouns
  • ✍️ Technical terms that should remain unchanged