Image Picker

​

Examples

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
),

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
  label: "Profile Picture",
  description: "Max 5MB.",
  maxFileSize: 5 * 1024 * 1024,
),

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
  onError: (error) => switch (error) {
    .fileTooLarge => "Image must be under 10MB",
    _ => null, // Falls back to default message
  },
),

​

Properties

​

Required

​

Content

​

Layout

​

State

​

Enums

​

NeoImagePickerError

• fileTooLarge: The selected file exceeds maxFileSize.
• unsupportedFormat: The dropped file is not a supported image format.
• pickFailed: The file picker failed to open or return a result.
• readFailed: The file could not be read from disk.
• dropFailed: The drag-and-drop operation failed.
• renderFailed: The image bytes could not be rendered (invalid format).
• unknown: An unexpected error occurred.

​

Best Practices

• Lower maxFileSize for a small image, such as an avatar, or compress before upload.
• Map onError to the message you want to show.

​

Behavior

• Accepted types are PNG, JPEG, GIF, WebP, HEIC, HEIF, BMP, and TIFF.
• A loading overlay shows while a file is read.
• The selected image uses BoxFit.contain. Hover shows a swap icon.
• A drag over the drop zone paints the border with theme.colors.success.