Flutter-Bilder und Assets

Dieser Abschnitt führt in das Laden von Bildern, die Verwaltung lokaler Assets und den Umgang mit Netzwerkbildern in Flutter ein.


Image-Widget - Bildanzeige

Beispiel: Verschiedene Methoden zum Laden von Bildern

// Bild aus dem Netzwerk laden
Image.network(
  'https://example.com/image.png',
  width: 200,
  height: 200,
  fit: BoxFit.cover,
)

// Bild aus lokalen Assets laden
Image.asset('assets/images/logo.png')

// Bild aus lokaler Datei laden
Image.file(File('path/to/image.png'))

// Bild mit Ladezustand
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,
      ),
    );
  },
)

// Bild mit Fehlerbehandlung
Image.network(
  'https://example.com/image.png',
  errorBuilder: (context, error, stackTrace) {
    return const Icon(Icons.error, size: 50);
  },
)

Lokale Ressourcenverwaltung

Konfigurieren Sie den Asset-Ordner in pubspec.yaml:

flutter:
  assets:
    - assets/images/
    - assets/data.json

Beispiel: Lokale Ressourcen verwenden

// Lokales Bild verwenden
class AssetImageExample extends StatelessWidget {
  const AssetImageExample({super.key});

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        // Mit Image.asset laden
        const Image(
          image: AssetImage('assets/images/logo.png'),
          width: 100,
        ),
        // Kurzform
        const Image.asset('assets/images/icon.png', width: 50),
        const SizedBox(height: 20),
        // Bildanpassung verwenden
        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 Bildanpassung

WertBeschreibung
fillStrecken zum Füllen (kann verzerren)
containProportional skalieren, maximieren, um einzupassen
coverProportional skalieren, vollständig abdecken
fitWidthProportional skalieren, Breite füllen
fitHeightProportional skalieren, Höhe füllen
noneZentrierte Anzeige in Originalgröße
scaleDowneinpassen und die Originalgröße nicht überschreiten

CachedNetworkImage - Bild-Caching

Verwende das Paket cached_network_image, um Bild-Caching zu implementieren.

Abhängigkeit hinzufügen

dependencies:
  cached_network_image: ^3.0.0

Beispiel: 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',
      // Während des Ladens anzeigen
      placeholder: (context, url) => const CircularProgressIndicator(),
      // Fehler anzeigen
      errorWidget: (context, url, error) => const Icon(Icons.error),
      // Bildanpassung
      fit: BoxFit.cover,
      // Breite und Höhe
      width: 200,
      height: 200,
      // Rundes Bild
      imageBuilder: (context, imageProvider) => CircleAvatar(
        backgroundImage: imageProvider,
      ),
    );
  }
}

Für Netzwerkbilder wird die Verwendung von CachedNetworkImage empfohlen, das Bilder automatisch zwischenspeichern und die Ladeleistung verbessern kann.

Weitere Erweiterungen