Visit GitHub RepoMenus


Android Arsenal

screenshot screenshot screenshot screenshot screenshot


  • Both list and grid style
  • Custom Views
  • Simple Messages
  • Light and Dark theme as well as custom themeing options
  • XML style support
  • Tablet support
  • Share Intent Picker
  • API 14+

Using BottomSheet

To get started using BottomSheet, first you'll need to create a menu resource file with the defined actions.

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="">

        android:title="Share" />

        android:title="Upload" />

        android:title="Copy" />

        android:title="Print" />


Then create a BottomSheet via the Builder interface

new BottomSheet.Builder(getActivity())

Simple Messages

BottomSheet can also display a simple message like a standard dialog. Setting one up is just as simple

new BottomSheet.Builder(this)

To handle which button was pressed, the onSheetDismissed(BottomSheet bottomSheet, @DismissEvent int dismissEvent) will supply the DismissEvent that occurred. Possible values are: DISMISS_EVENT_BUTTON_POSITIVE, DISMISS_EVENT_BUTTON_NEGATIVE, DISMISS_EVENT_BUTTON_NEUTRAL, DISMISS_EVENT_SWIPE, and DISMISS_EVENT_MANUAL

Custom Views

For even further customization, you can set the BottomSheet to use a custom view.

View v = ...

new BottomSheet.Builder(this)

There are a few limitations when using a custom view. First, it MUST have a background set or it will appear transparent. Second, the root layout dimensions should always be layout_width="match_parent and layout_height="wrap_content. Lastly, you will need to manage any click events as the BottomSheetListener can not determine anything from your custom view. If setting a custom view, all other builder settings will be ignored.


BottomSheet comes with both a Light and Dark theme to accommodate most scenarios. However, if you want to customize the color more, you can create your own style and supply it to the builder.
Customizable attributes are:

<!-- The background color of the Bottomsheet -->
<attr name="bottom_sheet_bg_color" format="color" />
<!-- The text appearance of the title -->
<attr name="bottom_sheet_title_text_appearance" format="reference" />
<!-- The text appearance of the list items -->
<attr name="bottom_sheet_list_text_appearance" format="reference" />
<!-- The text appearance of the grid items -->
<attr name="bottom_sheet_grid_text_appearance" format="reference" />
<!-- The text appearance of the message -->
<attr name="bottom_sheet_message_text_appearance" format="reference" />
<!-- The text appearance of the title for a message Bottomsheet-->
<attr name="bottom_sheet_message_title_text_appearance" format="reference" />
<!-- The text appearance of the buttons -->
<attr name="bottom_sheet_button_text_appearance" format="reference" />
<!-- The color to tint the Bottomsheet icon -->
<attr name="bottom_sheet_item_icon_color" format="color" />
<!-- The spacing between grid items -->
<attr name="bottom_sheet_grid_spacing" format="dimension" />
<!-- The bottom padding of the grid -->
<attr name="bottom_sheet_grid_bottom_padding" format="dimension" />
<!-- The top padding of the grid -->
<attr name="bottom_sheet_grid_top_padding" format="dimension" />
<!-- The selector to be used for the items in the list/grid -->
<attr name="bottom_sheet_selector" format="reference" />
<!-- The number of columns to show when using the grid style -->
<attr name="bottom_sheet_column_count" format="integer" />

Then create a style and pass it into the Builder

<style name="MyBottomSheetStyle" parent="@style/BottomSheet">
    <item name="bottom_sheet_bg_color">@android:color/holo_blue_light</item>
    <item name="bottom_sheet_title_text_appearance">@style/TitleAppearance</item>
    <item name="bottom_sheet_list_text_appearance">@style/ListAppearance</item>
    <item name="bottom_sheet_grid_text_appearance">@style/GridAppearance</item>

<style name="TitleAppearance" parent="BottomSheet.Title.TextAppearance">
    <item name="android:textColor">@android:color/holo_green_light</item>

<style name="ListAppearance" parent="BottomSheet.ListItem.TextAppearance">
    <item name="android:textColor">@android:color/holo_red_light</item>
    <item name="android:textSize">18sp</item>

<style name="GridAppearance" parent="BottomSheet.GridItem.TextAppearance">
    <item name="android:textColor">@android:color/holo_red_light</item>
    <item name="android:textSize">20sp</item>
new BottomSheet.Builder(getActivity(),


Based on the Material Design Guidelines, icons for a linear list styled BottomSheet should be 24dp, where as a grid styled BottomSheet should be 48dp.

Share Intents

BottomSheet 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.

// Create the intent for sharing
Intent intent = new Intent(Intent.ACTION_SEND);
intent.putExtra(Intent.EXTRA_TEXT, "My text to share");
// Pass the intent into the createShareBottomSheet method to generate the BottomSheet.
BottomSheet share = BottomSheet.createShareBottomSheet(getActivity(), intent, "My Title");
// Make sure that it doesn't return null! If the system can not handle the intent, null will be returned.
if (share != null);
// By default, it will be styled as a list. For a grid, pass the boolean value true after the title parameter

For further customization of the share intent including which apps will be either be shown or not shown, see the full signature of createBottomSheet


BottomSheet uses the BottomSheetListener for callbacks

// Called when the BottomSheet it first displayed
onSheetShown(BottomSheet bottomSheet, Object object)

// Called when the BottomSheet has been dismissed. Passed value of dismissEvent signifies how the BottomSheet was dismiss. see [BottomSheetListener]( for possible values
onSheetDismissed(BottomSheet bottomSheet,Object, object, @DismissEvent int dismissEvent)

// Called when an item is selected from the BottomSheet
onSheetItemSelected(BottomSheet bottomSheet, MenuItem item, Object object)

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

allprojects {
    repositories {
        maven { url "" }

Add dependency

dependencies {
    compile 'com.github.Kennyc1012:BottomSheet:2.4.1'


Pull requests are welcomed and encouraged. If you experience any bugs, please file an issue


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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
Become a better Android Developer
Millions of developers are learning at MindOrks

Online Training Program

Featured Blogs

Our Team

MindOrks is Certainly one of the best online blog to stay on top of all the Android development news, coding and design patterns. Finally a blog I can count on to keep myself updated with latest and greatest things happening in Android world.

Vipul Shah
Android Developer

Become Pro in Android by watching videos