دکمه کنش شناور

دکمه کنش شناور (FAB) دکمه‌ای با تأکید بالا است که به کاربر امکان می‌دهد کنش اصلی را در برنامه انجام دهد. این دکمه یک کنش واحد و متمرکز را ترویج می‌کند که رایج‌ترین مسیری است که کاربر ممکن است طی کند و معمولاً در پایین سمت راست صفحه ثابت شده است.

این سه مورد استفاده را که ممکن است در آن‌ها از FAB استفاده کنید درنظر بگیرید:

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

در «طراحی مواد»، چهار نوع دکمه کنش شناور وجود دارد:

  • دکمه کنش شناور: دکمه کنش شناور با اندازه معمولی.
  • دکمه کنش شناور کوچک: دکمه کنش شناور کوچک‌تر.
  • دکمه کنش شناور بزرگ: دکمه کنش شناور بزرگ‌تر.
  • دکمه کنش شناور گسترده: دکمه کنش شناوری که علاوه‌بر نماد، حاوی موارد دیگری نیز هست.
نمونه‌ای از هریک از چهار مؤلفه دکمه کنش شناور.
شکل ۱. چهار نوع دکمه کنش شناور.

سطح میانای برنامه‌سازی کاربردی

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

  • onClick: تابعی که وقتی کاربر دکمه را فشار می‌دهد فراخوانده می‌شود.
  • containerColor: رنگ دکمه.
  • ‫contentColor: رنگ نماد.

دکمه کنش شناور

برای ایجاد دکمه کنش شناور عمومی، از ترکیب‌پذیر پایه FloatingActionButton استفاده کنید. مثال زیر پیاده‌سازی پایه FAB را نشان می‌دهد:

@Composable
fun Example(onClick: () -> Unit) {
    FloatingActionButton(
        onClick = { onClick() },
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Floating action button.")
    }
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود:

شکل ۲. دکمه کنش شناور.

دکمه کوچک

برای ایجاد دکمه کنش شناور کوچک، از ترکیب‌پذیر SmallFloatingActionButton استفاده کنید. مثال زیر نشان می‌دهد که چگونه این کار را انجام دهید، با افزودن رنگ‌های سفارشی.

@Composable
fun SmallExample(onClick: () -> Unit) {
    SmallFloatingActionButton(
        onClick = { onClick() },
        containerColor = MaterialTheme.colorScheme.secondaryContainer,
        contentColor = MaterialTheme.colorScheme.secondary
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Small floating action button.")
    }
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود:

شکل ۳. دکمه کنش شناور کوچک.

دکمه بزرگ

برای ایجاد دکمه کنش شناور بزرگ، از LargeFloatingActionButton composable استفاده کنید. این composable تفاوت چندانی با نمونه‌های دیگر ندارد، به‌جز اینکه دکمه بزرگ‌تری ایجاد می‌کند.

در زیر پیاده‌سازی ساده‌ای از «دکمه شناور کنش» بزرگ ارائه شده است.

@Composable
fun LargeExample(onClick: () -> Unit) {
    LargeFloatingActionButton(
        onClick = { onClick() },
        shape = CircleShape,
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.Add), "Large floating action button")
    }
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود:

شکل ۴. دکمه کنش شناور بزرگ.

دکمه گسترش‌یافته

با ترکیب‌پذیر ExtendedFloatingActionButton می‌توانید دکمه‌های کنش شناور پیچیده‌تری ایجاد کنید. تفاوت اصلی بین آن و FloatingActionButton این است که پارامترهای اختصاصی icon و text دارد. این دکمه‌ها به شما امکان می‌دهند دکمه‌ای با محتوای پیچیده‌تر ایجاد کنید که به‌طور مناسب با محتوایش مقیاس‌بندی می‌شود.

قطعه کد زیر نحوه پیاده‌سازی ExtendedFloatingActionButton را با مقادیر نمونه ارسال‌شده برای icon و text نشان می‌دهد.

@Composable
fun ExtendedExample(onClick: () -> Unit) {
    ExtendedFloatingActionButton(
        onClick = { onClick() },
        icon = { Icon(painter = rememberVectorPainter(AppIcons.Edit), "Extended floating action button.") },
        text = { Text(text = "Extended FAB") },
    )
}

این پیاده‌سازی به‌صورت زیر نشان داده می‌شود:

شکل ۵. دکمه کنش شناور با نوشتار و نماد.

به‌روزرسانی M3 Expressive

«دکمه شناور اقدام» اندازه‌های دیگری را برای مطابقت با «دکمه شناور اقدام» گسترش‌یافته و گزینه‌های رنگ گسترش‌یافته ارائه می‌دهد، ازجمله MediumFloatingActionButton که برای اکثر موقعیت‌ها درکنار اندازه‌های موجود «دکمه شناور اقدام» توصیه می‌شود.

دکمه‌های کنش شناور با انواع رنگ و اندازه رسا.
شکل ۶.‏ انواع رنگ و اندازه دکمه کنش شناور Material 3 Expressive.

برای اطلاعات بیشتر درباره به‌روزرسانی‌های M3 Expressive برای دکمه‌های کنش شناور، به رهنمودهای دکمه کنش شناور Material Design 3 مراجعه کنید.

دکمه کنش شناور متوسط

دکمه کنش شناور متوسط برای اکثر موقعیت‌ها توصیه می‌شود و در پنجره‌های فشرده و متوسط بهترین عملکرد را دارد. از آن برای کنش‌های مهم بدون اشغال فضای زیاد استفاده کنید.

تکه‌کد زیر نحوه پیاده‌سازی دکمه کنش شناور متوسط را بااستفاده از MediumFloatingActionButton نشان می‌دهد:

@Composable
fun MediumFloatingActionButtonSample() {
    MediumFloatingActionButton(onClick = {}) {
        Icon(
            painter = rememberVectorPainter(AppIcons.Add),
            contentDescription = "Add",
            modifier = Modifier.size(FloatingActionButtonDefaults.MediumIconSize),
        )
    }
}

منابع بیشتر