بار کردن تصویر از دیسک
از ترکیبپذیر 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).
Glide
کتابخانه بارگیری تصویر سریع و کارآمد برای Android با تمرکز بر پیمایش روان (Google).
منابع بیشتر
توصیهشده برای شما
- توجه: وقتی جاوا اسکریپت خاموش باشد، نوشتار پیوند نمایش داده میشود
- منابع در Compose
- دسترسپذیری در Compose
- گرافیک در Compose