Context-Menu.Android


Source link: https://github.com/Yalantis/Context-Menu.Android

ContextMenu

You can easily add awesome animated context menu to your app.

Check this [project on dribbble] ( https://dribbble.com/shots/1785274-Menu-Animation-for-Additional-Functions?list=users&offset=17)

Check this [project on Behance] ( https://www.behance.net/gallery/20411445/Mobile-Animations-Interactions)

Usage:

For a working implementation, have a look at the app module

1. Clone repository and add sources into your project or use Gradle:

compile 'com.yalantis:contextmenu:1.0.7'

2. Create list of MenuObject, which consists of icon or icon and description.

You can use any resource, bitmap, drawable, color as image:


 item.setResource(...)

 item.setBitmap(...)

 item.setDrawable(...)

 item.setColor(...)

You can set image ScaleType:


 item.setScaleType(ScaleType.FIT_XY) 

You can use any resource, drawable, color as background:


 item.setBgResource(...)
  item.setBgDrawable(...)
  item.setBgColor(...) 

Now You can easily add text appearance style for menu titles:

 In your project styles create style for text appearance  (For better visual effect extend it from TextView.DefaultStyle):
  <style name="TextViewStyle" parent="TextView.DefaultStyle">

<item name="android:textStyle">italic|bold</item>

<item name="android:textColor">#26D0EB</item>
</style>  And set it's id to your MenuObject :

MenuObject addFr = new MenuObject("Add to friends");

BitmapDrawable bd = new BitmapDrawable(getResources(),

  BitmapFactory.decodeResource(getResources(), R.drawable.icn_3));

addFr.setDrawable(bd);

addFr.setMenuTextAppearanceStyle(R.style.TextViewStyle);
  

You can set any color as divider color:


 item.setDividerColor(...) 

Example:


 MenuObject close = new MenuObject();

  close.setResource(R.drawable.icn_close);

MenuObject send = new MenuObject("Send message");

  send.setResource(R.drawable.icn_1);

List<MenuObject> menuObjects = new ArrayList<>();

  menuObjects.add(close);

  menuObjects.add(send);
 

3. Create newInstance of ContextMenuDialogFragment, which received MenuParams object.


 MenuParams menuParams = new MenuParams();

  menuParams.setActionBarSize((int) getResources().getDimension(R.dimen.tool_bar_height));

  menuParams.setMenuObjects(getMenuObjects());

  menuParams.setClosableOutside(true);

  // set other settings to meet your needs
  mMenuDialogFragment = ContextMenuDialogFragment.newInstance(menuParams);
 

4. Set menu with button, which will open ContextMenuDialogFragment.


 @Override
  public boolean onCreateOptionsMenu(final Menu menu) {

MenuInflater inflater = getMenuInflater();

inflater.inflate(R.menu.menu_main, menu);

return true;
  
}

@Override
  public boolean onOptionsItemSelected(MenuItem item) {

switch (item.getItemId()) {

 case R.id.context_menu:

  mMenuDialogFragment.show(fragmentManager, "ContextMenuDialogFragment");

  break;

}

return super.onOptionsItemSelected(item);

  
}
 

5. Implement OnMenuItemClickListener interface with onMenuItemClick method.

public class MainActivity extends ActionBarActivity implements OnMenuItemClickListener …
  @Override
  public void onMenuItemClick(View clickedView, int position) {

 //Do something here
  
}
 …
  mMenuDialogFragment.setItemClickListener(this);
 

Customization:

For better experience menu item size should be equal to ActionBar height.

newInstance of ContextMenuDialogFragment receives MenuParams object that has the fields:

mMenuObjects - list of MenuObject objects,

mAnimationDelay - delay in millis after fragment opening and before closing, which will make animation smoother on slow devices,

nAnimationDuration - duration of every piece of animation in millis,

isClosableOutside - if menu can be closed on touch to non-button area,

isFitSystemWindows - if true, then the default implementation of fitSystemWindows(Rect) will be executed,

isClipToPadding - true to clip children to the padding of the group, false otherwise.

The last two parameters may be useful if you use Translucent parameters in your theme:


 <item name="android:windowTranslucentStatus">true</item> 

To stay Context Menu below Status Bar set fitSystemWindows to true and clipToPadding to false.

Compatibility

  • Android Honeycomb 3.0+

Changelog

Version: 1.0.7

  • Text in menu now also clickable
  • Support libs and gradle updated

Version: 1.0.6

  • com.android.tools.build:gradle:1.5.0
  • Support libs and sdk updated to 23

Version: 1.0.5

  • Fixed setClosableOutside issue.
  • Fixed setAnimationDuration doesn´t work for open event issue.
  • Fixed menu item listener setting mechanism. It can be not activity but any class that implements listeners now. Issue. Attention! You have to set listeners to the context fragment manually. Check block 5 in the Usage.

Version: 1.0.4

  • Old ContextMenuDialogFragment newInstance methods are deprecated. Use new universal one that received MenuParams.
  • Added possibility to dismiss menu by clicking on non-button area. See MenuParams.setClosableOutside(boolean).

Version: 1.0.3

  • Added menu text appearence style. (Note: other text style methods are deprecated).

Version: 1.0.2

  • Changed MenuObject constructors. Image setting is moved to methods
  • Added styling of MenuObject image, background, text color, divider color
  • Added possibility to interact with translucent Status Bar

Version: 1.0.1

  • Added OnMenuItemLongClickListener (usage: the same as OnMenuItemClickListener, check sample app)
  • Renamed:
com.yalantis.contextmenu.lib.ContextMenuDialogFragment.ItemClickListener -> com.yalantis.contextmenu.lib.interfaces.OnMenuItemClickListener  com.yalantis.contextmenu.lib.ContextMenuDialogFragment.ItemClickListener.onItemClick(...) -> com.yalantis.contextmenu.lib.interfaces.OnMenuItemClickListener.onMenuItemClick(...) 

Version: 1.0

  • Pilot version

Let us know!

We’d be really happy if you sent us links to your projects where you use our component. Just send an email to [email protected] And do let us know if you have any questions or suggestion regarding the animation.

P.S. We’re going to publish more awesomeness wrapped in code and a tutorial on how to make UI for Android (iOS) better than better. Stay tuned!

License

Copyright 2017, Yalantis  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. 

Resources

Monitoring, crash reports & statistics.

Asks the user if (s)he wants to open the Play Store to rate your application when certain requirements are met. This can and should be configured to be very cautious. Don't annoy your users!

Infer is a static analysis tool for Java, Objective-C and C, written in OCaml.

You have a small team. Setting up crash reporting tools, event tracking tools, and log management services is not what you want to spend your hours doing. You know these are important to the health of your application, but you just want to code.

That's where Foam comes into play.

This app is a simple Bluetooth connection debugging tool:

  • Connect to a Bluetooth device
  • Display incoming raw data
  • Send raw data to the Bluetooth device

Android library project that intends to simplify the usage of Adapters for ListView/GridView and RecyclerView. You won't have to code any boring adapter again!

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes