# BottomSheetMenu **Repository Path**: netral/BottomSheetMenu ## Basic Information - **Project Name**: BottomSheetMenu - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-11-20 - **Last Updated**: 2021-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # BottomSheetMenu [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-BottomSheet-green.svg?style=flat)](https://android-arsenal.com/details/1/2315) ![screenshot](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/art/list.png) ![screenshot](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/art/grid.png) ![screenshot](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/art/tablet_list.png) ![screenshot](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/art/tablet_grid.png) ![screenshot](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/art/share_list.png) # Features - Both list and grid style - Light and Dark theme as well as custom themeing options - XML style support - Tablet support - Share Intent Picker - API 19+ - Kotlin support # Using BottomSheetMenu To get started using BottomSheetMenu, first you'll need to create a menu resource file with the defined actions. ```xml ``` Then create a BottomSheetMenuDialogFragment via the Builder class using either the Builder method calls for java or named arguments for Kotlin ```java new BottomSheetMenuDialogFragment.Builder(getActivity()) .setSheet(R.menu.bottom_sheet) .setTitle(R.string.options) .setListener(myListener) .setObject(myObject) .show(getSupportFragmentManager()); ``` ```kotilin BottomSheetMenuDialogFragment.Builder(context = this, sheet = R.menu.bottom_sheet, listener = myListener, title = R.string.options, `object` = myObject) .show(supportFragmentManager) ``` # Styling BottomSheetMenu comes with both a Light and Dark theme to accommodate most scenarios. However, if you want to customize itr more, you can create your own style and supply it to the builder.
Customizable attributes are: ```xml ``` Then create a style ```xml ``` Also note that each of these pre-defined styles also have a light theme. They are named similary with a `.Light` added to the end of the style name
`@style/Theme.BottomSheetMenuDialog.Light` `@style/BottomSheetMenu.Title.TextAppearance.Light` etc... Then finally pass the style into the `Builder` object. ```java new BottomSheetMenuDialogFragment.Builder(getActivity(), R.style.MyBottomSheetStyle) .setSheet(R.menu.bottom_sheet) .setTitle(R.string.options) .setListener(myListener) .show(); ``` ```kotlin BottomSheetMenuDialogFragment.Builder(context = this, sheet = R.menu.bottom_sheet, title = R.string.options, listener = myListener, style = R.style.MyBottomSheetStyle) .show(supportFragmentManager) ``` ## Icons Based on the [Material Design Guidelines](http://www.google.com/design/spec/components/bottom-sheets.html#bottom-sheets-specs), icons for a linear list styled BottomSheet should be 24dp, where as a grid styled BottomSheet should be 48dp. # Share Intents BottomSheetMenu can also be used to create a Share Intent Picker that will be styled like the ones found in Android 5.x+. To create one, simply call one of the static ```createShareBottomSheet``` methods. ```kotlin Intent(Intent.ACTION_SEND).apply { type = "text/*" putExtra(Intent.EXTRA_TEXT, "My text to share") // Make sure to check that the createBottomSheet method does not return null!! // If the device can not handle the intent, null will be returned BottomSheetMenuDialogFragment.createShareBottomSheet(context, this, "My Title")?.show(supportFragmentManager, null) } ``` For further customization of the share intent including which apps will be either be shown or not shown, see the full signature of [createBottomSheet](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/library/src/main/java/com/kennyc/bottomsheet/BottomSheetMenuDialogFragment.kt#L50) # Callbacks BottomSheetMenu uses the [BottomSheetListener](https://github.com/Kennyc1012/BottomSheetMenu/blob/master/library/src/main/java/com/kennyc/bottomsheet/BottomSheetListener.kt) for callbacks ```kotlin /** * Called when the [BottomSheetMenuDialogFragment] is first displayed * * @param bottomSheet The [BottomSheetMenuDialogFragment] that was shown * @param object Optional [Object] to pass to the [BottomSheetMenuDialogFragment] */ fun onSheetShown(bottomSheet: BottomSheetMenuDialogFragment, `object`: Any?) /** * Called when an item is selected from the list/grid of the [BottomSheetMenuDialogFragment] * * @param bottomSheet The [BottomSheetMenuDialogFragment] that had an item selected * @param item The item that was selected * @param object Optional [Object] to pass to the [BottomSheetMenuDialogFragment] */ fun onSheetItemSelected(bottomSheet: BottomSheetMenuDialogFragment, item: MenuItem, `object`: Any?) /** * Called when the [BottomSheetMenuDialogFragment] has been dismissed * * @param bottomSheet The [BottomSheetMenuDialogFragment] that was dismissed * @param object Optional [Object] to pass to the [BottomSheetMenuDialogFragment] * @param dismissEvent How the [BottomSheetMenuDialogFragment] was dismissed. Possible values are:

* * [.DISMISS_EVENT_SWIPE] * * [.DISMISS_EVENT_MANUAL] * * [.DISMISS_EVENT_ITEM_SELECTED] */ fun onSheetDismissed(bottomSheet: BottomSheetMenuDialogFragment, `object`: Any?, @DismissEvent dismissEvent: Int) ``` # Upgrading to 3.X - `BottomSheet` has been renamed to `BottomSheetMenuDialogFragment` - Custom views and simple messages are no longer supported. Please use a [BottomSheetDialogFragment](https://developer.android.com/reference/com/google/android/material/bottomsheet/BottomSheetDialogFragment) and customize it from there - Many of the theme attributes have been removed or renamed. See the Styling section above for current values - CollaspingView has been removed. - Migration to [AndroidX](https://developer.android.com/jetpack/androidx/) and [Google Material Components](https://github.com/material-components/material-components-android) - MinSdk is now 19, also targeting API 28 # Upgrading From 1.x When upgrading to 2.x from a 1.x release, some changes will have to be made. - All of the builder methods for settings colors have been removed. All customzing should be done through themes. - The style attributes have been change to text appearances rather than colors. - The Builder constructor no longer takes a menu object. You will need to call ```setSheet(...)```. - The ```onSheetDismissed``` callback now takes an int as an argument for simple message support. - The gradle dependency has changed and needs to be updated. # Including in your project To include BottomSheet in your project, make the following changes to your build.gradle file ## Add repository ```groovy allprojects { repositories { ... maven { url "https://jitpack.io" } } } ``` ## Add dependency ```groovy dependencies { implementation "com.github.Kennyc1012:BottomSheetMenu:3.3.0 ``` # Contribution Pull requests are welcomed and encouraged. If you experience any bugs, please file an [issue](https://github.com/Kennyc1012/BottomSheet/issues) License ======= Copyright 2015 Kenny Campagna 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.