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