Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

com.balysv:material-menu

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

com.balysv:material-menu

Morphing Android menu, back, dismiss and check buttons

  • 1.1.0
  • Source
  • Maven
  • Socket score

Version published
Maintainers
1
Source

Material Menu

Morphing Android menu, back, dismiss and check buttons

Demo Image

Including in your project

The library is available on Maven Central

dependencies {
    compile 'com.balysv:material-menu:1.1.0'
}

Usage

Generally, you should use MaterialMenuDrawable as a standalone drawable in your custom views, etc.

The library provides two wrappers that might ease implementation:

MaterialMenuView

A plain old View that draws the icon and provides an API to manipulate its state.

Customisation is also available through attributes:

app:color="color"               // Color of drawable
app:transformDuration="integer" // Transformation animation duration
app:pressedDuration="integer"   // Pressed circle animation duration
app:scale="integer"             // Scale factor of drawable

MaterialMenuIcon

A POJO that initializes the drawable and replaces the ActionBar icon. See usage in ActionBar below

API

There are four icon states:

BURGER, ARROW, X, CHECK

To morph the drawable state with a pressed circle animation

MaterialMenu.animatePressedState(IconState state)

To morph the drawable state without a pressed circle animation

MaterialMenu.animateState(IconState state)    

To change the drawable state without animation

MaterialMenu.setState(IconState state)

Customisation

// change color
MaterialMenu.setColor(int color)

// change transformation animation duration
MaterialMenu.setTransformationDuration(int duration)

// change pressed animation duration
MaterialMenu.setPressedDuration(int duration)

// change transformation interpolator
MaterialMenu.setInterpolator(Interpolator interpolator)

Action Bar

Use as Action Bar icon (stock only)

In your Activity add the following:

protected void onCreate(Bundle savedInstanceState) {
    materialMenu = new MaterialMenuIcon(this, Color.WHITE);
}

protected void onPostCreate(Bundle savedInstanceState) {
    materialMenu.syncState(savedInstanceState);
}

protected void onSaveInstanceState(Bundle outState) {
    materialMenu.onSaveInstanceState(outState);
}

public boolean onOptionsItemSelected(MenuItem item) {
    if (id == android.R.id.home) {
        // Handle your drawable state here
        materialMenu.animatePressedState(newState);
    }
}

In order to use the new Material circle pressed state, you have to disable ActionBar item backgrounds in your theme and re-enable it for other menu icons

<style name="AppTheme" parent="android:Theme.Holo.Light.DarkActionBar">
    <item name="android:actionBarItemBackground">@null</item>
    <item name="android:actionButtonStyle">@style/ActionButtonStyle</item>
    <item name="android:actionOverflowButtonStyle">@style/OverflowButtonStyle</item>
</style>

<style name="ActionButtonStyle" parent="android:Widget.Holo.ActionButton">
    <item name="android:background">@drawable/action_bar_item_background</item>
</style>

<style name="OverflowButtonStyle" parent="android:Widget.Holo.ActionButton.Overflow">
    <item name="android:background">@drawable/action_bar_item_background</item>
</style>

Otherwise, to disable circle pressed state use

MaterialMenu.setNeverDrawTouch(true)
Use in custom Action Bar view

Simply add MaterialMenuView in your custom layout and register an OnClickListener to do the transformations.

See source of Demo for details

Developed By

Balys Valentukevicius - balys.v@gmail.com @ Lemon Labs

License

Copyright 2014 Balys Valentukevicius

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.

FAQs

Package last updated on 26 Aug 2014

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc