بار کردن تصویر از دیسک
از ترکیبپذیر Image برای نمایش گرافیک روی صفحه استفاده کنید. برای بار کردن تصویر (برای مثال: PNG، JPEG، WEBP) یا منبع برداری از دیسک، از میانای برنامهسازی کاربردی painterResource با مرجع تصویرتان استفاده کنید. نیازی نیست نوع دارایی را بدانید، فقط از اصلاحکنندههای 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() برای بار کردن Bitmap استفاده کنید. برای اطلاعات بیشتر درباره
ImageBitmaps، بخش ImageBitmap درمقابل ImageVector را بخوانید.
پشتیبانی از Drawable
painterResource از انواع قابلترسیم زیر پشتیبانی میکند:
AnimatedVectorDrawableBitmapDrawable(PNG، JPG، WEBP)ColorDrawableVectorDrawable
بار کردن تصویر از اینترنت
برای بار کردن تصویر از اینترنت، چندین کتابخانه طرف سوم برای کمک به شما در مدیریت این فرایند دردسترس است. کتابخانههای بار کردن تصویر کارهای سنگین زیادی را برای شما انجام میدهند؛ آنها هم حافظه پنهان (تا تصویر را چندین بار بارگیری نکنید) و هم منطق شبکه را برای بارگیری تصویر و نمایش آن روی صفحه مدیریت میکنند.
برای مثال، برای بار کردن تصویر با Coil
از Instacart، کتابخانه را به فایل gradle خود اضافه کنید و از AsyncImage برای بار کردن تصویر از نشانی وب استفاده کنید:
AsyncImage( model = "https://example.com/image.jpg", contentDescription = "Translated description of what the image contains" )
سیمپیچ
کتابخانه بار کردن تصویر با پشتیبانی «روالهای مشترک Kotlin» (Instacart).
لغزاندن
کتابخانه بارگیری تصویر سریع و کارآمد برای Android با تمرکز بر پیمایش روان (Google).
منابع بیشتر
توصیهشده برای شما
- توجه: وقتی جاوا اسکریپت خاموش باشد، نوشتار پیوند نمایش داده میشود
- منابع در Compose
- دسترسپذیری در Compose
- گرافیک در Compose