image_picker_widget 2.0.0 image_picker_widget: ^2.0.0 copied to clipboard
Flutter package to integrate image_picker with a simple Flutter widget, allowing you to edit an image without any problems with design code development.
image_picker_widget #
A new Flutter package to integrate image_picker with a simple Flutter widget, allowing you to edit an image without any problems with design code development
Preview | Modal image type picker |
---|---|
Getting Started #
Add the dependency in pubspec.yaml
:
dependencies:
...
# Design
image_picker_widget: '>=2.0.0 <3.0.0 /// For pre null-safety, use version 1.0.3'
A Flutter plugin for iOS and Android for picking images from the image library, and taking new pictures with the camera.
Installation #
Since this package requires image_picker
, you need to add this requirements bellow.
iOS #
Add the following keys to your Info.plist file, located in <project root>/ios/Runner/Info.plist
:
NSPhotoLibraryUsageDescription
- describe why your app needs permission for the photo library. This is called Privacy - Photo Library Usage Description in the visual editor.NSCameraUsageDescription
- describe why your app needs access to the camera. This is called Privacy - Camera Usage Description in the visual editor.NSMicrophoneUsageDescription
- describe why your app needs access to the microphone, if you intend to record videos. This is called Privacy - Microphone Usage Description in the visual editor.
Android #
API 29+
No configuration required - the plugin should work out of the box.
API < 29
Add android:requestLegacyExternalStorage="true"
as an attribute to the <application>
tag in AndroidManifest.xml. The attribute is false
by default on apps targeting Android Q.
Parameter (Required) #
diameter
- The diameter of the container in which the image is contained.
Parameter (Optional) #
initialImage
- The initial image to be displaied, can be anImageProvider
,File
or aexternal url (String)
isEditable
- Checks whether the image can be changedonChange
- Case the image can be changed, this function will be called after the change.
Customization (Optional) #
Image Picker Widget #
shape
- The shape of the widget [square
orcircle
]backgroundColor
- The background of the widget [default toColors.grey[500]
]editIcon
- The widget that references the possibility of editing
Modal image type picker #
modalTitle
- The title of the widget [default toText
> "Select:"]modalCameraIcon
- The camera icon that selects the camera [default toIcons.camera
]modalCameraText
- The camera label that indicates to selects the camera [defaults toText
> "camera"]modalGalleryIcon
- The gallery icon that selects the gallery [default toIcons.collections
]modalGalleryText
- The gallery label that indicates to selects the gallery [defaults toText
> "gallery"]
Basic Usage #
Adding the widget
..child: ImagePickerWidget(
diameter: 180,
// initialImage: "https://strattonapps.com/wp-content/uploads/2020/02/flutter-logo-5086DD11C5-seeklogo.com_.png",
shape: ImagePickerWidgetShape.circle, // ImagePickerWidgetShape.square
isEditable: true,
onChange: (File file) {
print("I changed the file to: ${file.path}");
},
)
Issues #
Please if you see any issues, bugs, or feature requests, send to me in: GitHub issue.