{"id":13989484,"url":"https://github.com/soarcn/BottomSheet","last_synced_at":"2025-07-22T11:30:29.066Z","repository":{"id":55445053,"uuid":"24320092","full_name":"soarcn/BottomSheet","owner":"soarcn","description":"One way to present a set of actions to a user is with bottom sheets, a sheet of paper that slides up from the bottom edge of the screen. Bottom sheets offer flexibility in the display of clear and simple actions that do not need explanation.","archived":false,"fork":false,"pushed_at":"2020-12-30T13:04:03.000Z","size":777,"stargazers_count":2214,"open_issues_count":13,"forks_count":409,"subscribers_count":90,"default_branch":"master","last_synced_at":"2025-05-29T06:13:08.922Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://soarcn.github.io/BottomSheet","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soarcn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://www.paypal.me/kailiao"}},"created_at":"2014-09-22T08:14:19.000Z","updated_at":"2025-05-15T07:43:18.000Z","dependencies_parsed_at":"2022-08-15T00:30:27.405Z","dependency_job_id":null,"html_url":"https://github.com/soarcn/BottomSheet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/soarcn/BottomSheet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soarcn%2FBottomSheet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soarcn%2FBottomSheet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soarcn%2FBottomSheet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soarcn%2FBottomSheet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soarcn","download_url":"https://codeload.github.com/soarcn/BottomSheet/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soarcn%2FBottomSheet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266483409,"owners_count":23936334,"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.571Z","updated_at":"2025-07-22T11:30:28.572Z","avatar_url":"https://github.com/soarcn.png","language":"Java","funding_links":["https://www.paypal.me/kailiao"],"categories":["Java","Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"BottomSheet\n=======\n[![Build Status](https://travis-ci.org/soarcn/BottomSheet.svg)](https://travis-ci.org/soarcn/BottomSheet) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-BottomSheet-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1044)\n\n**_Google introduced official bottomsheets implementation in Support library 23.2.0,thus this library is no longer activly being developed. I will continuely fix defects been found and accept good PR but No more new feature will be developed. Thanks for your support!_**\n\nOne way to present a set of actions to a user is with bottom sheets, a sheet of paper that slides up from the bottom edge of the screen. Bottom sheets offer flexibility in the display of clear and simple actions that do not need explanation.\n\nhttps://www.google.com/design/spec/components/bottom-sheets.html\n\nThis library works on android api 14+\n\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image.png?raw=true)\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image1.png?raw=true)\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image2.png?raw=true)\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image3.png?raw=true)\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image4.png?raw=true)\n![Sample](https://github.com/soarcn/BottomSheet/blob/master/art/image5.png?raw=true)\n\nHow to use this library\n=======\n\n- Download this library, import to your IDE (eclipse...) as a library project.\n- Using Gradle\n\n```groovy\n    compile 'com.cocosw:bottomsheet:1.+@aar'\n```\n- Using Maven\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.cocosw\u003c/groupId\u003e\n    \u003cartifactId\u003ebottomsheet\u003c/artifactId\u003e\n    \u003cversion\u003e1.x\u003c/version\u003e\n    \u003ctype\u003eapklib\u003c/type\u003e\n\u003c/dependency\u003e\n```\n\n- Version\nif you use Android support library - 1.4.0\nif you use Androidx - 1.5.0\n\nAPI\n=======\n\n- Define actions in menu xml (Tip: divider tag has been replaced by group tag from 1.1.0)\n\n```xml\n\u003cmenu xmlns:android=\"http://schemas.android.com/apk/res/android\"\u003e\n    \u003citem android:id=\"@+id/share\" android:title=\"@string/share\" android:icon=\"@drawable/perm_group_messages\"/\u003e\n    \u003citem android:id=\"@+id/upload\" android:title=\"@string/upload\" android:icon=\"@drawable/perm_group_system_clock\"/\u003e\n    \u003citem android:id=\"@+id/call\" android:title=\"@string/call\" android:icon=\"@drawable/perm_group_phone_calls\"/\u003e\n    \u003cgroup android:id=\"@+id/helpgroup\"\u003e\n         \u003citem android:id=\"@+id/help\" android:title=\"@string/help\" android:icon=\"@drawable/perm_group_system_tools\"/\u003e\n    \u003c/group\u003e\n\u003c/menu\u003e\n\n```\n\n- Show it just like showing a dialog.\n\n```java\nnew BottomSheet.Builder(this).title(\"title\").sheet(R.menu.list).listener(new DialogInterface.OnClickListener() {\n                    @Override\n                    public void onClick(DialogInterface dialog, int which) {\n                        switch (which) {\n                            case R.id.help:\n                                q.toast(\"Help me!\");\n                                break;\n                        }\n                    }\n                }).show();\n\n```\n- You can also add action items in builder.\n\nAction items manipulate\n========\n\nYou can get a menu object from bottomsheet instance from 1.1.0, and change it as you want, exactly like you're manipulating an android menu or actionbar actionitems.\nPlease be aware that if you change the menu after showing the bottomsheet, you must call invalidate(), or no changes will be applied and your app might crash.\nPlease check example application for more info.\n\n\nStyle\n========\n\n- Invoke darkTheme() to show the built-in dark theme\n- Or define your style in your application, and call bottomsheet by using new BottomSheet.Builder(this,R.style.BottomSheet_StyleDialog)....\n\n```xml\n    \u003cstyle name=\"BottomSheet.StyleDialog\" parent=\"BottomSheet.Dialog\"\u003e\n        \u003citem name=\"android:backgroundDimAmount\"\u003e0.5\u003c/item\u003e\n        \u003citem name=\"android:windowAnimationStyle\"\u003e@style/BottomSheet.Animation\u003c/item\u003e\n        \u003citem name=\"android:textColorPrimary\"\u003e#DDffffff\u003c/item\u003e\n        \u003citem name=\"android:textColorSecondary\"\u003e#8Affffff\u003c/item\u003e\n        \u003citem name=\"android:textColorHint\"\u003e#42ffffff\u003c/item\u003e\n        \u003citem name=\"bs_dialogBackground\"\u003e@color/abc_search_url_text_normal\u003c/item\u003e\n        \u003citem name=\"bs_dividerColor\"\u003e@color/abc_search_url_text_pressed\u003c/item\u003e\n        \u003citem name=\"bs_numColumns\"\u003e4\u003c/item\u003e\n        \u003citem name=\"bs_listStyle\"\u003e@style/BottomSheet.StyleList\u003c/item\u003e\n    \u003c/style\u003e\n```\n- Or set bottomesheet style in your activity theme\n\n```xml\n    \u003cstyle name=\"StyleTheme\" parent=\"Theme.AppCompat\"\u003e\n        \u003citem name=\"bs_bottomSheetStyle\"\u003e@style/BottomSheet.StyleDialog\u003c/item\u003e\n    \u003c/style\u003e\n```\n\n\nContribute\n=======\n\n- Feel free to fork it\n\nAbout me\n=======\n\nI'm Kai, an 32 years old android developer based in Sydney.\n\n\nLicense\n=======\n\n    Copyright 2011, 2015 Kai Liao\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoarcn%2FBottomSheet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoarcn%2FBottomSheet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoarcn%2FBottomSheet/lists"}