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