رفتن به محتوای اصلی
  • معرفی
  • نصب
  • Tailwind
  • وب کامپوننت‌ها (بدون React)
  • دوزبانه، فارسی و انگلیسی
  • پلاگین‌های فیگما
  • استفاده با هوش مصنوعی
  • آیکون‌ها
  • راهنمای آیکون‌ها
  • سفارشی‌سازی و تم
  • حرکت و ریزتعامل‌ها
  • حالت‌های کامپوننت‌ها
  • فونت و تایپوگرافی
  • دسترس‌پذیری
  • نوشتن متن رابط
  • رنگ‌ها
  • برند کاشی
  • مقایسه با دیگران
  • نسخه‌ها
  • سیاست تغییرات
  • مهاجرت به ۲.۰
  • امنیت
  • حجم کامپوننت‌ها
  • فیلد فارسی
  • دیت‌پیکر شمسی
  • کد تأیید (OTP)
  • بازهٔ تاریخ شمسی
  • انتخاب ماه
  • شمارش معکوس
  • هیت‌مپ فعالیت
  • انتخاب استان
  • نقشهٔ ایران
  • فرم نشانی
  • انتخاب نوبت
  • ویرایش نگارشی
  • نمایش مبلغ
  • بازهٔ قیمت
  • کارت بانکی
  • رسید پرداخت
  • برگ تقویم
  • لوگوی بانک‌ها
  • ابزارهای فارسی
  • آپلود فایل
  • آکاردئون
  • آواتار
  • اسپلیتر
  • استپر
  • اسکلتون
  • اسلایدر
  • اعتبارسنجی فرم
  • امتیاز ستاره‌ای
  • انتخاب چندتایی
  • انتخاب رنگ
  • بج
  • بردکرامب
  • برگهٔ پایین
  • بنر
  • پاپ‌اور
  • تایم‌لاین
  • تب‌ها
  • تور معرفی
  • توست
  • تولتیپ
  • جداکننده و کلید میان‌بر
  • جدول داده
  • جستجو با پیشنهاد
  • چک‌باکس
  • چیپس
  • حالت خالی
  • دراپ‌داون
  • دکمه
  • دکمهٔ کپی
  • دیالوگ
  • رادیو
  • سایدبار
  • سگمنت
  • سلکت
  • سوییچ
  • صفحه‌بندی
  • قدرت رمز عبور
  • کارت
  • کارت آمار
  • کاروسل
  • کامبوباکس
  • کامند پالت
  • کشو
  • گروه دکمه
  • گیج
  • منوی راست‌کلیک
  • نمای درختی
  • نمودار
  • نمونهٔ رنگ
  • نوار پیشرفت
  • نوار ناوبری
  • ورودی
  • ورودی تگ
  • ورودی عدد
  • ویرایش درجا
  • هشدار
شروع کنید

راست‌چین کردن سایت با CSS؛ راهنمای کامل RTL

چطور یک سایت فارسی را درست راست‌به‌چپ کنیم: dir و lang، ویژگی‌های منطقی CSS، فلکس و گرید، آیکون‌های جهت‌دار و متن‌های دوجهته؛ با نمونه‌کد.

سپنتا پویا۴ دقیقه مطالعه

طرح سه کاشی سفید روی زمینهٔ آبی، نماد راست‌چین کردن صفحه

اگر تا حالا سایتی را با text-align: right و چند float: right «راست‌چین» کرده‌اید، احتمالاً دیده‌اید که کار تمام نمی‌شود: فاصله‌ها برعکس است، فلش «بعدی» به عقب اشاره می‌کند، شماره تلفن به‌هم می‌ریزد و هر کامپوننت تازه دوباره همان دردسر را دارد. راست‌چین کردن درست یک ترفند نیست؛ چند قاعدهٔ ساده است که اگر از اول رعایت شوند، صفحه خودش درست می‌چیند.

این راهنما همان قاعده‌ها را به ترتیب می‌گوید: از تگ html شروع می‌کنیم و به آیکون‌ها و متن‌های دوجهته می‌رسیم.

قدم اول: dir و lang روی html

مهم‌ترین خط کل کار همین است:

<html lang="fa" dir="rtl">

dir="rtl" به مرورگر می‌گوید جهت پایهٔ سند راست‌به‌چپ است. با همین یک ویژگی، متن از راست شروع می‌شود، جدول‌ها از راست چیده می‌شوند، نوار اسکرول افقی سمت چپ می‌رود و flex و grid ترتیب را از راست حساب می‌کنند. lang="fa" هم به صفحه‌خوان، موتور جستجو و الگوریتم شکستن خط می‌گوید زبان صفحه فارسی است.

یک اشتباه رایج این است که به‌جای dir از CSS استفاده شود:

/* نکنید */
body { direction: rtl; }

ویژگی direction در CSS فقط ظاهر را عوض می‌کند و معنای سند را نه؛ صفحه‌خوان‌ها و ابزارهای ترجمه آن را نمی‌بینند. جهت جزو محتواست، پس جایش در HTML است.

مقایسهٔ دو کارت: در یکی با margin-left فاصلهٔ آیکون اشتباه افتاده و در دیگری با margin-inline-start درست است
ویژگی‌های فیزیکی مثل margin-left در صفحهٔ راست‌به‌چپ جای اشتباه می‌افتند؛ ویژگی‌های منطقی خودشان را با جهت هماهنگ می‌کنند.

ویژگی‌های منطقی به‌جای چپ و راست

ریشهٔ بیشتر مشکل‌های RTL، ویژگی‌های «فیزیکی» CSS است: margin-left، padding-right، left: 0، border-right و text-align: left. این‌ها به جهت صفحه کاری ندارند و در فارسی جای اشتباه می‌نشینند.

