یک تصویر از دیسک بارگیری کنید
از Image
composable برای نمایش یک گرافیک روی صفحه استفاده کنید. برای بارگیری یک تصویر (به عنوان مثال: PNG، JPEG، WEBP) یا منبع برداری از دیسک، از painterResource
API با مرجع تصویر خود استفاده کنید. نیازی به دانستن نوع دارایی ندارید، فقط از painterResource
در Image
یا paint
Modifiers استفاده کنید.
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 vsus ImageVector را مطالعه کنید.
پشتیبانی قابل کشیدن
painterResource
در حال حاضر از انواع قابل ترسیم زیر پشتیبانی می کند:
-
AnimatedVectorDrawable
-
BitmapDrawable
(PNG، JPG، WEBP) -
ColorDrawable
-
VectorDrawable
یک تصویر را از اینترنت بارگیری کنید
برای بارگیری یک تصویر از اینترنت، چندین کتابخانه شخص ثالث در دسترس هستند که به شما در انجام این فرآیند کمک می کنند. کتابخانه های بارگذاری تصویر کارهای سنگین را برای شما انجام می دهند. آنها هم حافظه پنهان (بنابراین تصویر را چندین بار دانلود نکنید) و هم منطق شبکه را برای دانلود تصویر و نمایش آن روی صفحه انجام می دهند.
به عنوان مثال، برای بارگیری یک تصویر با Coil از Instacart، کتابخانه را به فایل gradle خود اضافه کنید و از AsyncImage
برای بارگیری تصویر از URL استفاده کنید:
AsyncImage( model = "https://example.com/image.jpg", contentDescription = "Translated description of what the image contains" )
برای شما توصیه می شود
- توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود
- منابع در Compose
- قابلیت دسترسی در نوشتن
- گرافیک در Compose