Made with ❤️ by Chili Labs.
Library made without DataBinding, RxJava and image loading libraries, to give you opportunity to use it without additional dependencies.
No permission | Single choice | Multiple choice |
---|---|---|
![]() |
![]() |
![]() |
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"
Initialize ChiliPhotoPicker
in your Application
's class onCreate
loader
- your preferred ImageLoader
implementation (ready examples for Glide and Picasso are here)authority
- your file provider authority. Is needed if you set allowCamera
to true
, so picker could store temporary photo from cameraChiliPhotoPicker.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 default ChiliPhotoPicker.Light
is used)PhotoPickerFragment.newInstance(
multiple = true,
allowCamera = true,
maxSelection = 5,
theme = R.style.ChiliPhotoPicker_Dark
).show(supportFragmentManager, YOUR_TAG)
Notes: Picker will throw exception if:
loader
was not initializedauthority
was null while accessing cameraWe 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
Picked photos URIs are returned via callbacks onImagesPicked
function, so you just need to implement PhotoPickerFragment.Callback
interface in your activity or fragment
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 @null
as attribute value)pickerCameraIcon
- drawable for Camera icon (to remove it use @null
as attribute value)pickerCornerRadius
- background's corners radiuspickerDividerColor
- color of line below Gallery/Camera buttonsIt'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
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.