CSS برای هر کدام یک معادل «منطقی» دارد که بر اساس جهت نوشتن کار می‌کند. «ابتدا» (start) در فارسی یعنی راست و در انگلیسی یعنی چپ:

فیزیکی (نکنید) منطقی (بکنید)
margin-left margin-inline-start
padding-right padding-inline-end
left: 0 inset-inline-start: 0
border-right border-inline-end
text-align: right text-align: start
width / height inline-size / block-size

نتیجه این است که یک CSS واحد هم در فارسی درست است و هم در انگلیسی. اگر روزی بخواهید صفحه‌ای انگلیسی داخل سایت فارسی داشته باشید، کافی است dir="ltr" بدهید؛ چیزی برای بازنویسی نمی‌ماند.

.card__icon {
  margin-inline-end: 0.75rem;   /* فاصله تا متن، در هر دو جهت درست */
  inset-inline-start: 1rem;     /* به‌جای left یا right */
}

همهٔ مرورگرهای امروزی این ویژگی‌ها را پشتیبانی می‌کنند، پس دلیلی برای ماندن روی left و right نیست.

فلکس و گرید خودشان درست‌اند

display: flex و display: grid از قبل منطقی‌اند. در صفحهٔ rtl، اولین فرزند فلکس سمت راست می‌نشیند و justify-content: flex-start یعنی راست. پس لازم نیست برای فارسی flex-direction: row-reverse بنویسید؛ این کار در واقع ترتیب را دوباره برعکس می‌کند و صفحه‌خوان هم ترتیب را با ظاهر ناهماهنگ می‌بیند.

نوار ابزار با سه دکمه که در حالت row-reverse ترتیبش با ترتیب تب صفحه‌کلید فرق دارد
row-reverse ظاهر را برعکس می‌کند ولی ترتیب تب صفحه‌کلید همان می‌ماند؛ در RTL فلکس معمولی کافی است.

آیکون‌های جهت‌دار

بیشتر آیکون‌ها جهت ندارند؛ ذره‌بین، قلب و سطل زباله در فارسی و انگلیسی یکی‌اند و نباید قرینه شوند. ولی چند آیکون معنایشان به جهت وابسته است:

  • فلش‌های «بعدی» و «قبلی»
  • شورون منوی کشویی که به سمت زیرمنو اشاره می‌کند
  • آیکون «ارسال» و «خروج»

در صفحهٔ فارسی، «بعدی» یعنی چپ و «بازگشت» یعنی راست. ساده‌ترین راه این است که آیکون مناسب را انتخاب کنید، نه اینکه همه را با transform: scaleX(-1) قرینه کنید. اگر کامپوننت هم در فارسی و هم در انگلیسی استفاده می‌شود، فقط همان آیکون‌های جهت‌دار را با :dir(rtl) قرینه کنید. جزئیات بیشتر را در مقالهٔ آیکون‌ها در رابط راست‌به‌چپ نوشته‌ایم.

.icon--directional:dir(rtl) { transform: scaleX(-1); }

متن دوجهته: شماره، ایمیل و کد

متن فارسی پر از تکه‌های چپ‌به‌راست است: ایمیل، شماره کارت، نام پکیج، نشانی سایت. مرورگر این تکه‌ها را با «الگوریتم دوجهتهٔ یونیکد» می‌چیند و گاهی نتیجه عجیب است؛ مثلاً @kashi-ui/react در وسط جملهٔ فارسی به‌شکل kashi-ui/react@ دیده می‌شود.

راه درست، جدا کردن این تکه‌ها با تگ bdi یا ویژگی dir است:

<p>پکیج <bdi>@kashi-ui/react</bdi> را نصب کنید.</p>
<input type="email" dir="ltr">

برای فیلدهایی که همیشه لاتین‌اند (ایمیل، نشانی سایت، شبا) dir="ltr" بگذارید، ولی برچسب و پیام خطایشان را فارسی و راست‌چین نگه دارید.

یک جملهٔ فارسی با نام پکیج و فیلد شماره کارت، یک بار به‌هم‌ریخته و یک بار با bdi و dir=ltr درست
تگ bdi و dir=ltr روی فیلدهای لاتین، ترتیب نویسه‌ها را در متن فارسی درست نگه می‌دارد.

یک فهرست بازبینی کوتاه

پیش از انتشار، این‌ها را چک کنید:

  1. lang="fa" dir="rtl" روی html هست؟
  2. در CSS هیچ left، right، margin-left یا padding-rightی نمانده که به جهت مربوط باشد؟ با جستجو در کد پیدایشان کنید.
  3. row-reverse فقط برای دلیل واقعی استفاده شده، نه برای راست‌چین کردن؟
  4. فقط آیکون‌های جهت‌دار قرینه شده‌اند؟
  5. ایمیل، شماره کارت و کد در متن فارسی درست دیده می‌شوند؟
  6. صفحه را یک بار با dir="ltr" باز کرده‌اید تا مطمئن شوید CSS به جهت وابسته نیست؟

اگر نمی‌خواهید همه را از صفر بسازید

همهٔ کامپوننت‌های کاشی از ابتدا با ویژگی‌های منطقی ساخته شده‌اند و در هر دو جهت تست می‌شوند؛ از فیلد و دکمه تا تقویم شمسی و جدول. با Tailwind هم می‌شود همین قاعده‌ها را با کلاس‌هایی مثل ms-4 و pe-2 رعایت کرد. برای شروع، راهنمای نصب کاشی را ببینید.