Flutter Imágenes y Recursos
En esta sección se presentará la carga de imágenes en Flutter, la gestión de recursos locales y el procesamiento de imágenes de red.
Image Widget - Visualización de imágenes
Ejemplo: Diversas formas de cargar imágenes
// Cargar imagen desde la red
Image.network(
'https://example.com/image.png',
width: 200,
height: 200,
fit: BoxFit.cover,
)
// Cargar imagen desde recursos locales
Image.asset('assets/images/logo.png')
// Cargar imagen desde un archivo local
Image.file(File('path/to/image.png'))
// Imagen con estado de carga
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,
),
);
},
)
// Imagen con manejo de errores
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,
)
// Cargar imagen desde recursos locales
Image.asset('assets/images/logo.png')
// Cargar imagen desde un archivo local
Image.file(File('path/to/image.png'))
// Imagen con estado de carga
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,
),
);
},
)
// Imagen con manejo de errores
Image.network(
'https://example.com/image.png',
errorBuilder: (context, error, stackTrace) {
return const Icon(Icons.error, size: 50);
},
)
Gestión de recursos locales
Configurar la carpeta de recursos en pubspec.yaml:
flutter:
assets:
- assets/images/
- assets/data.json
Ejemplo: Uso de recursos locales
// Usar imagen local
class AssetImageExample extends StatelessWidget {
const AssetImageExample({super.key});
@override
Widget build(BuildContext context) {
return Column(
children: [
// Cargar con Image.asset
const Image(
image: AssetImage('assets/images/logo.png'),
width: 100,
),
// Forma abreviada
const Image.asset('assets/images/icon.png', width: 50),
const SizedBox(height: 20),
// Usar el fit de la imagen
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: [
// Cargar con Image.asset
const Image(
image: AssetImage('assets/images/logo.png'),
width: 100,
),
// Forma abreviada
const Image.asset('assets/images/icon.png', width: 50),
const SizedBox(height: 20),
// Usar el fit de la imagen
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 Adaptación de imágenes
| Valor | Descripción |
|---|---|
| fill | Estirar para llenar (puede deformarse) |
| contain | Escalado proporcional, adaptación máxima |
| cover | Escalado proporcional, cobertura completa |
| fitWidth | Escalado proporcional, ancho completo |
| fitHeight | Escalado proporcional, alto completo |
| none | Mostrar el tamaño original centrado |
| scaleDown | contain y sin exceder el tamaño original |
CachedNetworkImage - Caché de imágenes
Utilice el paquete cached_network_image para implementar el caché de imágenes.
Agregar dependencia
dependencies: cached_network_image: ^3.0.0
Ejemplo: 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',
// Mostrar durante la carga
placeholder: (context, url) => const CircularProgressIndicator(),
// Mostrar en caso de error
errorWidget: (context, url, error) => const Icon(Icons.error),
// Adaptación de la imagen
fit: BoxFit.cover,
// Ancho y alto
width: 200,
height: 200,
// Imagen circular
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',
// Mostrar durante la carga
placeholder: (context, url) => const CircularProgressIndicator(),
// Mostrar en caso de error
errorWidget: (context, url, error) => const Icon(Icons.error),
// Adaptación de la imagen
fit: BoxFit.cover,
// Ancho y alto
width: 200,
height: 200,
// Imagen circular
imageBuilder: (context, imageProvider) => CircleAvatar(
backgroundImage: imageProvider,
),
);
}
}
Otras extensionesPara imágenes de red, se recomienda usar CachedNetworkImage, ya que puede almacenar automáticamente en caché las imágenes y mejorar el rendimiento de carga.