Flutter 画像とリソース
このセクションでは、Flutterでの画像読み込み、ローカルリソース管理、ネットワーク画像の処理について紹介します。
Image Widget - 画像表示
例:さまざまな画像読み込み方法
// ネットワークから画像を読み込む
Image.network(
'https://example.com/image.png',
width: 200,
height: 200,
fit: BoxFit.cover,
)
// ローカルリソースから画像を読み込む
Image.asset('assets/images/logo.png')
// ローカルファイルから画像を読み込む
Image.file(File('path/to/image.png'))
// 読み込み状態付きの画像
Image.network(
'https://example.com/image.png',
loadingBuilder: (context, child, loadingProgress) {
if (loadingProgress == null) return child;
return Center(
child: CircularProgressIndicator(
value: loadingProgress.expectedTotalBytes != null
? loadingProgress.cumulativeBytesLoaded /
loadingProgress.expectedTotalBytes!
: null,
),
);
},
)
// エラー処理付きの画像
Image.network(
'https://example.com/image.png',
errorBuilder: (context, error, stackTrace) {
return const Icon(Icons.error, size: 50);
},
)
Image.network(
'https://example.com/image.png',
width: 200,
height: 200,
fit: BoxFit.cover,
)
// ローカルリソースから画像を読み込む
Image.asset('assets/images/logo.png')
// ローカルファイルから画像を読み込む
Image.file(File('path/to/image.png'))
// 読み込み状態付きの画像
Image.network(
'https://example.com/image.png',
loadingBuilder: (context, child, loadingProgress) {
if (loadingProgress == null) return child;
return Center(
child: CircularProgressIndicator(
value: loadingProgress.expectedTotalBytes != null
? loadingProgress.cumulativeBytesLoaded /
loadingProgress.expectedTotalBytes!
: null,
),
);
},
)
// エラー処理付きの画像
Image.network(
'https://example.com/image.png',
errorBuilder: (context, error, stackTrace) {
return const Icon(Icons.error, size: 50);
},
)
ローカルリソース管理
pubspec.yamlでリソースフォルダを設定します:
flutter:
assets:
- assets/images/
- assets/data.json
例:ローカルリソースを使用
// ローカル画像を使用
class AssetImageExample extends StatelessWidget {
const AssetImageExample({super.key});
@override
Widget build(BuildContext context) {
return Column(
children: [
// Image.assetを使用して読み込む
const Image(
image: AssetImage('assets/images/logo.png'),
width: 100,
),
// 省略形
const Image.asset('assets/images/icon.png', width: 50),
const SizedBox(height: 20),
// 画像のfitを使用
Container(
width: 200,
height: 100,
decoration: BoxDecoration(
image: const DecorationImage(
image: AssetImage('assets/images/bg.jpg'),
fit: BoxFit.cover,
),
border: Border.all(color: Colors.grey),
),
),
],
);
}
}
class AssetImageExample extends StatelessWidget {
const AssetImageExample({super.key});
@override
Widget build(BuildContext context) {
return Column(
children: [
// Image.assetを使用して読み込む
const Image(
image: AssetImage('assets/images/logo.png'),
width: 100,
),
// 省略形
const Image.asset('assets/images/icon.png', width: 50),
const SizedBox(height: 20),
// 画像のfitを使用
Container(
width: 200,
height: 100,
decoration: BoxDecoration(
image: const DecorationImage(
image: AssetImage('assets/images/bg.jpg'),
fit: BoxFit.cover,
),
border: Border.all(color: Colors.grey),
),
),
],
);
}
}
BoxFit 画像フィット
| 值 | 説明 |
|---|---|
| fill | 引き伸ばして埋める(変形する可能性あり) |
| contain | アスペクト比を保って拡大縮小し、最大限にフィット |
| cover | アスペクト比を保って拡大縮小し、完全に覆う |
| fitWidth | アスペクト比を保って拡大縮小し、幅を埋める |
| fitHeight | アスペクト比を保って拡大縮小し、高さを埋める |
| none | 中央に原寸サイズで表示 |
| scaleDown | contain かつ元のサイズを超えない |
CachedNetworkImage - 画像キャッシュ
cached_network_image パッケージを使用して画像キャッシュを実装します。
依存関係を追加
dependencies: cached_network_image: ^3.0.0
例:CachedNetworkImage
import 'package:cached_network_image/cached_network_image.dart';
class CachedImageExample extends StatelessWidget {
const CachedImageExample({super.key});
@override
Widget build(BuildContext context) {
return CachedNetworkImage(
imageUrl: 'https://example.com/image.png',
// 読み込み中に表示
placeholder: (context, url) => const CircularProgressIndicator(),
// エラー表示
errorWidget: (context, url, error) => const Icon(Icons.error),
// 画像フィット
fit: BoxFit.cover,
// 幅と高さ
width: 200,
height: 200,
// 円形画像
imageBuilder: (context, imageProvider) => CircleAvatar(
backgroundImage: imageProvider,
),
);
}
}
class CachedImageExample extends StatelessWidget {
const CachedImageExample({super.key});
@override
Widget build(BuildContext context) {
return CachedNetworkImage(
imageUrl: 'https://example.com/image.png',
// 読み込み中に表示
placeholder: (context, url) => const CircularProgressIndicator(),
// エラー表示
errorWidget: (context, url, error) => const Icon(Icons.error),
// 画像フィット
fit: BoxFit.cover,
// 幅と高さ
width: 200,
height: 200,
// 円形画像
imageBuilder: (context, imageProvider) => CircleAvatar(
backgroundImage: imageProvider,
),
);
}
}
その他の拡張ネットワーク画像には、CachedNetworkImageを使用することをお勧めします。画像を自動的にキャッシュし、読み込みパフォーマンスを向上させます。