دکمه‌های آیکون در Jetpack Compose Glimmer

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

در Jetpack Compose Glimmer، یک IconButton یک کامپوننت فشرده و تعاملی است که برای نمایش اقدامات تکمیلی با یک ضربه استفاده می‌شود.

دکمه‌های آیکون کوچک‌تر از دکمه‌های استاندارد به نظر می‌رسند، اما یک مرز فیزیکی را حفظ می‌کنند تا سهولت تعامل روی عینک‌های نمایشگر تضمین شود.

برای موارد استفاده دیگر، دکمه‌های استاندارد و دکمه‌های تغییر وضعیت نیز وجود دارد.

نمونه‌ای از سبک‌های مختلف دکمه‌های آیکون در Jetpack Compose Glimmer. این مثال‌ها پنج حالت دکمه آیکون را نشان می‌دهند: فعال (1)، متمرکز (2)، فشرده (3)، غیرفعال (4)، غیرفعال و متمرکز (5).

اندازه‌ها و ابعاد

عنصر ابعاد

حداقل اندازه ظرف

۴۸ در ۴۸ پیکسل

اندازه آیکون داخلی

۳۲ در ۳۲ پیکسل

فاصله‌گذاری پیش‌فرض محتوا

GlimmerTheme.componentSpacingValues.small

ایالت‌ها

دکمه‌های آیکون در Jetpack Compose Glimmer ظاهر خود را برای نشان دادن وضعیتشان تغییر می‌دهند.

  • فعال : حالت تعاملی پیش‌فرض.
  • متمرکز (Focused ): GlimmerTheme.depthEffectLevels.level1 و یک هایلایت حاشیه‌ای متمرکز را اعمال می‌کند.
  • فشرده شده : یک پوشش سفید نیمه شفاف روی سطح اعمال می‌کند.
  • غیرفعال : دکمه غیرتعاملی است و بازخورد بصری حذف شده است.

پیش‌فرض‌های دکمه آیکون

پیش‌فرض‌های زیر برای دکمه‌های آیکون اعمال می‌شوند:

  • شکل : به صورت پیش‌فرض روی GlimmerTheme.shapes.large (معمولاً دایره‌ای) تنظیم شده است.
  • رنگ : مقدار پیش‌فرض GlimmerTheme.colors.surface است.
  • رنگ محتوا : به طور خودکار از رنگ پس زمینه محاسبه می‌شود، مگر اینکه صریحاً ارائه شود.
  • فاصله‌گذاری محتوا : فاصله پیش‌فرض بین آیکون و لبه کانتینر را تعیین می‌کند.
  • حداقل اندازه : یک مقدار ثابت 48.dp برای جلوگیری از کوچک شدن بیش از حد دکمه‌ها برای تعامل.
  • اندازه آیکون : به طور پیش‌فرض روی GlimmerTheme.iconSizes.small ( 32.dp ) تنظیم شده است.

مثال: دکمه آیکون

کد زیر یک دکمه آیکون با ویژگی‌های پیش‌فرض ایجاد می‌کند:

@Composable
fun IconButtonSample() {
    IconButton(onClick = {}) { Icon(FavoriteIcon, "Localized description") }
}