Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ParkSangGwon/TedBottomPicker
TedBottomPicker is simple image picker using bottom sheet
https://github.com/ParkSangGwon/TedBottomPicker
Last synced: 1 day ago
JSON representation
TedBottomPicker is simple image picker using bottom sheet
- Host: GitHub
- URL: https://github.com/ParkSangGwon/TedBottomPicker
- Owner: ParkSangGwon
- Created: 2016-08-30T08:08:31.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-08-28T10:38:34.000Z (10 months ago)
- Last Synced: 2024-02-29T03:37:14.669Z (4 months ago)
- Language: Java
- Homepage:
- Size: 3.98 MB
- Stars: 1,116
- Watchers: 25
- Forks: 186
- Open Issues: 59
-
Metadata Files:
- Readme: README.md
Lists
- awesome-github-android-ui - TedBottomPicker - 简单的图片选择器 (ActionSheet)
- awesome-github-android-ui - TedBottomPicker - 简单的图片选择器 (ActionSheet)
README
# [THIS LIBRARY IS DEPRECATED] Please use [TedImagePicker](https://github.com/ParkSangGwon/TedImagePicker)
# What is TedBottomPicker?
In Google's Material Design, Google introduce **Bottom sheets**.([Components – Bottom sheets](https://material.google.com/components/bottom-sheets.html))
**Bottom sheets** slide up from the bottom of the screen to reveal more content.
If you want pick image from gallery or take picture, this library can help easily.
**TedBottomPicker** provide 3 options:
1. Take a picture by camera(using `MediaStore.ACTION_IMAGE_CAPTURE` intent)
2. Get image from gallery(using `Intent.ACTION_PICK` intent)
3. Get image from recent image(using `MediaStore.Images.Media.EXTERNAL_CONTENT_URI` cursor)
**TedBottomPicker** is simple image picker using bottom sheet.
## TedImagePicker
- If you want full screen image picker, use [TedImagePicker](https://github.com/ParkSangGwon/TedImagePicker)
- TedImagePicker is simple/beautiful/smart image picker
. 
## Demo
1. Show Bottom Sheet.
2. Pick Image
### Single/Multi Select
 
## Setup
### Gradle
[](https://search.maven.org/search?q=g:%22io.github.ParkSangGwon%22%20AND%20a:%tedbottompicker%22)
```javascript
dependencies {
implementation 'gun0912.ted:tedbottompicker:x.y.z'
//implementation 'gun0912.ted:tedbottompicker:2.0.1'
}
```
If you think this library is useful, please press star button at upside.
## How to use
### 1. Check Permission
You have to grant `WRITE_EXTERNAL_STORAGE` permission from user.
If your targetSDK version is 23+, you have to check permission and request permission to user.
Because after Marshmallow(6.0), you have to not only declare permissions in `AndroidManifest.xml` but also request permissions at runtime.
There are so many permission check library in [Android-Arsenal](http://android-arsenal.com/tag/235?sort=rating)
I recommend [TedPermission](https://github.com/ParkSangGwon/TedPermission)
**TedPermission** is super simple and smart permission check library.
### 2. Start TedBottomPicker
- TedBottomPicker support `RxJava` and `Listener` style
### RxJava
**You have to use TedRxBottomPicker**
- Single image
```java
TedRxBottomPicker.with(MainActivity.this)
.show()
.subscribe(uri ->
// here is selected image uri
}, Throwable::printStackTrace);
```
- Multi image
```java
TedRxBottomPicker.with(MainActivity.this)
//.setPeekHeight(getResources().getDisplayMetrics().heightPixels/2)
.setPeekHeight(1600)
.showTitle(false)
.setCompleteButtonText("Done")
.setEmptySelectionText("No Select")
.setSelectedUriList(selectedUriList)
.showMultiImage()
.subscribe(uris -> {
// here is selected image uri list
}, Throwable::printStackTrace);
```
### Listener
**You have to use TedBottomPicker**
- Single image
```java
TedBottomPicker.with(MainActivity.this)
.show(new TedBottomSheetDialogFragment.OnImageSelectedListener() {
@Override
public void onImageSelected(Uri uri) {
// here is selected image uri
}
});
```
- Multi image
```java
TedBottomPicker.with(MainActivity.this)
.setPeekHeight(1600)
.showTitle(false)
.setCompleteButtonText("Done")
.setEmptySelectionText("No Select")
.setSelectedUriList(selectedUriList)
.showMultiImage(new TedBottomSheetDialogFragment.OnMultiImageSelectedListener() {
@Override
public void onImagesSelected(List uriList) {
// here is selected image uri list
}
});
```
## Customize
You can customize something ...
### Function
#### Common
* `showVideoMedia()` : Not only load image, but also load video
* `setPreviewMaxCount(Int) (default: 25)`
* `setPeekHeight(Int)`
* `setPeekHeightResId(R.dimen.xxx)`
* `showCameraTile(Boolean) (default: true)`
* `setCameraTile(R.drawable.xxx or Drawable)`
* `setCameraTileBackgroundResId(R.color.xxx)`
* `setGalleryTile(R.drawable.xxx or Drawable)`
* `showGalleryTile(Boolean) (default: true)`
* `setGalleryTileBackgroundResId(R.color.xxx)`
* `setSpacing(Int)`
* `setSpacingResId(R.dimen.xxx)`
* `setOnErrorListener(OnErrorListener)`
* `setTitle(String or R.string.xxx) (default: 'Select Image','사진 선택')`
* `showTitle(Boolean) (default: true)`
* `setTitleBackgroundResId(R.color.xxx)`
* `setImageProvider(ImageProvider)`
: If you want load grid image yourself, you can use your ImageProvider
#### Single Select
* `setSelectedUri(Uri)`
#### Multi Select
* `setDeSelectIcon(R.drawable.xxx or Drawable)`
* `setSelectedForeground(R.drawable.xxx or Drawable)`
* `setSelectMaxCount(Int)`
* `setSelectMinCount(Int)`
* `setCompleteButtonText(String or R.string.xxx) (default: 'Done','완료')`
* `setEmptySelectionText(String or R.string.xxx) (default: 'No Image','이미지가 선택되지 않았습니다')`
* `setSelectMaxCountErrorText(String or R.string.xxx)`
* `setSelectMinCountErrorText(String or R.string.xxx)`
* `setSelectedUriList(ArrayList)`
## Thanks
* [Flipboard-bottomsheet](https://github.com/Flipboard/bottomsheet) - Android component which presents a dismissible view from the bottom of the screen
## License
```code
Copyright 2017 Ted Park
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.```