Buscar pacotes, repositórios e categorias de apps

Capa de any_image_view
Detalhes do pacotev2.5.0

any_image_view

Um visualizador de imagens Flutter versátil que suporta PNG, JPG, WebP, GIF, TIFF, RAW, SVG, Lottie, XFile e imagens de rede com a melhor resolução — tudo em um único pacote sem problemas.

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
649
Curtidas
100
Pontos Pub
160

Instalar pacote

flutter pub add any_image_view

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

AnyImageView é um pacote completo do Flutter que simplifica a exibição de vários formatos de imagem, incluindo PNG, JPG, WebP, GIF, TIFF, RAW, SVG e Lottie, bem como imagens de rede e XFile. Ele gerencia automaticamente a otimização de resolução e o renderização entre plataformas, garantindo exibição de alta qualidade sem configurações adicionais. Projetado para integração perfeita, suporta Android, iOS, macOS, Windows e Linux, tornando-o ideal para aplicativos que exigem manipulação flexível e confiável de imagens.

Casos de uso

  • Exibindo diversos formatos de imagem em um único widget
  • Carregando imagens de URLs e arquivos locais
  • Suporte a imagens animadas como GIF e Lottie
  • Renderização de gráficos vetoriais, como SVG
  • Manipulação de imagens brutas e de alta resolução
  • Construindo galerias de mídia ou aplicativos com muitas imagens

Principais recursos

  • Suporta vários formatos de imagem (PNG, JPG, WebP, GIF, TIFF, RAW, SVG, Lottie)
  • Otimização automática de resolução
  • Gerencia fontes de rede e XFile
  • Compatibilidade multiplataforma
  • API simples com configuração mínima
  • Cache embutido e tratamento de erros

Indicado para

  • Desenvolvedores construindo aplicativos ricos em mídia
  • Aplicativos que exigem suporte para imagens animadas ou vetoriais
  • Projetos que exigem renderização de imagem consistente entre plataformas
  • Equipes que desejam uma solução unificada para exibição de imagens
  • Aplicativos de prototipagem ou produção com fontes de imagem variadas

Considerações

  • Pode aumentar o tamanho do aplicativo devido aos decodificadores de formato incluídos
  • O desempenho pode variar com animações grandes ou complexas
  • Requer gerenciamento cuidadoso da memória para listas longas de imagens
  • Personalização limitada para processamento avançado de imagens
  • Não destinado à edição ou transformação de imagens

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

any_image_view

Pub Version License

Any Image View

Show any image with one widget. Network, asset, file, XFile, SVG or Lottie: hand it to AnyImageView and it takes care of loading, caching, retries and errors. Zero dependencies.

Install

dependencies:
  any_image_view: ^2.5.0
import 'package:any_image_view/any_image_view.dart';

Usage

// Network (cached on disk after the first load)
AnyImageView(imagePath: 'https://example.com/photo.jpg', height: 200, width: 200)

// Asset
AnyImageView(imagePath: 'assets/photo.png', height: 200, width: 200)

// SVG, asset or network, optionally tinted
AnyImageView(imagePath: 'assets/icon.svg', height: 40, width: 40, svgColor: Colors.blue)

// Lottie, loops automatically
AnyImageView(imagePath: 'assets/loader.json', height: 120, width: 120)

// Local file or image_picker result
AnyImageView(imagePath: '/path/to/photo.jpg', height: 200, width: 200)
AnyImageView(imagePath: pickedXFile, height: 200, width: 200)

// Circular avatar
AnyImageView(imagePath: url, height: 80, width: 80, shape: BoxShape.circle)

// Tap for a fullscreen viewer with pan, pinch and double-tap zoom
AnyImageView(imagePath: url, height: 200, width: 200, enableFullscreen: true)

// Styling and custom states
AnyImageView(
  imagePath: url,
  height: 200,
  width: 300,
  fit: BoxFit.cover,
  borderRadius: BorderRadius.circular(16),
  placeholderWidget: const CircularProgressIndicator(),
  errorWidget: const Icon(Icons.broken_image),
)

Supported formats

Type Formats
Raster PNG, JPG, WebP, GIF, BMP, ICO
Platform-decoded AVIF, HEIC on Android 12+, iOS 16+, macOS 13+ and web
Vector SVG
Animation Lottie .json, .zip, .lottie
Sources Network URL, asset, file path, file:// URI, XFile, File

The source is detected from the path. Matching is case-insensitive and ignores query strings and fragments.

Parameters

Parameter Type Default Purpose
imagePath Object? URL, asset path, file path, XFile or File
height, width double? Size
fit BoxFit? cover How the image fills the box (contain for SVG and Lottie)
alignment Alignment? Alignment inside the container
shape BoxShape rectangle rectangle or circle
borderRadius BorderRadius? Rounded corners
border BoxBorder? Border
boxShadow List<BoxShadow>? Shadows
margin, padding EdgeInsetsGeometry? Outer and inner spacing
placeholderWidget Widget? shimmer Shown while loading
errorWidget Widget? broken-image icon Shown on failure
fadeDuration Duration 400 ms Fade-in
maxRetryAttempts int 3 Retries after a failed network load; 0 disables
httpHeaders Map<String, String>? Headers for network requests
enableZoom bool false Inline pinch-to-zoom
enableFullscreen bool false Tap opens a fullscreen viewer
onTap VoidCallback? Custom tap handler
svgColor Color? Tint for SVGs
svgColorFilter ColorFilter? Custom SVG color filter

Screenshots

Network, PNG, SVG AVIF Lottie, avatar, error Fullscreen
Network image, PNG and SVG AVIF asset and network AVIF Lottie, circular avatar and error widget Fullscreen viewer

Categorias

Repositório-fonte

Projetos que usam este pacote