این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

در حال بارگذاری تصاویر

بارگذاری تصویر از دیسک

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

DrawScope :

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

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

اگر به قابلیت‌های خاص ImageBitmap سطح پایین‌تر نیاز دارید، می‌توانید از ImageBitmap.imageResource() برای بارگذاری یک Bitmap استفاده کنید. برای اطلاعات بیشتر در مورد ImageBitmapها، بخش ImageBitmap در مقابل ImageVector را مطالعه کنید.

پشتیبانی قابل ترسیم

painterResource در حال حاضر از انواع ترسیمی زیر پشتیبانی می‌کند:

بارگذاری تصویر از اینترنت

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

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

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