ChiliPhotoPicker
Made with
Library made without DataBinding, RxJava and image loading libraries, to give you opportunity to use it without additional dependencies.
- Picker styled as bottom sheet dialog
- Could be used for single or multiple photos pick
- Allows to choose how images are loaded into ImageView
- Takes responsibility for all needed permissions
- Takes responsibility for fetching gallery/camera result
- Have two built-in themes - Light and Dark
- Easy custamizable
| No permission | Single choice | Multiple choice |
|---|---|---|
 |
 |
 |
Setup
Gradle:
Add Jitpack to your root build.gradle file:
allprojects {
repositories {
google()
jcenter()
maven { url "https://jitpack.io" }
}
}
Add dependency to application build.gradle file, where x.y.z is the latest release version:
implementation "com.github.ChiliLabs:ChiliPhotoPicker:x.y.z"
Usage
Initialize ChiliPhotoPicker in your Application's class onCreate
loader- your preferredImageLoaderimplementation (ready examples for Glide and Picasso are here)authority- your file provider authority. Is needed if you setallowCameratotrue, so picker could store temporary photo from camera
ChiliPhotoPicker.init(
loader = GlideImageLoader(),
authority = "lv.chi.sample.fileprovider"
)
Create new instance of PhotoPickerFragment
multiple- true for multiple image pick, false for singleallowCamera- true to show Camera button, false to hidemaxSelection- limit images count to picktheme- built-in or custom theme (by defaultChiliPhotoPicker.Lightis used)- Show as dialog
PhotoPickerFragment.newInstance(
multiple = true,
allowCamera = true,
maxSelection = 5,
theme = R.style.ChiliPhotoPicker_Dark
).show(supportFragmentManager, YOUR_TAG)
Notes: Picker will throw exception if:
loaderwas not initializedauthoritywas null while accessing camera
ImageLoader
We don't want to depend on many image loading libraries, so we have simple ImageLoader interface, which you can implement using your preferred library (Glide, Picasso, Coil, etc.) We have two working examples of ImageLoader implementations - using Glide and Picasso. You can just copy one of them or write your own implementation
Callback
Picked photos URIs are returned via callbacks onImagesPicked function, so you just need to implement PhotoPickerFragment.Callback interface in your activity or fragment
Themes
To customize picker you can use one of built-in themes or inherit it rewriting attributes you want (see example)
Attributes:
pickerBackgroundColor- background colorpickerPrimaryColor- primary picker color (no permission/empty texts, cancel icon)pickerSecondaryColor- secondary picker color (snackbar)pickerControlColor- color of buttons, icons, checkboxes, ripplepickerGalleryIcon- drawable for Gallery icon (to remove it use@nullas attribute value)pickerCameraIcon- drawable for Camera icon (to remove it use@nullas attribute value)pickerCornerRadius- background's corners radiuspickerDividerColor- color of line below Gallery/Camera buttons
Localization
It's difficult to translate library to each language, so default strings are on English, but you can easily override them. Example for common strings and plurals are here. All strings used in library can be found here
License
Copyright 2019 Chili Labs
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
242 Dec 14, 2022
162 Sep 13, 2022
812 Dec 30, 2022
47 Jan 5, 2023
502 Jan 9, 2023
265 Dec 26, 2022
10 Nov 14, 2021
794 Dec 23, 2022
97 Dec 15, 2022
12 Nov 22, 2022
304 Dec 27, 2022
4.5k Jan 7, 2023
6.7k Dec 31, 2022
2.5k Dec 28, 2022
1.8k Dec 19, 2022
1k Dec 1, 2022
426 Dec 22, 2022
64 Nov 15, 2022
19 May 28, 2022