使用佔位圖淡入圖片
如何讓圖片以淡入方式顯示。
當你使用預設的 Image 元件(Widget)來顯示圖片時,
你可能會注意到圖片載入時會直接出現在螢幕上。
這種方式可能會讓使用者感覺視覺上有些突兀。
那麼,是否可以一開始先顯示一個佔位圖,
等圖片載入完成後再以淡入效果顯示呢?你可以使用
FadeInImage
元件(Widget)來達成這個目的。
FadeInImage 可以搭配各種類型的圖片使用:記憶體內、在地資源(assets),
或來自網路的圖片都可以。
記憶體內圖片
#若要使用單一像素的透明 PNG 作為佔位圖, 請完成以下步驟:
-
建立透明圖片資料。
匯入
dart:convert與dart:typed_data, 然後從 Base64 編碼的字串解碼出圖片:dartimport 'dart:convert'; import 'dart:typed_data'; final Uint8List transparentImage = base64Decode( 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACklEQVR4' 'nGMAAQAABQABDQottAAAAABJRU5ErkJggg==', ); -
將圖片資料作為佔位圖。
將解碼後的圖片資料傳入
placeholder參數:dartFadeInImage.memoryNetwork( placeholder: transparentImage, image: 'https://picsum.photos/250?image=9', ),
完整範例
#import 'dart:convert';
import 'dart:typed_data';
import 'package:material_ui/material_ui.dart';
final Uint8List transparentImage = base64Decode(
'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACklEQVR4'
'nGMAAQAABQABDQottAAAAABJRU5ErkJggg==',
);
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
const title = 'Fade in images';
return MaterialApp(
title: title,
home: Scaffold(
appBar: AppBar(title: const Text(title)),
body: Stack(
children: <Widget>[
const Center(child: CircularProgressIndicator()),
Center(
child: FadeInImage.memoryNetwork(
placeholder: transparentImage,
image: 'https://picsum.photos/250?image=9',
),
),
],
),
),
);
}
}
從資源包(asset bundle)載入
#若要使用本地圖片資源(asset)作為佔位圖, 請完成以下步驟:
-
將佔位圖加入資源包。
在專案的
assets目錄中加入一張佔位圖, 例如assets/loading.gif。 接著在專案的pubspec.yaml檔案中宣告該資源。 更多細節請參考 Adding assets and images。yamlflutter: assets: - assets/loading.gif -
將資源作為佔位圖。
將資源路徑傳入
FadeInImage.assetNetwork建構函式(constructor)的placeholder參數:dartFadeInImage.assetNetwork( placeholder: 'assets/loading.gif', image: 'https://picsum.photos/250?image=9', ),
完整範例
#import 'package:material_ui/material_ui.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
const title = 'Fade in images';
return MaterialApp(
title: title,
home: Scaffold(
appBar: AppBar(title: const Text(title)),
body: Center(
child: FadeInImage.assetNetwork(
placeholder: 'assets/loading.gif',
image: 'https://picsum.photos/250?image=9',
),
),
),
);
}
}
Unless stated otherwise, the documentation on this site reflects Flutter 3.47. Page last updated on 2026-10-25. View source or report an issue.