載入圖片

從磁碟載入圖片

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

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

可繪項目支援

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

• AnimatedVectorDrawable
• BitmapDrawable (PNG、JPG、WEBP)
• ColorDrawable
• VectorDrawable

從網際網路載入圖片

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

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

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

為您推薦

• 注意：系統會在 JavaScript 關閉時顯示連結文字
• Compose 中的資源
• Compose 中的無障礙功能
• Compose 中的圖形