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

دسترس‌پذیری وب برای سایت‌های فارسی؛ از کجا شروع کنیم

دسترس‌پذیری وب به زبان ساده: کنتراست رنگ، صفحه‌کلید و فوکوس، برچسب فرم، صفحه‌خوان فارسی و lang، و یک فهرست بازبینی کوتاه بر اساس WCAG 2.2.

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

کاشی‌های بنفش با آیکون دسترس‌پذیری، نماد وب برای همه

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

خبر خوب این است که بیشتر کار با چند عادت ساده انجام می‌شود. این مقاله آن عادت‌ها را به ترتیب اهمیت می‌گوید.

۱. زبان و جهت صفحه

صفحه‌خوان‌ها (مثل NVDA در ویندوز و VoiceOver در مک و آیفون) از ویژگی lang می‌فهمند متن را با چه صدایی بخوانند. بدون lang="fa"، متن فارسی ممکن است با تلفظ انگلیسی یا اصلاً خوانده نشود.

<html lang="fa" dir="rtl">
…
<p>پکیج <span lang="en">React</span> را نصب کنید.</p>

برای تکه‌های انگلیسی طولانی وسط متن فارسی هم lang="en" بگذارید.

۲. کنتراست رنگ

متن کم‌رنگ روی زمینهٔ روشن، رایج‌ترین مشکل دسترس‌پذیری در سایت‌هاست. معیار WCAG برای سطح AA:

  • متن معمولی: نسبت کنتراست دست‌کم ۴٫۵ به ۱
  • متن بزرگ (حدود ۲۴ پیکسل، یا ۱۸٫۵ پیکسل ضخیم): دست‌کم ۳ به ۱
  • اجزای رابط مثل لبهٔ فیلد و آیکون‌های معنادار: دست‌کم ۳ به ۱
سه نمونه متن خاکستری روی زمینهٔ سفید با کنتراست ۱٫۷، ۴٫۸ و ۱۴٫۷ به ۱؛ اولی رد و دو تای دیگر قبول
خاکستری‌های خیلی روشن، حتی اگر شیک به نظر برسند، برای خیلی‌ها خوانا نیستند.

حروف فارسی نازک‌تر و دندانه‌دارتر از لاتین هم‌اندازه‌اند؛ پس در فارسی بهتر است کمی بالاتر از حداقل بمانید. ابزار بررسی کنتراست در DevTools مرورگرها همین نسبت را نشان می‌دهد.

۳. همه‌چیز با صفحه‌کلید

یک آزمایش ساده: موس را کنار بگذارید و فقط با Tab، Shift+Tab، Enter، Space و کلیدهای جهت از سایتتان استفاده کنید.

فرم ورود با حلقهٔ فوکوس واضح روی فیلد ایمیل در مقابل فرمی که فوکوس در آن دیده نمی‌شود
حلقهٔ فوکوس به کاربر صفحه‌کلید می‌گوید کجاست؛ حذفش مثل پنهان کردن نشانگر موس است.
  • فوکوس همیشه دیده شود. outline: none بدون جایگزین، رایج‌ترین خطاست. اگر ظاهر پیش‌فرض را دوست ندارید، یک حلقهٔ فوکوس با کنتراست کافی طراحی کنید و از :focus-visible استفاده کنید تا فقط برای صفحه‌کلید ظاهر شود.
  • ترتیب تب منطقی باشد. ترتیب HTML را با ترتیب دیداری یکی نگه دارید و از tabindex مثبت دوری کنید.
  • از عنصر درست استفاده کنید. چیزی که کلیک می‌شود و کاری انجام می‌دهد <button> است، نه <div onclick>. دکمهٔ واقعی خودش فوکوس می‌گیرد و با Enter و Space کار می‌کند.
  • دیالوگ‌ها فوکوس را نگه دارند و با Escape بسته شوند، و بعد از بسته شدن فوکوس به دکمه‌ای برگردد که دیالوگ را باز کرده بود.

۴. فرم‌ها: برچسب، راهنما، خطا

فیلد شماره موبایل با برچسب، راهنما و پیام خطا که با aria-describedby به فیلد وصل شده‌اند، همراه با کد HTML
برچسب و پیام خطا باید از نظر کد هم به فیلد وصل باشند تا صفحه‌خوان آن‌ها را بخواند.
  • هر فیلد برچسب واقعی دارد: <label for>، نه فقط متن داخل فیلد. متن placeholder با تایپ اول ناپدید می‌شود و جای برچسب را نمی‌گیرد.
  • راهنما و خطا با aria-describedby به فیلد وصل شوند.
  • فیلد نامعتبر aria-invalid="true" بگیرد و خطا فقط با رنگ قرمز نشان داده نشود؛ متن و آیکون هم لازم است.
  • پیام خطا بگوید چه باید کرد، نه فقط «نامعتبر». دربارهٔ نوشتن پیام خطا مقالهٔ جداگانه‌ای داریم.
<label for="mobile">شماره موبایل</label>
<input id="mobile" inputmode="tel" aria-invalid="true" aria-describedby="mobile-err">
<p id="mobile-err">شماره موبایل باید ۱۱ رقم باشد و با ۰۹ شروع شود.</p>

۵. تصویر و آیکون

  • تصویرهای معنادار متن جایگزین (alt) دارند که بگوید تصویر چه می‌رساند، نه اینکه «عکس» است.
  • تصویرهای تزئینی alt="" می‌گیرند تا صفحه‌خوان از آن‌ها رد شود.
  • دکمه‌ای که فقط آیکون دارد (مثل ضربدر بستن)، aria-label می‌خواهد: aria-label="بستن".

۶. حرکت و انیمیشن

بعضی کاربران با انیمیشن‌های بزرگ سرگیجه می‌گیرند. سیستم‌عامل‌ها گزینهٔ «کاهش حرکت» دارند و CSS می‌تواند به آن احترام بگذارد:

@media (prefers-reduced-motion: reduce) {
  * { animation-duration: 0.01ms !important; transition-duration: 0.01ms !important; }
}

فهرست بازبینی سریع

  1. lang="fa" و dir="rtl" روی html.
  2. کنتراست متن دست‌کم ۴٫۵ به ۱.
  3. همهٔ کارها با صفحه‌کلید و فوکوس همیشه دیده شود.
  4. هر فیلد برچسب واقعی دارد و خطاها متنی و وصل‌شده‌اند.
  5. تصویرها alt مناسب دارند و دکمه‌های آیکونی aria-label.
  6. صفحه با بزرگ‌نمایی ۲۰۰٪ هنوز قابل‌استفاده است.
  7. یک بار با صفحه‌خوان (NVDA رایگان است) صفحهٔ اصلی و یک فرم را امتحان کرده‌اید.

جمع‌بندی

دسترس‌پذیری پروژهٔ جدایی نیست؛ مجموعه‌ای از عادت‌هاست که اگر از اول رعایت شود، تقریباً هزینه‌ای ندارد. اگر از کامپوننت‌های آماده استفاده می‌کنید، مطمئن شوید آن‌ها این‌ها را رعایت کرده‌اند. همهٔ کامپوننت‌های کاشی برای سطح WCAG 2.2 AA ساخته و تست شده‌اند؛ جزئیات را در صفحهٔ دسترس‌پذیری ببینید.