{"id":13989487,"url":"https://github.com/DavidPizarro/PickerUI","last_synced_at":"2025-07-22T11:30:28.252Z","repository":{"id":33486278,"uuid":"37132041","full_name":"DavidPizarro/PickerUI","owner":"DavidPizarro","description":"Android library to display a list of items for pick one","archived":false,"fork":false,"pushed_at":"2016-02-18T05:12:43.000Z","size":6609,"stargazers_count":630,"open_issues_count":12,"forks_count":135,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-11-29T08:39:12.316Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DavidPizarro.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-09T12:57:22.000Z","updated_at":"2024-10-18T14:34:52.000Z","dependencies_parsed_at":"2022-09-12T19:30:56.062Z","dependency_job_id":null,"html_url":"https://github.com/DavidPizarro/PickerUI","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/DavidPizarro/PickerUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidPizarro%2FPickerUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidPizarro%2FPickerUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidPizarro%2FPickerUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidPizarro%2FPickerUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DavidPizarro","download_url":"https://codeload.github.com/DavidPizarro/PickerUI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DavidPizarro%2FPickerUI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266483405,"owners_count":23936331,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-09T13:01:41.753Z","updated_at":"2025-07-22T11:30:27.693Z","avatar_url":"https://github.com/DavidPizarro.png","language":"Java","funding_links":[],"categories":["Java","Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"# PickerUI\n\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-PickerUI-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/2457) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.davidpizarro/pickerui/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.davidpizarro/pickerui)\n\nAndroid library to display a list of items for pick one with blur effect (if you wish).\nSupport for Android 3.0 and up. It supports portrait and landscape mode, saving the state.\n\n![Example screenshot](art/screenshots_framed.png)\n\nTry out the sample application on [Google Play][1].\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=com.dpizarro.libraries.uipickerlibrary\"\u003e\n  \u003cimg alt=\"PickerUI Sample on Google Play\"\n         src=\"http://developer.android.com/images/brand/en_app_rgb_wo_45.png\" /\u003e\n\u003c/a\u003e\n\nDemo\n=========================\n\n![Example gif](art/demo.gif)\n\nIncluding in Your Project\n=========================\n\n**Last version is 1.0.1**\n\nJust add the following statement in your build.gradle\n\n    compile 'com.github.davidpizarro:pickerui:VERSION'\n    \nYou may also add the library as an Android Library to your project. All the library files live in ```library```.\n\nUsage\n=====\n\nTo add the PickerUI to your layout add this to your xml\n```xml\n\u003ccom.dpizarro.uipicker.library.picker.PickerUI\n        android:id=\"@+id/picker_ui_view\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"wrap_content\"/\u003e\n```  \n\nYou can add custom attributes in your xml to customize: background, colors, behaviors, elements, blur, blur effects...\n```xml\n\n\u003ccom.dpizarro.uipicker.library.picker.PickerUI\n        android:id=\"@+id/picker_ui_view\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"wrap_content\"\n        pickerui:backgroundColor=\"#4cffa5\"\n        pickerui:linesCenterColor=\"#3941ff\"\n        pickerui:autoDismiss=\"true\"\n        pickerui:itemsClickables=\"true\"\n        pickerui:entries=\"@array/months\"\n        pickerui:textCenterColor=\"#000000\"\n        pickerui:textNoCenterColor=\"#737373\"\n        pickerui:blur=\"true\"\n        pickerui:blur_downScaleFactor=\"@integer/blur_downscale_min\"\n        pickerui:blur_FilterColor=\"#ff5e48\"\n        pickerui:blur_radius=\"@integer/blur_radius_min\"\n        pickerui:blur_use_renderscript=\"true\"/\u003e\n        \n```\nReview [attrs.xml][3] file to know the list of shapes ready to be used in the library.\n\n\nThis configuration can be also provided programmatically. You can use PickerUI programatically, using the Builder class to set the settings and the desired functionalities of panel to make easy:\n```java\nPickerUI mPickerUI = (PickerUI) findViewById(R.id.picker_ui_view);\n\nList\u003cString\u003e options = Arrays.asList(getResources().getStringArray(R.array.months));\n\nPickerUISettings pickerUISettings = new PickerUISettings.Builder()\n                                                      .withItems(options)\n                                                      .withBackgroundColor(getRandomColor())\n                                                      .withAutoDismiss(true)\n                                                      .withItemsClickables(false)\n                                                      .withUseBlur(false)\n                                                      .build();\n\nmPickerUI.setSettings(pickerUISettings);\n```\n\nYou can set/get values programatically:\n```java\nmPickerUI.setItems(this, options);\nmPickerUI.setColorTextCenter(R.color.background_picker);\nmPickerUI.setColorTextNoCenter(R.color.background_picker);\nmPickerUI.setBackgroundColorPanel(R.color.background_picker);\nmPickerUI.setLinesColor(R.color.background_picker);\nmPickerUI.setItemsClickables(false);\nmPickerUI.setAutoDismiss(false);\nmPickerUI.isPanelShown();\n```\n\nTo slide (show/hide) PickerUI, you only have to use **`slide()`** method, selecting none (by default, center) or some position.\n```java\nmPickerUI.slide();\n//or\nmPickerUI.slide(8);\n```\n\nIn order to receive the value selected in the picker, you will need to implement the `onItemClickPickerUI` interface.\n```java\nmPickerUI.setOnClickItemPickerUIListener(new PickerUI.PickerUIItemClickListener() {\n                    @Override\n                    public void onItemClickPickerUI(int which, int position, String valueResult) {\n                        Toast.makeText(MainActivity.this, valueResult, Toast.LENGTH_SHORT).show();\n                    }\n                });\n```\n\nOr browse the [source code of the sample application][2] for a complete example of use.\n\nBlur effect\n=====\n\nThis library applies a blur effect when you slide the picker, but it is optional and optimized.\nYou can choose Java algorithm (slower) or **`RenderScript`** (a quick and efficient solution to blur images). Available since API 11 (Honeycomb), **`RenderScript`** allows to take advantage of the GPU acceleration and is targeted at high-performance 3D rendering and compute operations.\n\nFor the integration of the **`RenderScript`** support library you just have to add two lines to your **`build.gradle`**. You do not need to declare any dependencies. Depending on the gradle version you are running, the commands are slightly different:\n\n#### 1. Gradle version 0.14+ and newer\n  ```xml\n  android {\n      defaultConfig {\n          renderscriptTargetApi 19\n          renderscriptSupportModeEnabled true\n      }\n  }\n  ```\n\n#### 2. Older Gradle versions up to 0.13\n  ```xml\n  android {\n    defaultConfig {\n        renderscriptTargetApi 19\n        renderscriptSupportMode true\n    }\n  }\n  ```\n\nContribution\n============\n\n#### Pull requests are welcome!\n\nI'd like to improve this library with your help!\nIf you've fixed a bug or have a feature you've added, just create a pull request. Issues can be reported on the github issue tracker.\n\nWho's using it\n=========================\n*Does your app use AutoLabelUI? If you want to be featured on this list drop me a line.*\n\nAuthor\n============\n\nDavid Pizarro (dpizarro89@gmail.com)\n\n\u003ca href=\"https://plus.google.com/u/0/110797503395500685158\"\u003e\n  \u003cimg alt=\"Follow me on Google+\"\n       src=\"https://raw.githubusercontent.com/DavidPizarro/android-live-templates/master/art/google.png\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/DavidPizarro89\"\u003e\n  \u003cimg alt=\"Follow me on Twitter\"\n       src=\"https://raw.githubusercontent.com/DavidPizarro/android-live-templates/master/art/twitter.png\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/in/davidpizarrodejesus\"\u003e\n  \u003cimg alt=\"Follow me on LinkedIn\"\n       src=\"https://raw.githubusercontent.com/DavidPizarro/android-live-templates/master/art/linkedin.png\" /\u003e\n\u003c/a\u003e\n\n\nLicense\n-------\n\n    Copyright 2015 David Pizarro\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n---\n\n[1]: https://play.google.com/store/apps/details?id=com.dpizarro.libraries.uipickerlibrary\n[2]: https://github.com/DavidPizarro/PickerUI/tree/master/app\n[3]: https://github.com/DavidPizarro/PickerUI/blob/master/library/src/main/res/values/attrs.xml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDavidPizarro%2FPickerUI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDavidPizarro%2FPickerUI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDavidPizarro%2FPickerUI/lists"}