بار کردن تصویر از دیسک
از عنصر ترکیبی 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 از انواع طراحی زیر پشتیبانی میکند:
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