پرش به محتوای اصلی

راهنمای تبدیل CSS چپ‌به‌راست به راست‌به‌چپ

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

قالب‌ها و کتابخانه‌هایی که برای زبان‌های چپ‌به‌راست ساخته شده‌اند، پر از margin-left، text-align: left و کلاس‌هایی مثل ml-4 هستند. وقتی همان طرح را برای فارسی راست‌به‌چپ می‌کنید، این‌ها برعکس نمی‌شوند و چیدمان به‌هم می‌ریزد. این ابزار سه راه برای حل این مشکل دارد.

«ویژگی‌های منطقی» ویژگی‌های فیزیکی را به معادل منطقی مثل margin-inline-start تبدیل می‌کند تا همان CSS در هر دو جهت درست کار کند. «قرینه‌سازی (rtlcss)» یک نسخه‌ی راست‌به‌چپ جدا می‌سازد. «کلاس‌های Tailwind» کلاس‌های فیزیکی را در متن، JSX یا HTML به کلاس‌های منطقی تبدیل می‌کند. همه‌چیز در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. حالت تبدیل را انتخاب کنید

    اگر می‌خواهید یک CSS برای هر دو جهت داشته باشید «ویژگی‌های منطقی»، اگر فایل جدای RTL لازم دارید «قرینه‌سازی (rtlcss)» و برای کد Tailwind «کلاس‌های Tailwind» را بردارید.

  2. کد را بچسبانید

    CSS یا قطعه‌ی HTML و JSX را در کادر ورودی بگذارید، یا «نمونه» را بزنید تا یک مثال بیاید.

  3. گزارش را بخوانید

    خروجی همان لحظه ساخته می‌شود. موردهایی که خودکار تبدیل نشدند، با خط و دلیلشان فهرست می‌شوند تا دستی بازبینی کنید.

  4. خطی را نادیده بگیرید

    در حالت قرینه‌سازی، اگر خطی نباید برعکس شود، پیش از آن /*rtl:ignore*/ بنویسید.

نمونه‌های کاربردی

  • CSS منطقی برای هر دو جهت

    فاصله، چینش متن و جایگاه به معادل منطقی تبدیل می‌شوند و در صفحه‌ی فارسی و انگلیسی هر دو درست کار می‌کنند.

    .a{margin-left:8px;text-align:left;left:0}

    نتیجه: .a{margin-inline-start:8px;text-align:start;inset-inline-start:0}

  • قرینه‌سازی با rtlcss

    چپ و راست جابه‌جا می‌شوند؛ در padding چهارمقداری هم مقدار راست و چپ جای هم را می‌گیرند.

    .a{margin-left:8px;text-align:left;padding:1px 2px 3px 4px}

    نتیجه: .a{margin-right:8px;text-align:right;padding:1px 4px 3px 2px}

  • کلاس‌های Tailwind

    کلاس‌ها داخل HTML پیدا می‌شوند و پیشوندهایی مثل md: حفظ می‌شوند.

    <div class="ml-4 pl-2 text-left md:mr-auto">

    نتیجه: <div class="ms-4 ps-2 text-start md:me-auto">

اشتباه‌های رایج

  • قرینه کردن CSS که از قبل منطقی است: margin-inline-start خودش در RTL درست است و قرینه‌سازی چیزی را بهتر نمی‌کند. برای کد تازه از ویژگی‌های منطقی استفاده کنید.
  • برعکس کردن آیکن‌ها و نمودارها: نماد پخش، لوگو یا نمودار زمانی نباید آینه‌ای شود. با /*rtl:ignore*/ این خط‌ها را کنار بگذارید.
  • فراموش کردن dir="rtl" روی html: CSS منطقی بر پایه‌ی جهت سند کار می‌کند؛ بدون آن، start همان left است.
  • بازبینی نکردن موردهای گزارش‌شده: مقدارهایی مثل transform: translateX یا background-position خودکار تبدیل نمی‌شوند و باید دستی اصلاح شوند.

ویژگی منطقی یعنی چه؟

ویژگی‌های فیزیکی مثل left و right به لبه‌ی صفحه اشاره می‌کنند، اما ویژگی‌های منطقی مثل inline-start و inline-end به جهت نوشتار. در صفحه‌ی فارسی inline-start سمت راست است و در صفحه‌ی انگلیسی سمت چپ. با این روش یک CSS برای هر دو زبان کافی است.

مرورگرهای امروزی همه از ویژگی‌های منطقی پشتیبانی می‌کنند. در Tailwind هم کلاس‌هایی مثل ms-4، pe-2 و text-start همین کار را می‌کنند.

پرسش‌های متداول

قرینه‌سازی با ویژگی‌های منطقی چه فرقی دارد؟
قرینه‌سازی (rtlcss) یک CSS جدا برای راست‌به‌چپ می‌سازد. ویژگی‌های منطقی همان یک فایل را برای هر دو جهت درست می‌کنند و نگه‌داری آسان‌تری دارند؛ برای پروژه‌ی تازه این روش بهتر است.
چرا بعضی خط‌ها «تبدیل نشد» گزارش می‌شوند؟
مواردی مانند translateX و موقعیت پس‌زمینه معادل منطقی ندارند و تبدیل خودکارشان ممکن است ظاهر را خراب کند؛ ابزار آن‌ها را فقط گزارش می‌کند تا خودتان تصمیم بگیرید.
کد من به جایی فرستاده می‌شود؟
نه؛ تبدیل کاملاً در مرورگر شما انجام می‌شود.

ابزارهای مرتبط