کانونی کردن در Compose

وقتی کاربران با برنامه شما تعامل برقرار می‌کنند، اغلب این کار را بااستفاده از سازوکارهای ورودی غیرلمسی انجام می‌دهند:

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

در همه این سناریوها، برنامه‌تان باید ردیابی کند کدام عنصر تعاملی در صفحه فعال است—این حالت فعال تمرکز نامیده می‌شود.

عوامل کلیدی برای پیمایش حسی با صفحه‌کلید

برای ارائه تجربه کاربری عالی در صفحه‌نمایش‌های بزرگ و دستگاه‌های غیرلمسی، برنامه‌تان را با اصول زیر طراحی کنید:

  1. تمرکز اولیه منطقی: تمرکز اولیه را روی عنصری قرار دهید که کاربران به‌احتمال زیاد هنگام ورود به صفحه با آن تعامل خواهند داشت.
  2. ترتیب پیمایش ثابت: پیمایش تمرکز یک‌بعدی (Tab) و دوبعدی (کلیدهای جهت‌نما یا پد کنترل) قابل‌پیش‌بینی ارائه دهید.
  3. تمرکز پایدار: تمرکز را به‌طور یکپارچه پس‌از وقفه‌ها، بستن کادرهای گفتگو، یا تغییرات پیکربندی بازیابی کنید.
  4. حالت تمرکز واضح: نشانه‌های دیداری برجسته و دردسترس (مانند حلقه‌های تمرکز یا موج‌ها) را نمایش دهید تا مشخص شود کدام عنصر درحال‌حاضر متمرکز است.
  5. پیمایش بصری: مطمئن شوید عنصر دارای تمرکز و بافت اطراف آن به‌آرامی در نمای قابل‌مشاهده پیمایش می‌شوند.

راهنماهای تمرکز

برای آشنایی با نحوه مدیریت و سفارشی‌سازی تمرکز در Compose، راهنماهای زیر را کاوش کنید:

  • هدف‌های تمرکز: با نحوه تبدیل شدن مؤلفه‌های تعاملی به هدف‌های تمرکز و نحوه تمرکزپذیر کردن ترکیب‌شدنی‌های سفارشی آشنا شوید.
  • ترتیب پیمایش تمرکز: با ترتیب ظاهر شدن یک‌بعدی و پیمایش فضایی دوبعدی و نحوه سفارشی‌سازی مسیرهای پیمایش آشنا شوید.
  • تمرکز در فیلدهای نوشتاری: با نحوه مدیریت کلیدهای جهت‌نما و Tab در فیلدهای نوشتاری تک‌خطی و چندخطی و نحوه عملکرد تعامل IME تلویزیون آشنا شوید.
  • هدف‌های تمرکز گروه: مؤلفه‌های گروه با focusGroup و رهگیری تغییرمسیر ورود یا خروج.
  • بازیابی تمرکز: بازیابی تمرکز به فرزندان فعال قبلی در محفظه‌ها، مدیریت مؤلفه‌های پیمایش، و مدیریت تمرکز در سراسر انتقال‌های صفحه.
  • نشان دادن وضعیت تمرکز: برای برجسته کردن مؤلفه‌های متمرکزشده، از نشانه‌های دیداری و نشانگرهای سفارشی استفاده کنید.
  • واکنش به فوکوس: تغییرات فوکوس را مشاهده کنید و ویژگی‌های وضعیت فوکوس را بااستفاده از onFocusChanged پُرسمان کنید.
  • درخواست تمرکز به‌صورت برنامه‌نویسی‌شده: تمرکز را به‌طور صریح در پاسخ به کنش‌های کاربر یا خطاهای اعتبارسنجی جابه‌جا کنید.
  • انتقال و پاک کردن تمرکز: بااستفاده از FocusManager، تمرکز را به‌صورت برنامه‌نویسی‌شده جلو ببرید یا پاک کنید.
  • گرفتن و رها کردن تمرکز: گرفتن تمرکز برای تعامل‌های فرعی مدال و رها کردن ایمن آن.
  • آزمایش پیمایش تمرکز: آزمایش‌های خودکار Compose را برای تأیید تعاملات صفحه‌کلید یک‌بعدی، دوبعدی، و فیلد نوشتار بنویسید.