درحال بار کردن تصاویر

بار کردن تصویر از دیسک

از عنصر ترکیبی Image برای نمایش گرافیک روی صفحه استفاده کنید. برای بار کردن تصویر (برای نمونه: PNG،‏ JPEG،‏ WEBP) یا منبع برداری از دیسک، از painterResource API با مرجع تصویرتان استفاده کنید. لازم نیست نوع دارایی را بدانید، کافی است از painterResource در Image یا paint اصلاح‌کننده استفاده کنید.

DrawScope:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description)
)

برای اطمینان از اینکه برنامه‌تان قابل‌دسترس است، contentDescription برای عناصر دیداری روی صفحه ارائه دهید. ‫TalkBack شرح محتوا را بلند می‌خواند، بنابراین باید مطمئن شوید که نوشتار درصورت بلند خوانده شدن و ترجمه شدن معنی‌دار باشد. در مثال قبلی، از stringResource() برای بار کردن شرح محتوای ترجمه‌شده از فایل strings.xml استفاده شده است. اگر عنصر دیداری شما در صفحه صرفاً برای تزئین دیداری است، contentDescription را روی null تنظیم کنید تا صفحه‌خوان آن را نادیده بگیرد.

اگر به عملکرد ویژه ImageBitmap سطح پایین‌تری نیاز دارید، می‌توانید از ImageBitmap.imageResource() برای بار کردن «بیت‌مپ» استفاده کنید. برای کسب اطلاعات بیشتر درباره ImageBitmaps، بخش ImageBitmap دربرابر ImageVector را بخوانید.

پشتیبانی از «کشیدنی»

‫painterResource از انواع طراحی زیر پشتیبانی می‌کند:

بار کردن تصویر از اینترنت

برای بار کردن تصویر از اینترنت، چندین کتابخانه طرف سوم دردسترس است که به شما کمک می‌کند این فرایند را مدیریت کنید. کتابخانه‌های بارگیری تصویر بسیاری از کارهای سنگین را برای شما انجام می‌دهند؛ آن‌ها هم منطق شبکه‌سازی را برای بارگیری تصویر و نمایش آن روی صفحه و هم ذخیره در حافظه نهان را مدیریت می‌کنند (تا تصویر را چند بار بارگیری نکنید).

برای مثال، برای بار کردن تصویر با Coil از Instacart، کتابخانه را به فایل gradle اضافه کنید و از AsyncImage برای بار کردن تصویر از نشانی وب استفاده کنید:

AsyncImage(
    model = "https://example.com/image.jpg",
    contentDescription = "Translated description of what the image contains"
)

کتابخانه بارگیری تصویر با پشتیبانی «روال‌های مشترک Kotlin» ‏ (Instacart).

کتابخانه بارگیری تصویر سریع و کارآمد برای Android که بر پیمایش روان تمرکز دارد (Google).

منابع بیشتر