Merge pull request #372 from wix/contextualMenu

Add support for ContextualMenu in TopBar

android/app/src/main/java/com/reactnativenavigation/bridge/NavigationReactModule.java

 package com.reactnativenavigation.bridge;
 
+import com.facebook.react.bridge.Callback;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.reactnativenavigation.controllers.NavigationCommandsHandler;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.SnackbarParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import com.reactnativenavigation.params.TitleBarLeftButtonParams;
+import com.reactnativenavigation.params.parsers.ContextualMenuParamsParser;
 import com.reactnativenavigation.params.parsers.SnackbarParamsParser;
 import com.reactnativenavigation.params.parsers.TitleBarButtonParamsParser;
 import com.reactnativenavigation.params.parsers.TitleBarLeftButtonParamsParser;
         SnackbarParams snackbarParams = new SnackbarParamsParser().parse(BundleConverter.toBundle(params));
         NavigationCommandsHandler.showSnackbar(snackbarParams);
     }
+
+    @ReactMethod
+    public void showContextualMenu(final ReadableMap params, final Callback onButtonClicked) {
+        ContextualMenuParams contextualMenuParams =
+                new ContextualMenuParamsParser().parse(BundleConverter.toBundle(params));
+        NavigationCommandsHandler.showContextualMenu(contextualMenuParams, onButtonClicked);
+    }
 }

android/app/src/main/java/com/reactnativenavigation/controllers/NavigationActivity.java

 import android.support.v7.app.AppCompatActivity;
 import android.view.KeyEvent;
 
+import com.facebook.react.bridge.Callback;
 import com.facebook.react.modules.core.DefaultHardwareBackBtnHandler;
 import com.reactnativenavigation.NavigationApplication;
 import com.reactnativenavigation.events.Event;
 import com.reactnativenavigation.layouts.Layout;
 import com.reactnativenavigation.layouts.LayoutFactory;
 import com.reactnativenavigation.params.ActivityParams;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.ScreenParams;
 import com.reactnativenavigation.params.SnackbarParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
         layout.showSnackbar(params);
     }
 
+    public void showContextualMenu(ContextualMenuParams params, Callback onButtonClicked) {
+        layout.showContextualMenu(params, onButtonClicked);
+    }
+
     @Override
     public void onEvent(Event event) {
         if (event.getType().equals(ModalDismissedEvent.TYPE)) {

android/app/src/main/java/com/reactnativenavigation/controllers/NavigationCommandsHandler.java

 import android.content.Intent;
 import android.os.Bundle;
 
+import com.facebook.react.bridge.Callback;
 import com.reactnativenavigation.NavigationApplication;
 import com.reactnativenavigation.params.ActivityParams;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.ScreenParams;
 import com.reactnativenavigation.params.SnackbarParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
             }
         });
     }
+
+    public static void showContextualMenu(final ContextualMenuParams params, final Callback onButtonClicked) {
+        final NavigationActivity currentActivity = NavigationActivity.currentActivity;
+        if (currentActivity == null) {
+            return;
+        }
+
+        NavigationApplication.instance.runOnMainThread(new Runnable() {
+            @Override
+            public void run() {
+                currentActivity.showContextualMenu(params, onButtonClicked);
+            }
+        });
+    }
 }

android/app/src/main/java/com/reactnativenavigation/events/ContextualMenuHiddenEvent.java

+package com.reactnativenavigation.events;
+
+public class ContextualMenuHiddenEvent implements Event {
+    public static final String TYPE = "ContextualMenuDismissed";
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+}

android/app/src/main/java/com/reactnativenavigation/events/ViewPagerScreenChangedEvent.java

+package com.reactnativenavigation.events;
+
+public class ViewPagerScreenChangedEvent implements Event {
+    public static final String TYPE = "ViewPagerScreenChangedEvent";
+
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+}

android/app/src/main/java/com/reactnativenavigation/layouts/BottomTabsLayout.java

 import android.widget.RelativeLayout;
 
 import com.aurelhubert.ahbottomnavigation.AHBottomNavigation;
+import com.facebook.react.bridge.Callback;
 import com.reactnativenavigation.NavigationApplication;
 import com.reactnativenavigation.events.EventBus;
 import com.reactnativenavigation.events.ScreenChangedEvent;
 import com.reactnativenavigation.params.ActivityParams;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.ScreenParams;
 import com.reactnativenavigation.params.SideMenuParams;
 import com.reactnativenavigation.params.SnackbarParams;
         return false;
     }
 
