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

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

BoxFit Adaptación de imágenes

ValorDescripción
fillEstirar para llenar (puede deformarse)
containEscalado proporcional, adaptación máxima
coverEscalado proporcional, cobertura completa
fitWidthEscalado proporcional, ancho completo
fitHeightEscalado proporcional, alto completo
noneMostrar el tamaño original centrado
scaleDowncontain 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,
      ),
    );
  }
}

Para 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.

Otras extensiones