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

امتحان کردن روش Compose

Jetpack Compose جعبه‌ابزار واسط کاربر توصیه‌شده برای Android است. با نحوه افزودن مؤلفه‌ها در Compose آشنا شوید.

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

دکمه کنش شناور (FAB) دکمه‌ای دایره‌ای است که کنش اصلی را در واسط کاربر برنامه شما راه‌اندازی می‌کند. این سند نشان می‌دهد که چگونه یک FAB را به چیدمان خود اضافه کنید، برخی از جنبه‌های ظاهری آن را سفارشی‌سازی کنید، و به ضربه‌ها روی دکمه پاسخ دهید.

برای کسب اطلاعات بیشتر درباره نحوه طراحی FAB برای برنامه‌تان طبق «رهنمودهای طراحی Material»، FAB طراحی Material را ببینید.

شکل ۱. دکمه کنش شناور (FAB).

افزودن دکمه کنش شناور به چیدمان

کد زیر نشان می‌دهد که FloatingActionButton چگونه در فایل چیدمان شما ظاهر می‌شود:

<com.google.android.material.floatingactionbutton.FloatingActionButton
        android:id="@+id/fab"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="end|bottom"
        android:src="@drawable/ic_my_icon"
        android:contentDescription="@string/submit"
        android:layout_margin="16dp" />

به‌طور پیش‌فرض، رنگ «دکمه اقدام شناور» با مشخصه colorAccent تعیین می‌شود که می‌توانید آن را با پالت رنگ زمینه سفارشی‌سازی کنید.

می‌توانید سایر ویژگی‌های FAB را بااستفاده از مشخصه‌های XML یا روش‌های مربوطه پیکربندی کنید، مانند موارد زیر:

• اندازه FAB، بااستفاده از مشخصه app:fabSize یا روش setSize()
• رنگ موجی FAB، بااستفاده از مشخصه app:rippleColor یا روش setRippleColor()
• نماد FAB، بااستفاده از مشخصه android:src یا setImageDrawable() روش

پاسخ دادن به تک‌ضرب‌ها روی دکمه

سپس می‌توانید View.OnClickListener را برای رسیدگی به تک‌ضرب‌های FAB اعمال کنید. برای مثال، کد زیر وقتی کاربر روی FAB تک‌ضرب می‌زند، Snackbar را نمایش می‌دهد:

کاتلین

val fab: View = findViewById(R.id.fab)
fab.setOnClickListener { view ->
    Snackbar.make(view, "Here's a Snackbar", Snackbar.LENGTH_LONG)
            .setAction("Action", null)
            .show()
}

جاوا

FloatingActionButton fab = findViewById(R.id.fab);
fab.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        Snackbar.make(view, "Here's a Snackbar", Snackbar.LENGTH_LONG)
                .setAction("Action", null).show();
    }
});

برای اطلاعات بیشتر درباره قابلیت‌های FAB، مرجع میانای برنامه‌سازی کاربردی را برای FloatingActionButton ببینید.