Изображения и ресурсы во Flutter

В этом разделе мы рассмотрим загрузку изображений, управление локальными ресурсами и работу с сетевыми изображениями во Flutter.


Виджет Image — отображение изображений

Пример: различные способы загрузки изображений

// Загрузка изображения из сети
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),
        // Использовать подгонку изображения
        Контейнер(
          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Отображать по центру в исходном размере
scaleDownвписывать и не превышать исходный размер

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, который может автоматически кэшировать изображения и улучшать производительность загрузки.

Другие расширения