Coil یک کتابخانه‌ی قدرتمند برای نمایش تصاویر در اندروید است که بازهم توسعه یافته توسط Square. در Jetpack Compose، از Coil می‌توانید برای نمایش تصاویر در کامپوننت‌های Image استفاده کنید.

برای استفاده از Coil در Jetpack Compose، ابتدا به فایل build.gradle ماژول خود این خط را اضافه کنید:

implementation "io.coil-kt:coil-compose:1.4.0"

حالا، برای استفاده از Coil در یک Composable، از rememberImagePainter استفاده می‌شود. مثال زیر یک Composable ساده نشان می‌دهد که یک تصویر از یک URL را نمایش می‌دهد:

import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.res.painterResource
import coil.compose.rememberImagePainter
import coil.transform.CircleCropTransformation

@Composable
fun CoilImageExample() {
    val imageUrl = "https://example.com/image.jpg"

    Image(
        painter = rememberImagePainter(
            data = imageUrl,
            builder = {
                crossfade(true) // افزودن انتقال نرم بین تصاویر جدید و قدیمی
                placeholder(R.drawable.placeholder) // تصویر پیش‌فرض قبل از بارگذاری
                error(R.drawable.error) // تصویر نمایش داده شده در صورت بروز خطا
                transformations(CircleCropTransformation()) // تبدیل تصویر به یک دایره
            }
        ),
        contentDescription = null, // متن توصیف تصویر برای افراد نابینا
        modifier = Modifier.fillMaxSize()
    )
}

• در این مثال:
• rememberImagePainter از Coil برای مدیریت تصاویر استفاده می‌شود.
• crossfade(true) باعث ایجاد انتقال نرم بین تصاویر جدید و قدیمی می‌شود.
• placeholder تصویری است که قبل از بارگذاری تصویر نمایش داده می‌شود.
• error تصویری است که در صورت بروز خطا نمایش داده می‌شود.
• transformations از CircleCropTransformation برای تبدیل تصویر به یک دایره استفاده شده است.

برای استفاده از این Composable در برنامه‌ی شما، کافی است آن را به عنوان یک کامپوننت معمولی در یک جایی از کد Compose خود فراخوانی کنید، مانند:

CoilImageExample()