Resimler yükleniyor
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Diskten resim yükleme
Ekranda grafik göstermek için Image composable'ını kullanın. Diskten bir resim (ör. PNG, JPEG, WEBP) veya vektör kaynağı yüklemek için resim referansınızla birlikte painterResource API'sini kullanın. Öğenin türünü bilmeniz gerekmez. Yalnızca Image veya paint değiştiricilerinde painterResource kullanın.
DrawScope:
Image(
painter = painterResource(id = R.drawable.dog),
contentDescription = stringResource(id = R.string.dog_content_description)
)
Uygulamanızın erişilebilir olmasını sağlamak için ekrandaki görsel öğeler için contentDescription sağlayın. TalkBack, içerik açıklamasını okur. Bu nedenle, metnin sesli okunduğunda ve çevrildiğinde anlamlı olduğundan emin olmanız gerekir. Yukarıdaki örnekte, strings.xml dosyasından çevrilmiş içerik açıklamasını yüklemek için stringResource() kullanılıyor. Ekranda yer alan görsel öğeniz yalnızca görsel amaçlıysa ekran okuyucunun yoksayması için contentDescription öğenizi null olarak ayarlayın.
Daha düşük düzeyde ImageBitmap işlevselliğe ihtiyacınız varsa bit eşlem yüklemek için ImageBitmap.imageResource() kullanabilirsiniz. ImageBitmap'ler hakkında daha fazla bilgi için ImageBitmap ve ImageVector karşılaştırması bölümünü okuyun.
Çizilebilir destek
painterResource şu anda aşağıdaki çizilebilir türlerini desteklemektedir:
İnternetten resim yükleme
İnternetten bir resim yüklemek için süreci yönetmenize yardımcı olacak çeşitli üçüncü taraf kitaplıkları vardır. Resim yükleme kitaplıkları, sizin için birçok zorlu görevi üstlenir. Hem önbelleğe alma (böylece resmi birden çok kez indirmezsiniz) hem de resmi indirip ekranda göstermek için ağ oluşturma mantığını yönetir.
Örneğin, Instacart'tan Coil ile bir resim yüklemek için kitaplığı gradle dosyanıza ekleyin ve URL'den resim yüklemek için AsyncImage kullanın:
AsyncImage(
model = "https://example.com/image.jpg",
contentDescription = "Translated description of what the image contains"
)
Bobin
Kotlin Coroutines tarafından desteklenen bir resim yükleme kitaplığı (Instacart).
Glide
Android için hızlı ve verimli bir resim yükleme kitaplığıdır. Sorunsuz kaydırmaya odaklanır (Google).
Ek kaynaklar
Sizin için önerilenler
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-25 UTC."],[],[],null,["Load an image from the disk\n\nUse the [`Image`](/reference/kotlin/androidx/compose/foundation/package-summary#Image) composable to display a graphic on screen. To load an image\n(for example: PNG, JPEG, WEBP) or vector resource from the disk, use the\n[`painterResource`](/develop/ui/compose/quick-guides/content/load-images?hl=en) API with your image reference. You don't need to know the type\nof the asset, just use `painterResource` in `Image` or `paint` modifiers.\n\n`DrawScope`:\n\n\n```kotlin\nImage(\n painter = painterResource(id = R.drawable.dog),\n contentDescription = stringResource(id = R.string.dog_content_description)\n)https://github.com/android/snippets/blob/5673ffc60b614daf028ee936227128eb8c4f9781/compose/snippets/src/main/java/com/example/compose/snippets/images/LoadingImagesSnippets.kt#L49-L52\n```\n\n\u003cbr /\u003e\n\nTo ensure that your app is [accessible](/develop/ui/compose/accessibility), supply a `contentDescription` for\nvisual elements on screen. TalkBack reads out the content description, so you\nmust ensure that the text is meaningful if read out loud and translated. In the\nabove example, a `stringResource()` is used to load up the translated content\ndescription from the `strings.xml` file. If your visual element on screen is\npurely for visual decoration, set your `contentDescription` to `null` for the\nscreen reader to ignore it.\n\nIf you need lower-level `ImageBitmap` specific functionality, you can use\n`ImageBitmap.imageResource()` to load up a Bitmap. For more information on\nImageBitmaps, read the [ImageBitmap versus ImageVector](/develop/ui/compose/graphics/images/compare) section.\n\nDrawable support\n\n`painterResource` currently supports the following drawable types:\n\n- [`AnimatedVectorDrawable`](/reference/android/graphics/drawable/AnimatedVectorDrawable)\n- [`BitmapDrawable`](/reference/android/graphics/drawable/BitmapDrawable) (PNG, JPG, WEBP)\n- [`ColorDrawable`](/reference/android/graphics/drawable/ColorDrawable)\n- [`VectorDrawable`](/reference/android/graphics/drawable/VectorDrawable)\n\nLoad an image from the internet\n\nTo load an image from the internet, there are several third-party libraries\navailable to help you handle the process. Image loading libraries do a lot of\nthe heavy lifting for you; they handle both caching (so you don't download the\nimage multiple times) and networking logic to download the image and display it\non screen.\n\nFor example, to load an image with [Coil](https://github.com/coil-kt/coil#jetpack-compose)\nfrom Instacart, add the library to your gradle file, and use an `AsyncImage` to load an image from a URL:\n\n\n```kotlin\nAsyncImage(\n model = \"https://example.com/image.jpg\",\n contentDescription = \"Translated description of what the image contains\"\n)https://github.com/android/snippets/blob/5673ffc60b614daf028ee936227128eb8c4f9781/compose/snippets/src/main/java/com/example/compose/snippets/images/LoadingImagesSnippets.kt#L60-L63\n```\n\n\u003cbr /\u003e\n\n[Coil](https://github.com/coil-kt/coil#jetpack-compose)\n\nAn image loading library backed by Kotlin Coroutines (Instacart). \n[](https://search.maven.org/artifact/io.coil-kt/coil-compose \"Maven version of the library\") \n[Glide](https://bumptech.github.io/glide/int/compose.html)\n\nA fast and efficient image loading library for Android focused on smooth scrolling (Google). \n[](https://search.maven.org/artifact/com.github.bumptech.glide/compose \"Maven version of the library\")\n\nAdditional resources\n\n- [Load and display images](/develop/ui/compose/quick-guides/content/load-images?hl=en)\n\nRecommended for you\n\n- Note: link text is displayed when JavaScript is off\n- [Resources in Compose](/develop/ui/compose/resources)\n- [Accessibility in Compose](/develop/ui/compose/accessibility)\n- [Graphics in Compose](/develop/ui/compose/graphics/draw/overview)"]]
