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);
},
)
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),
),
),
],
);
}
}
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
| Wert | Beschreibung |
|---|---|
| fill | Strecken zum Füllen (kann verzerren) |
| contain | Proportional skalieren, maximieren, um einzupassen |
| cover | Proportional skalieren, vollständig abdecken |
| fitWidth | Proportional skalieren, Breite füllen |
| fitHeight | Proportional skalieren, Höhe füllen |
| none | Zentrierte Anzeige in Originalgröße |
| scaleDown | einpassen 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,
),
);
}
}
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,
),
);
}
}
Weitere ErweiterungenFür Netzwerkbilder wird die Verwendung von CachedNetworkImage empfohlen, das Bilder automatisch zwischenspeichern und die Ladeleistung verbessern kann.