قابلیت دسترسی در Jetpack Compose

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

مفاهیم کلیدی

  • معناشناسی: سیستم نمایش معنای عناصر UI برای خدمات دسترسی. این شامل ویژگی هایی مانند توضیحات، وضعیت ها و اقداماتی است که کاربر می تواند انجام دهد.

  • پیمایش: ترتیبی که سرویس‌های دسترس‌پذیری مانند TalkBack در عناصر روی صفحه پیمایش می‌کنند. برای تجربه کاربری بهتر می توانید این سفارش را سفارشی کنید.

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

شروع کنید

اساس مدل دسترسی و ابزارهای Compose معناشناسی است. برای اطلاعات بیشتر به راهنمای Semantics in Compose مراجعه کنید.

هنگام توسعه برنامه خود، از ابتدا این مراحل کلیدی را برای بهبود دسترسی به برنامه Compose خود در نظر داشته باشید:

  • حداقل اندازه های هدف لمسی را در نظر بگیرید : مطمئن شوید که عناصر قابل کلیک و تعاملی حداقل 48dp هستند. این به دستورالعمل‌های دسترسی طراحی مواد پایبند است.
  • افزودن برچسب‌های کلیک : اگر دسترسی مستقیم به clickable ندارید، رفتار کلیک را با اصلاح‌کننده clickable یا اصلاح‌کننده semantics توصیف کنید.
  • عناصر بصری را توصیف کنید : از پارامتر contentDescription برای توصیف متنی نمادها و تصاویر استفاده کنید. contentDescription برای عناصر تزئینی روی null قرار دهید.
  • تعریف سرفصل ها : از خاصیت تعدیل کننده semantics برای علامت گذاری عناصر به عنوان سرفصل برای پیمایش آسان تر استفاده کنید.
  • ترتیب پیمایش را کنترل کنید : از isTraversalGroup برای علامت گذاری گروه هایی از عناصری که باید با هم خوانده شوند استفاده کنید. از traversalIndex برای سفارشی کردن بیشتر ترتیب عناصر در آن گروه ها استفاده کنید.

برای اطلاعات بیشتر، مراحل کلیدی اختصاصی برای بهبود راهنمای دسترس‌پذیری Compose را ببینید.

ابزار

  • TalkBack : صفحه‌خوان Google برای Android. آن را فعال کنید تا نحوه عملکرد معنایی برنامه شما را برای کاربرانی که به فناوری های کمکی تکیه می کنند، آزمایش کنید.
  • Layout Inspector : درخت معنایی برنامه خود را تجسم و اشکال زدایی کنید.
  • APIهای تست نوشتن : تست‌هایی بنویسید که با عناصر معنایی تعامل دارند تا دسترسی به رابط‌های کاربری Compose شما را تأیید کنند.

Codelab

برای کسب اطلاعات بیشتر در مورد پشتیبانی از قابلیت دسترسی در کد نوشتن، از Accessibility in Jetpack Compose Codelab استفاده کنید.

منابع اضافی