قوانین پیشفرض FarsiUI برای نمایش ارقام فارسی در متن و فرمها، و اینکه چه زمانی باید ارقام لاتین بمانند.
در FarsiUI ارقام فارسی پیشفرض محتوای فارسی هستند. جهت متن (dir) و سبک ارقام دو مفهوم جدا هستند.
متن معمولی فارسی باید ارقام فارسی نشان دهد:
<p>این محصول در سال 2026 منتشر شد.</p>نمایش:
این محصول در سال ۲۰۲۶ منتشر شد.این رفتار برای عنوان، توضیح، پاراگراف، فهرست، جدول، دکمه، برچسب، Pagination، مستندات و محتوای مشابه اعمال میشود.
dir="ltr" فقط جهت را عوض میکند؛ ارقام را لاتین نمیکند.
شماره تلفن میتواند LTR بماند و همچنان فارسی باشد:
<span dir="ltr">09121234567</span>نمایش:
۰۹۱۲۱۲۳۴۵۶۷برای ارقام لاتین صریح:
<span dir="ltr" data-persian-digits="false">2026</span>نمایش:
2026این موارد هرگز به ارقام فارسی تبدیل نمیشوند:
code، pre، kbd، sampdata-persian-digits="false" یا lang="en"مثال:
const year = 2026باید دقیقاً همان 2026 بماند.
https://example.com/2026
test2026@example.comهمچنین لاتین میمانند.
در زمینهٔ فارسی، فیلدهای متنی ارقام را فارسی نمایش میدهند، ولی مقدار منطقی فرم ASCII میماند:
شماره سفارش ۱۲۳۴۵شماره سفارش 12345برای این نوعها تبدیل ارقام خاموش است:
emailpasswordurlfiletel بهتنهایی جهت یا سبک ارقام را تعیین نمیکند؛ میتوانید dir="ltr" بگذارید و همچنان ارقام فارسی داشته باشید.
جزئیات Input را در ورودی ببینید.
{/* خاموش کردن تبدیل در یک زیردرخت */}
<span data-persian-digits="false">2026</span>
{/* یا روی Input / Textarea */}
<Input persianDigits={false} />
<Textarea persianDigits={false} />persianDigits="auto" (پیشفرض) در زمینهٔ فارسی فعال است.
dir="ltr" → فقط جهت، نه سبک ارقامdata-persian-digits="false" یا lang="en"