Morphing Android menu, back, dismiss and check buttons
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:
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
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.