+    @Override
+    public void showContextualMenu(ContextualMenuParams params, Callback onButtonClicked) {
+        getCurrentScreenStack().peek().showContextualMenu(params, onButtonClicked);
+    }
+
     public void selectBottomTabByTabIndex(Integer index) {
         bottomTabs.setCurrentItem(index);
     }

android/app/src/main/java/com/reactnativenavigation/layouts/Layout.java

 
 import android.view.View;
 
+import com.facebook.react.bridge.Callback;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.SnackbarParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import com.reactnativenavigation.params.TitleBarLeftButtonParams;
     void onModalDismissed();
 
     boolean containsNavigator(String navigatorId);
+
+    void showContextualMenu(ContextualMenuParams params, Callback onButtonClicked);
 }

android/app/src/main/java/com/reactnativenavigation/layouts/SingleScreenLayout.java

 import android.view.View;
 import android.widget.RelativeLayout;
 
+import com.facebook.react.bridge.Callback;
 import com.reactnativenavigation.NavigationApplication;
 import com.reactnativenavigation.events.EventBus;
 import com.reactnativenavigation.events.ScreenChangedEvent;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.ScreenParams;
 import com.reactnativenavigation.params.SideMenuParams;
 import com.reactnativenavigation.params.SnackbarParams;
         return stack.getNavigatorId().equals(navigatorId);
     }
 
