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

راهنمای تبدیل HTML به JSX

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

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

وقتی یک قالب HTML، تکه‌ای از یک صفحه یا یک آیکن SVG را به پروژه‌ی React می‌آورید، باید ده‌ها تغییر کوچک بدهید: class به className، for به htmlFor، style متنی به شیء جاوااسکریپت، برچسب‌های بی‌بسته مثل input به شکل خودبسته و ویژگی‌هایی مثل readonly به readOnly. این ابزار همه‌ی این‌ها را خودکار انجام می‌دهد و در صورت تمایل خروجی را در یک کامپوننت آماده می‌پیچد.

اگر چیزی خودکار قابل تبدیل نباشد، مثل رویدادهای درون‌خطی، هشدار می‌گیرید. تبدیل در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. HTML را بچسبانید

    کد HTML یا SVG را در کادر «کد HTML یا SVG» بگذارید یا «بارگذاری نمونه» را بزنید.

  2. شکل خروجی را انتخاب کنید

    با «خروجی به‌صورت کامپوننت» کد در یک تابع React پیچیده می‌شود؛ نام آن را در «نام کامپوننت» بنویسید که باید با حرف بزرگ لاتین شروع شود.

  3. هشدارها را بخوانید

    اگر بخشی از کد نیاز به بازبینی دستی دارد، فهرست هشدارها نمایش داده می‌شود؛ وگرنه پیام «تبدیل بدون هشدار انجام شد» می‌آید.

  4. خروجی را کپی کنید

    JSX ساخته‌شده را در فایل کامپوننت بگذارید.

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

  • برچسب و فیلد فرم

    for و class و style و readonly تبدیل می‌شوند و چون دو عنصر هم‌سطح‌اند، داخل یک Fragment قرار می‌گیرند.

    <label for="n" class="lbl" style="font-size: 14px; margin-top: 4px">نام</label><input id="n" readonly>

    نتیجه: export default function Component() { return ( <> <label htmlFor="n" className="lbl" style={{ fontSize: "14px", marginTop: "4px" }}>نام</label> <input id="n" readOnly /> </> ); }

  • رویداد درون‌خطی

    onclick به onClick با تابع پیکانی تبدیل می‌شود و ابزار برای بازبینی آن هشدار می‌دهد.

    <button onclick="go()">برو</button>

    نتیجه: <button onClick={() => { go() }}>برو</button> با یک هشدار

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

  • نام کامپوننت با حرف کوچک: React عنصرهایی که با حرف کوچک شروع شوند را برچسب HTML می‌داند. نام را با حرف بزرگ لاتین شروع کنید.
  • پذیرفتن onclick تبدیل‌شده بدون بازبینی: ابزار کد متنی رویداد را داخل یک تابع پیکانی می‌گذارد و هشدار می‌دهد، اما نام تابع باید در کامپوننت واقعاً تعریف شده باشد.
  • آوردن اسکریپت‌های صفحه در JSX: محتوای script به شکل رشته می‌آید و اجرا نمی‌شود. منطق را به کد کامپوننت ببرید.
  • نگه داشتن style درون‌خطی فراوان: پس از تبدیل، سبک‌های تکراری را به کلاس CSS یا کلاس‌های Tailwind منتقل کنید تا کد خواناتر شود.

چرا JSX با HTML فرق دارد؟

JSX شبیه HTML است اما در واقع جاوااسکریپت است. برای همین واژه‌های رزروشده‌ی جاوااسکریپت مثل class و for به className و htmlFor تبدیل شده‌اند و نام ویژگی‌ها به سبک camelCase نوشته می‌شوند. style هم به‌جای متن، شیئی با نام ویژگی‌های camelCase می‌گیرد.

JSX سخت‌گیرتر از HTML است: هر برچسب باید بسته شود و کامپوننت فقط یک عنصر ریشه برمی‌گرداند. Fragment، یعنی <> و </>، چند عنصر هم‌سطح را بدون افزودن عنصر اضافه به صفحه کنار هم نگه می‌دارد.

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

کد HTML من اجرا یا در صفحه درج می‌شود؟
خیر. ورودی فقط به‌صورت متن خوانده و تبدیل می‌شود و هرگز وارد DOM صفحه نمی‌شود؛ پس اسکریپت‌ها و رویدادهای داخل آن اجرا نمی‌شوند.
با رویدادهایی مثل onclick چه می‌شود؟
نام آن‌ها به onClick و مانند آن تبدیل می‌شود و کد رشته‌ای داخل تابع پیکانی قرار می‌گیرد. چون JSX تابع می‌خواهد نه رشته، خروجی را حتماً بازبینی کنید؛ برای هر مورد هشدار نشان داده می‌شود.
چرا value و checked به defaultValue و defaultChecked تبدیل شدند؟
در React مقدار value و checked یعنی فرم کنترل‌شده و بدون onChange هشدار می‌دهد؛ تبدیل به defaultValue و defaultChecked رفتار HTML را بدون state حفظ می‌کند.

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