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);
  },
)

ローカルリソース管理

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),
          ),
        ),
      ],
    );
  }
}

BoxFit 画像フィット

值説明
fill引き伸ばして埋める(変形する可能性あり)
containアスペクト比を保って拡大縮小し、最大限にフィット
coverアスペクト比を保って拡大縮小し、完全に覆う
fitWidthアスペクト比を保って拡大縮小し、幅を埋める
fitHeightアスペクト比を保って拡大縮小し、高さを埋める
none中央に原寸サイズで表示
scaleDowncontain かつ元のサイズを超えない

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,
      ),
    );
  }
}

ネットワーク画像には、CachedNetworkImageを使用することをお勧めします。画像を自動的にキャッシュし、読み込みパフォーマンスを向上させます。

その他の拡張