+    @Override
+    public void showContextualMenu(ContextualMenuParams params, Callback onButtonClicked) {
+        stack.peek().showContextualMenu(params, onButtonClicked);
+    }
+
     @Override
     public boolean onTitleBarBackButtonClick() {
         if (leftButtonOnClickListener != null) {

android/app/src/main/java/com/reactnativenavigation/params/BaseTitleBarButtonParams.java

+package com.reactnativenavigation.params;
+
+import android.graphics.drawable.Drawable;
+import android.view.MenuItem;
+
+public class BaseTitleBarButtonParams {
+    public enum ShowAsAction {
+        IfRoom(MenuItem.SHOW_AS_ACTION_IF_ROOM),
+        Always(MenuItem.SHOW_AS_ACTION_ALWAYS),
+        Never(MenuItem.SHOW_AS_ACTION_NEVER),
+        WithText(MenuItem.SHOW_AS_ACTION_WITH_TEXT);
+
+        public final int action;
+
+        ShowAsAction(int action) {
+            this.action = action;
+        }
+    }
+
+    public String eventId;
+    public String label;
+    public Drawable icon;
+    public StyleParams.Color color;
+    public StyleParams.Color disabledColor;
+    public ShowAsAction showAsAction;
+    public boolean enabled = true;
+
+    public void setColorFromScreenStyle(StyleParams.Color titleBarButtonColor) {
+        if (!color.hasColor() && titleBarButtonColor.hasColor()) {
+            color = titleBarButtonColor;
+        }
+    }
+}

android/app/src/main/java/com/reactnativenavigation/params/ContextualMenuButtonParams.java

+package com.reactnativenavigation.params;
+
+public class ContextualMenuButtonParams extends TitleBarButtonParams {
+    public int index;
+}

android/app/src/main/java/com/reactnativenavigation/params/ContextualMenuParams.java

+package com.reactnativenavigation.params;
+
+import java.util.List;
+
+public class ContextualMenuParams {
+    public List<ContextualMenuButtonParams> buttons;
+    public TitleBarLeftButtonParams leftButton;
+    public NavigationParams navigationParams;
+
+    public void setButtonsColor(StyleParams.Color buttonColor) {
+        for (ContextualMenuButtonParams button : buttons) {
+            button.setColorFromScreenStyle(buttonColor);
+        }
+        leftButton.setColorFromScreenStyle(buttonColor);
+    }
+}

android/app/src/main/java/com/reactnativenavigation/params/StyleParams.java

     }
 
     public Color statusBarColor;
+    public Color contextualMenuStatusBarColor;
+    public Color contextualMenuButtonsColor;
+    public Color contextualMenuBackgroundColor;
 
     public Color topBarColor;
     public boolean topBarHidden;

android/app/src/main/java/com/reactnativenavigation/params/TitleBarButtonParams.java

 package com.reactnativenavigation.params;
 
-import android.graphics.drawable.Drawable;
-import android.view.MenuItem;
-
-public class TitleBarButtonParams {
-    public enum ShowAsAction {
-        IfRoom(MenuItem.SHOW_AS_ACTION_IF_ROOM),
-        Always(MenuItem.SHOW_AS_ACTION_ALWAYS),
-        Never(MenuItem.SHOW_AS_ACTION_NEVER),
-        WithText(MenuItem.SHOW_AS_ACTION_WITH_TEXT);
-
-        public final int action;
-
-        ShowAsAction(int action) {
-            this.action = action;
-        }
-    }
-
+public class TitleBarButtonParams extends BaseTitleBarButtonParams {
     public String eventId;
-    public String label;
-    public Drawable icon;
     public StyleParams.Color color;
     public StyleParams.Color disabledColor;
-    public ShowAsAction showAsAction;
     public boolean enabled = true;
 
     public void setColorFromScreenStyle(StyleParams.Color titleBarButtonColor) {

android/app/src/main/java/com/reactnativenavigation/params/parsers/ContextualMenuButtonParamsParser.java

+package com.reactnativenavigation.params.parsers;
+
+import android.os.Bundle;
+
+import com.reactnativenavigation.params.ContextualMenuButtonParams;
+import com.reactnativenavigation.params.StyleParams;
+import com.reactnativenavigation.react.ImageLoader;
+
+import java.util.List;
+
+public class ContextualMenuButtonParamsParser extends TitleBarButtonParamsParser {
+    public List<ContextualMenuButtonParams> parseContextualMenuButtons(Bundle params) {
+        return parseBundle(params, new ParseStrategy<ContextualMenuButtonParams>() {
+            @Override
+            public ContextualMenuButtonParams parse(Bundle button) {
+                return parseSingleContextualMenuButton(button);
+            }
+        });
+    }
+
+    private ContextualMenuButtonParams parseSingleContextualMenuButton(Bundle button) {
+        ContextualMenuButtonParams result = new ContextualMenuButtonParams();
+        result.icon = ImageLoader.loadImage(button.getString("icon"));
+        result.showAsAction = parseShowAsAction(button.getString("showAsAction"));
+        result.color = StyleParams.Color.parse(button.getString("color"));
+        result.label = button.getString("label");
+        result.index = (int) button.getDouble("index");
+        return result;
+    }
+}

android/app/src/main/java/com/reactnativenavigation/params/parsers/ContextualMenuParamsParser.java

+package com.reactnativenavigation.params.parsers;
+
+import android.os.Bundle;
+
+import com.reactnativenavigation.params.ContextualMenuParams;
+import com.reactnativenavigation.params.NavigationParams;
+
+public class ContextualMenuParamsParser extends Parser {
+    public ContextualMenuParams parse(Bundle bundle) {
+        ContextualMenuParams result = new ContextualMenuParams();
+        result.buttons = new ContextualMenuButtonParamsParser().parseContextualMenuButtons(bundle.getBundle("buttons"));
+        result.leftButton = new TitleBarLeftButtonParamsParser().parseSingleButton(bundle.getBundle("backButton"));
+        result.navigationParams = new NavigationParams(bundle.getBundle("navigationParams"));
+        return result;
+    }
+}

android/app/src/main/java/com/reactnativenavigation/params/parsers/ScreenParamsParser.java

     private static final String TOP_TABS = "topTabs";
     private static final String FRAGMENT_CREATOR_CLASS_NAME = "fragmentCreatorClassName";
     private static final String FRAGMENT_CREATOR_PASS_PROPS = "fragmentCreatorPassProps";
-    public static final String OVERRIDE_BACK_PRESS = "overrideBackPress";
+    private static final String OVERRIDE_BACK_PRESS = "overrideBackPress";
 
     @SuppressWarnings("ConstantConditions")
     public static ScreenParams parse(Bundle params) {
         return topTabParams;
     }
 
-    public List<ScreenParams> parseTabs(Bundle params) {
+    List<ScreenParams> parseTabs(Bundle params) {
         return parseBundle(params, new ParseStrategy<ScreenParams>() {
             @Override
             public ScreenParams parse(Bundle screen) {

android/app/src/main/java/com/reactnativenavigation/params/parsers/StyleParamsParser.java

         }
 
         result.statusBarColor = getColor("statusBarColor", getDefaultStatusBarColor());
+        result.contextualMenuStatusBarColor = getColor("contextualMenuStatusBarColor", getDefaultContextualMenuStatusBarColor());
+        result.contextualMenuButtonsColor = getColor("contextualMenuButtonsColor", getDefaultContextualMenuButtonsColor());
+        result.contextualMenuBackgroundColor = getColor("contextualMenuBackgroundColor", getDefaultContextualMenuBackgroundColor());
 
         result.topBarColor = getColor("topBarColor", getDefaultTopBarColor());
         result.titleBarHidden = getBoolean("titleBarHidden", getDefaultTopBarHidden());
         return result;
     }
 
+    private StyleParams.Color getDefaultContextualMenuStatusBarColor() {
+        return new StyleParams.Color(Color.parseColor("#7c7c7c"));
+    }
+
+    private StyleParams.Color getDefaultContextualMenuBackgroundColor() {
+        return new StyleParams.Color(Color.WHITE);
+    }
+
+    private StyleParams.Color getDefaultContextualMenuButtonsColor() {
+        return new StyleParams.Color(Color.parseColor("#757575"));
+    }
+
     private boolean getDefaultDrawScreenAboveBottomTabs() {
         return AppStyle.appStyle == null || AppStyle.appStyle.drawScreenAboveBottomTabs;
     }

android/app/src/main/java/com/reactnativenavigation/params/parsers/TitleBarButtonParamsParser.java

 import android.os.Bundle;
 
 import com.reactnativenavigation.params.AppStyle;
+import com.reactnativenavigation.params.BaseTitleBarButtonParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import com.reactnativenavigation.react.ImageLoader;
 
         return result;
     }
 
-    private static TitleBarButtonParams.ShowAsAction parseShowAsAction(String showAsAction) {
+    protected BaseTitleBarButtonParams.ShowAsAction parseShowAsAction(String showAsAction) {
         if (showAsAction == null) {
-            return TitleBarButtonParams.ShowAsAction.IfRoom;
+            return BaseTitleBarButtonParams.ShowAsAction.IfRoom;
         }
 
         switch (showAsAction) {
             case "always":
-                return TitleBarButtonParams.ShowAsAction.Always;
+                return BaseTitleBarButtonParams.ShowAsAction.Always;
             case "never":
-                return TitleBarButtonParams.ShowAsAction.Never;
+                return BaseTitleBarButtonParams.ShowAsAction.Never;
             case "withText":
-                return TitleBarButtonParams.ShowAsAction.WithText;
+                return BaseTitleBarButtonParams.ShowAsAction.WithText;
             case "ifRoom":
             default:
-                return TitleBarButtonParams.ShowAsAction.IfRoom;
+                return BaseTitleBarButtonParams.ShowAsAction.IfRoom;
         }
     }
 }

android/app/src/main/java/com/reactnativenavigation/screens/ContentViewPagerAdapter.java

 import com.reactnativenavigation.NavigationApplication;
 import com.reactnativenavigation.events.EventBus;
 import com.reactnativenavigation.events.ScreenChangedEvent;
+import com.reactnativenavigation.events.ViewPagerScreenChangedEvent;
 import com.reactnativenavigation.params.PageParams;
 import com.reactnativenavigation.views.ContentView;
 
 import java.util.List;
 
-public class ContentViewPagerAdapter extends PagerAdapter implements ViewPager.OnPageChangeListener {
+class ContentViewPagerAdapter extends PagerAdapter implements ViewPager.OnPageChangeListener {
     private List<ContentView> contentViews;
     private List<PageParams> pageParams;
     private int currentPosition = 0;
 
-    public ContentViewPagerAdapter(List<ContentView> contentViews, List<PageParams> pageParams) {
+    ContentViewPagerAdapter(List<ContentView> contentViews, List<PageParams> pageParams) {
         this.contentViews = contentViews;
         this.pageParams = pageParams;
     }
 
     @Override
     public void onPageSelected(int position) {
+        EventBus.instance.post(new ViewPagerScreenChangedEvent());
         currentPosition = position;
         EventBus.instance.post(new ScreenChangedEvent(pageParams.get(currentPosition)));
         sendTabSelectedEventToJs();

android/app/src/main/java/com/reactnativenavigation/screens/FragmentScreen.java

         contentView.unmountReactView();
     }
 
+    @Override
+    public String getNavigatorEventId() {
+        return screenParams.getNavigatorEventId();
+    }
+
     @Override
     public void setOnDisplayListener(final OnDisplayListener onContentViewDisplayedListener) {
         ViewUtils.runOnPreDraw(content, new Runnable() {

android/app/src/main/java/com/reactnativenavigation/screens/Screen.java

 import android.view.Window;
 import android.widget.RelativeLayout;
 
+import com.facebook.react.bridge.Callback;
 import com.reactnativenavigation.animation.VisibilityAnimator;
+import com.reactnativenavigation.events.ContextualMenuHiddenEvent;
+import com.reactnativenavigation.events.Event;
+import com.reactnativenavigation.events.EventBus;
+import com.reactnativenavigation.events.Subscriber;
+import com.reactnativenavigation.events.ViewPagerScreenChangedEvent;
 import com.reactnativenavigation.params.BaseScreenParams;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.ScreenParams;
 import com.reactnativenavigation.params.StyleParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import static android.view.ViewGroup.LayoutParams.MATCH_PARENT;
 import static android.view.ViewGroup.LayoutParams.WRAP_CONTENT;
 
-public abstract class Screen extends RelativeLayout {
+public abstract class Screen extends RelativeLayout implements Subscriber {
 
     public interface OnDisplayListener {
         void onDisplay();
         this.leftButtonOnClickListener = leftButtonOnClickListener;
         screenAnimator = new ScreenAnimator(this);
         createViews();
+        EventBus.instance.register(this);
+    }
+
+    @Override
+    public void onEvent(Event event) {
+        if (ContextualMenuHiddenEvent.TYPE.equals(event.getType()) && isShown()) {
+            setStyle();
+            topBar.onContextualMenuHidden();
+        }
+        if (ViewPagerScreenChangedEvent.TYPE.equals(event.getType()) && isShown() ) {
+            setStyle();
+            topBar.dismissContextualMenu();
+        }
     }
 
     public void setStyle() {
         return screenParams.getScreenInstanceId();
     }
 
-    public String getNavigatorEventId() {
-        return screenParams.getNavigatorEventId();
-    }
+    public abstract String getNavigatorEventId();
 
     public BaseScreenParams getScreenParams() {
         return screenParams;
     public void hide(boolean animated, Runnable onAnimatedEnd) {
         screenAnimator.hide(animated, onAnimatedEnd);
     }
+
+    public void showContextualMenu(ContextualMenuParams params, Callback onButtonClicked) {
+        params.setButtonsColor(styleParams.contextualMenuButtonsColor);
+        topBar.showContextualMenu(params, styleParams.contextualMenuBackgroundColor, onButtonClicked);
+        setStatusBarColor(styleParams.contextualMenuStatusBarColor);
+    }
+
+    public void destroy() {
+        unmountReactView();
+        EventBus.instance.unregister(this);
+    }
 }

android/app/src/main/java/com/reactnativenavigation/screens/ScreenStack.java

 
     public void destroy() {
         for (Screen screen : stack) {
-            screen.unmountReactView();
+            screen.destroy();
             parent.removeView(screen);
         }
         stack.clear();

android/app/src/main/java/com/reactnativenavigation/screens/SingleScreen.java

         contentView.unmountReactView();
     }
 
+    @Override
+    public String getNavigatorEventId() {
+        return screenParams.getNavigatorEventId();
+    }
+
     @Override
     public void setOnDisplayListener(OnDisplayListener onContentViewDisplayedListener) {
         contentView.setOnDisplayListener(onContentViewDisplayedListener);

android/app/src/main/java/com/reactnativenavigation/views/ContextualMenu.java

+package com.reactnativenavigation.views;
+
+import android.content.Context;
+import android.view.Menu;
+
+import com.facebook.react.bridge.Callback;
+import com.reactnativenavigation.NavigationApplication;
+import com.reactnativenavigation.events.ContextualMenuHiddenEvent;
+import com.reactnativenavigation.events.EventBus;
+import com.reactnativenavigation.params.ContextualMenuButtonParams;
+import com.reactnativenavigation.params.ContextualMenuParams;
+import com.reactnativenavigation.params.StyleParams;
+import com.reactnativenavigation.params.TitleBarLeftButtonParams;
+
+import java.util.List;
+
+public class ContextualMenu extends TitleBar implements LeftButtonOnClickListener, ContextualMenuButton.ContextualButtonClickListener {
+    private Callback onButtonClicked;
+    private final String navigatorEventId;
+
+    public ContextualMenu(Context context, ContextualMenuParams params, StyleParams.Color contextualMenuBackgroundColor, Callback onButtonClicked) {
+        super(context);
+        this.onButtonClicked = onButtonClicked;
+        navigatorEventId = params.navigationParams.navigatorEventId;
+        setStyle(contextualMenuBackgroundColor);
+        setButtons(params.buttons, params.leftButton);
+    }
+
+    public void setStyle(StyleParams.Color contextualMenuBackgroundColor) {
+        if (contextualMenuBackgroundColor.hasColor()) {
+            setBackgroundColor(contextualMenuBackgroundColor.getColor());
+        }
+    }
+
+    public void setButtons(List<ContextualMenuButtonParams> buttons, TitleBarLeftButtonParams leftButton) {
+        addButtonsToContextualMenu(buttons, getMenu());
+        setBackButton(leftButton);
+    }
+
+    private void setBackButton(TitleBarLeftButtonParams leftButton) {
+        setLeftButton(leftButton, this, null, false);
+    }
+
+    private void addButtonsToContextualMenu(List<ContextualMenuButtonParams> buttons, Menu menu) {
+        for (int i = 0; i < buttons.size(); i++) {
+            final TitleBarButton button = new ContextualMenuButton(menu, this, buttons.get(i), this);
+            addButtonInReverseOrder(buttons, i, button);
+        }
+    }
+
+    @Override
+    public boolean onTitleBarBackButtonClick() {
+        dismiss();
+        EventBus.instance.post(new ContextualMenuHiddenEvent());
+        return true;
+    }
+
+    @Override
+    public void onSideMenuButtonClick() {
+        // nothing
+    }
+
+    @Override
+    public void onClick(int index) {
+        dismiss();
+        EventBus.instance.post(new ContextualMenuHiddenEvent());
+        onButtonClicked.invoke(index);
+    }
+
+    public void dismiss() {
+        hide();
+        NavigationApplication.instance.sendNavigatorEvent("contextualMenuDismissed", navigatorEventId);
+    }
+}

android/app/src/main/java/com/reactnativenavigation/views/ContextualMenuButton.java

+package com.reactnativenavigation.views;
+
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+
+import com.reactnativenavigation.params.ContextualMenuButtonParams;
+
+class ContextualMenuButton extends TitleBarButton {
+    private ContextualMenuButtonParams contextualMenuButtonParams;
+    private ContextualButtonClickListener contextualButtonClickListener;
+
+    interface ContextualButtonClickListener {
+        void onClick(int index);
+    }
+
+    ContextualMenuButton(Menu menu, View parent, ContextualMenuButtonParams contextualMenuButtonParams, ContextualButtonClickListener contextualButtonClickListener) {
+        super(menu, parent, contextualMenuButtonParams, null);
+        this.contextualMenuButtonParams = contextualMenuButtonParams;
+        this.contextualButtonClickListener = contextualButtonClickListener;
+    }
+
+    @Override
+    public boolean onMenuItemClick(MenuItem item) {
+        contextualButtonClickListener.onClick(contextualMenuButtonParams.index);
+        return true;
+    }
+}

android/app/src/main/java/com/reactnativenavigation/views/TitleBar.java

 import android.support.v7.widget.Toolbar;
 import android.view.Menu;
 import android.view.View;
+import android.view.animation.AccelerateDecelerateInterpolator;
+import android.view.animation.AccelerateInterpolator;
 
 import com.reactnativenavigation.animation.VisibilityAnimator;
+import com.reactnativenavigation.params.BaseTitleBarButtonParams;
 import com.reactnativenavigation.params.StyleParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import com.reactnativenavigation.params.TitleBarLeftButtonParams;
     }
 
     public void setLeftButton(TitleBarLeftButtonParams leftButtonParams,
-                              LeftButtonOnClickListener leftButtonOnClickListener, String navigatorEventId, boolean overrideBackPressInJs) {
+                              LeftButtonOnClickListener leftButtonOnClickListener,
+                              String navigatorEventId,
+                              boolean overrideBackPressInJs) {
         if (shouldSetLeftButton(leftButtonParams)) {
             createAndSetLeftButton(leftButtonParams, leftButtonOnClickListener, navigatorEventId, overrideBackPressInJs);
         } else if (hasLeftButton()) {
         }
     }
 
-    private void addButtonInReverseOrder(List<TitleBarButtonParams> rightButtons, int i, TitleBarButton button) {
-        final int index = rightButtons.size() - i - 1;
+    protected void addButtonInReverseOrder(List<? extends BaseTitleBarButtonParams> buttons, int i, TitleBarButton button) {
+        final int index = buttons.size() - i - 1;
         button.addToMenu(index);
     }
 
     private void createScrollAnimator() {
         visibilityAnimator = new VisibilityAnimator(this, VisibilityAnimator.HideDirection.Up, getHeight());
     }
+
+    public void hide() {
+        animate()
+                .alpha(0)
+                .setDuration(200)
+                .setInterpolator(new AccelerateInterpolator());
+    }
+
+    public void show() {
+        if (getAlpha() == 1) {
+            return;
+        }
+
+        setAlpha(0);
+        animate()
+                .alpha(1)
+                .setDuration(200)
+                .setInterpolator(new AccelerateDecelerateInterpolator());
+    }
 }

android/app/src/main/java/com/reactnativenavigation/views/TitleBarButton.java

 package com.reactnativenavigation.views;
 
 import android.support.annotation.NonNull;
+import android.support.annotation.Nullable;
 import android.view.Menu;
 import android.view.MenuItem;
 import android.view.View;
 
 import java.util.ArrayList;
 
-public class TitleBarButton implements MenuItem.OnMenuItemClickListener {
+class TitleBarButton implements MenuItem.OnMenuItemClickListener {
 
     private final Menu menu;
     private final View parent;
-    private TitleBarButtonParams buttonParams;
-    private String navigatorEventId;
+    protected TitleBarButtonParams buttonParams;
+    @Nullable private String navigatorEventId;
 
-    public TitleBarButton(Menu menu, View parent, TitleBarButtonParams buttonParams, String navigatorEventId) {
+    TitleBarButton(Menu menu, View parent, TitleBarButtonParams buttonParams, @Nullable String navigatorEventId) {
         this.menu = menu;
         this.parent = parent;
         this.buttonParams = buttonParams;
         this.navigatorEventId = navigatorEventId;
     }
 
-    public MenuItem addToMenu(int index) {
+    MenuItem addToMenu(int index) {
         MenuItem item = menu.add(Menu.NONE, Menu.NONE, index, buttonParams.label);
         item.setShowAsAction(buttonParams.showAsAction.action);
         item.setEnabled(buttonParams.enabled);

android/app/src/main/java/com/reactnativenavigation/views/TopBar.java

 import android.os.Build;
 import android.support.design.widget.AppBarLayout;
 import android.support.design.widget.TabLayout;
+import android.view.ViewGroup;
+import android.widget.RelativeLayout;
 
+import com.facebook.react.bridge.Callback;
+import com.reactnativenavigation.params.ContextualMenuParams;
 import com.reactnativenavigation.params.StyleParams;
 import com.reactnativenavigation.params.TitleBarButtonParams;
 import com.reactnativenavigation.params.TitleBarLeftButtonParams;
 
 import java.util.List;
 
+import static android.view.ViewGroup.LayoutParams.MATCH_PARENT;
+import static android.view.ViewGroup.LayoutParams.WRAP_CONTENT;
+
 public class TopBar extends AppBarLayout {
 
     private TitleBar titleBar;
+    private ContextualMenu contextualMenu;
+    private RelativeLayout titleBarAndContextualMenuContainer;
     private TopTabs topTabs;
 
     public TopBar(Context context) {
         super(context);
         setFitsSystemWindows(true);
         setId(ViewUtils.generateViewId());
+        createLayout();
+    }
+
+    private void createLayout() {
+        titleBarAndContextualMenuContainer = new RelativeLayout(getContext());
+        addView(titleBarAndContextualMenuContainer);
     }
 
     public void addTitleBarAndSetButtons(List<TitleBarButtonParams> rightButtons,
                                          LeftButtonOnClickListener leftButtonOnClickListener,
                                          String navigatorEventId, boolean overrideBackPressInJs) {
         titleBar = new TitleBar(getContext());
-        addView(titleBar);
+        titleBarAndContextualMenuContainer.addView(titleBar, new ViewGroup.LayoutParams(MATCH_PARENT, WRAP_CONTENT));
         titleBar.setRightButtons(rightButtons, navigatorEventId);
         titleBar.setLeftButton(leftButton, leftButtonOnClickListener, navigatorEventId, overrideBackPressInJs);
     }
         if (topTabs == null) {
             return;
         }
-
         topTabs.setTopTabsTextColor(style);
         topTabs.setSelectedTabIndicatorStyle(style);
     }
+
+    public void showContextualMenu(final ContextualMenuParams params, StyleParams.Color contextualMenuBackgroundColor, Callback onButtonClicked) {
+        contextualMenu = new ContextualMenu(getContext(), params, contextualMenuBackgroundColor, onButtonClicked);
+        titleBarAndContextualMenuContainer.addView(contextualMenu, new ViewGroup.LayoutParams(MATCH_PARENT, WRAP_CONTENT));
+        ViewUtils.runOnPreDraw(contextualMenu, new Runnable() {
+            @Override
+            public void run() {
+                titleBar.hide();
+                contextualMenu.show();
+            }
+        });
+    }
+
+    public void onContextualMenuHidden() {
+        titleBar.show();
+    }
+
+    public void dismissContextualMenu() {
+        if (contextualMenu != null) {
+            contextualMenu.dismiss();
+            contextualMenu = null;
+            titleBar.show();
+        }
+    }
 }

src/Screen.js

     return platformSpecific.showSnackbar(this, params);
   }
 
+  showContextualMenu(params, onButtonPressed) {
+    return platformSpecific.showContextualMenu(this, params, onButtonPressed);
+  }
+
   setOnNavigatorEvent(callback) {
     this.navigatorEventHandler = callback;
     if (!this.navigatorEventSubscription) {

src/deprecated/platformSpecificDeprecated.android.js

 /*eslint-disable*/
 import React, {Component} from 'react';
-import {AppRegistry, NativeModules} from 'react-native';
+import {AppRegistry, NativeModules, processColor} from 'react-native';
 import _ from 'lodash';
 
 import Navigation from './../Navigation';
 function getLeftButton(screen) {
   const leftButton = getLeftButtonDeprecated(screen);
   if (leftButton) {
-    console.warn('leftButton is deprecated. Instead, please use leftButtons like on iOS.');
     return leftButton;
   }
 
   return newPlatformSpecific.showSnackbar(params);
 }
 
+function showContextualMenu(navigator, params, onButtonPressed) {
+  const contextualMenu = {
+    buttons: [],
+    backButton: {id: 'back'},
+    navigationParams: {navigatorEventID: navigator.navigatorEventID}
+  };
+
+  params.rightButtons.forEach((button, index) => {
+    const btn = {
+      icon: resolveAssetSource(button.icon).uri,
+      color: processColor(button.color),
+      label: button.title,
+      index
+    };
+    contextualMenu.buttons.push(btn);
+  });
+
+  newPlatformSpecific.showContextualMenu(contextualMenu, onButtonPressed);
+}
+
 export default {
   startTabBasedApp,
   startSingleScreenApp,
   navigatorToggleDrawer,
   navigatorToggleTabs,
   navigatorToggleNavBar,
-  showSnackbar
+  showSnackbar,
+  showContextualMenu
 };

src/platformSpecific.android.js

   NativeReactModule.showSnackbar(params);
 }
 
+function showContextualMenu(params, onButtonPressed) {
+  NativeReactModule.showContextualMenu(params, onButtonPressed);
+}
+
 module.exports = {
   startApp,
   push,
   selectBottomTabByTabIndex,
   setBottomTabBadgeByNavigatorId,
   setBottomTabBadgeByIndex,
-  showSnackbar
+  showSnackbar,
+  showContextualMenu
 };