載入圖片

從磁碟載入圖片

使用 Image 可組合項在螢幕上顯示圖像。載入圖片 (例如 PNG、JPEG、WEBP) 或磁碟中的向量資源 painterResource API 和您的圖片參考資料。您不必知道類型 只要在 Imagepaint 修飾符中使用 painterResource 即可。

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() 可載入點陣圖。如要進一步瞭解 ImageBitmap,請參閱 ImageBitmap 與 ImageVector 一節。

可繪項目支援

painterResource 目前支援下列可繪項目類型:

從網際網路載入圖片

有幾個第三方程式庫可讓你從網際網路載入圖片 可以協助您處理流程圖片載入程式庫有很多種 所面臨的繁重工作因此不必下載 多次圖片) 和網路邏輯,用於下載並顯示圖片 。

例如,如要使用 Coil 載入圖片 從 Instacart 將程式庫新增至 Gradle 檔案,然後使用 AsyncImage 從網址載入圖片:

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

由 Kotlin 協同程式 (Instacart) 支援的圖片載入程式庫。

快速又有效率的 Android 圖片載入程式庫,旨在提供流暢的捲動瀏覽體驗 (Google)。