Home

Version Log History ###v1.6.3

• fixed lilpop 5.0 issue
• full screen and transparent nagivation and status bar configurations
• building blocks ready for easy fast implementation

###v1.6.0

• newsfeed abstract for instance implementation
• catelog abstract for showing grid views of items
• simple tree list for expandable list item view - allows many customizations
• menu banners on the list recycler view - allows many customizations

###v1.5.5

• precoded treeview fragment menu

###v1.5.2

• slide in and slide out options
• building external fragment swapping support for both v4 and v13
• precoded fragment support templates
• precoded fragment menu
• profile view menu
• fully slacky support menu layout implementations and customizations

For more detail sample tutorials, please look into the sample code as listed:

• MainActivity

• Demo Right Slide

• System expandable slide

How to Integrate this Library into Your Projects

In order to integrate SlidingMenu into your own projects you can do one of two things.

1. You can wrap your Activities in a SlidingMenu by constructing it programmatically (new SlidingMenu(Context context)) and then calling SlidingMenu.attachToActivity(Activity activity, SlidingMenu.SLIDING_WINDOW | SlidingMenu.SLIDING_CONTENT). SLIDING_WINDOW will include the Title/ActionBar in the content section of the SlidingMenu, while SLIDING_CONTENT does not. You can check it out in the example app AttachExample Activity.

2. You can embed the SlidingMenu at the Activity level by making your Activity extend SlidingAppCompactActivity.

• In your Activity's onCreate method, you will have to use fragment to implement the contents on each view for the menu and the content body by overriding the method getFirstMenuFragment, as usual, and also getInitFragment, which is represent the body of the content. getFirstMenuFragment will place the view in the "behind" portion of the SlidingMenu. You will have access to the customizeSlideMenuEdge method so you can customize the SlidingMenu to your liking.

3. You can use the SlidingMenu view directly in your xml layouts or programmatically in your Java code.

• This way, you can treat SlidingMenu as you would any other view type and put it in crazy awesome places like in the rows of a ListView.
• So. Many. Possibilities.

Very basic simple Example but you are not recommend to do that because you will have to make alot of setup in order to make it work. But this is the simple fundamental idea to implement the SlidingMenu.

public class SlidingExample extends Activity {
	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setTitle(R.string.attach);
		// set the content view
		setContentView(R.layout.content);
		// configure the SlidingMenu
		SlidingMenu menu = new SlidingMenu(this);
                menu.setMode(SlidingMenu.LEFT);
		menu.setTouchModeAbove(SlidingMenu.TOUCHMODE_FULLSCREEN);
		menu.setShadowWidthRes(R.dimen.shadow_width);
		menu.setShadowDrawable(R.drawable.shadow);
		menu.setBehindOffsetRes(R.dimen.slidingmenu_offset);
		menu.setFadeDegree(0.35f);
		menu.attachToActivity(this, SlidingMenu.SLIDING_CONTENT);
		menu.setMenu(R.layout.menu);
	}
    
}

A more advanced implementation form extending SlidingAppCompactActivity so you can forget about the implementation above and focus on this one written as below:

public class SlidingExample extends SlidingAppCompactActivity {
....
    @Override
    protected void customizeSlideMenuEdge(SlidingMenu sm) {
        sm.setFadeDegree(0.35f);
        sm.setMode(SlidingMenu.LEFT);
        sm.setTouchModeAbove(SlidingMenu.TOUCHMODE_MARGIN);
        sm.setBehindScrollScale(0.5f);
        sm.setFadeDegree(0.34f);
        sm.setBehindWidth(840);
        sm.requestLayout();
        sm.invalidate();
    }
...
}

XML Usage

If you decide to use SlidingMenu as a view, you can define it in your xml layouts like this:

<com.hkm.slidingmenulib.gestured.SlidingMenu
    xmlns:sliding="http://schemas.android.com/apk/res-auto"
    android:id="@+id/slidingmenulayout"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    sliding:viewAbove="@layout/YOUR_ABOVE_VIEW"
    sliding:viewBehind="@layout/YOUR_BEHIND_BEHIND"
    sliding:touchModeAbove="margin|fullscreen"
    sliding:behindOffset="@dimen/YOUR_OFFSET"
    sliding:behindWidth="@dimen/YOUR_WIDTH"
    sliding:behindScrollScale="@dimen/YOUR_SCALE"
    sliding:shadowDrawable="@drawable/YOUR_SHADOW"
    sliding:shadowWidth="@dimen/YOUR_SHADOW_WIDTH"
    sliding:fadeEnabled="true|false"
    sliding:fadeDegree="float"
    sliding:selectorEnabled="true|false"
    sliding:selectorDrawable="@drawable/YOUR_SELECTOR"/>

NOTE : you cannot use both behindOffset and behindWidth. You will get an exception if you try.

• viewAbove - a reference to the layout that you want to use as the above view of the SlidingMenu
• viewBehind - a reference to the layout that you want to use as the behind view of the SlidingMenu
• touchModeAbove - an enum that designates what part of the screen is touchable when the above view is showing. Margin means only the left margin. Fullscreen means the entire screen. Default is margin.
• behindOffset - a dimension representing the number of pixels that you want the above view to show when the behind view is showing. Default is 0.
• behindWidth - a dimension representing the width of the behind view. Default is the width of the screen (equivalent to behindOffset = 0).
• behindScrollScale - a float representing the relationship between the above view scrolling and the behind behind view scrolling. If set to 0.5f, the behind view will scroll 1px for every 2px that the above view scrolls. If set to 1.0f, the behind view will scroll 1px for every 1px that the above view scrolls. And if set to 0.0f, the behind view will never scroll; it will be static. This one is fun to play around with. Default is 0.25f.
• shadowDrawable - a reference to a drawable to be used as a drop shadow from the above view onto the below view. Default is no shadow for now.
• shadowWidth - a dimension representing the width of the shadow drawable. Default is 0.
• fadeEnabled - a boolean representing whether or not the behind view should fade when the SlidingMenu is closing and "un-fade" when opening
• fadeDegree - a float representing the "amount" of fade. 1.0f would mean fade all the way to black when the SlidingMenu is closed. 0.0f would mean do not fade at all.
• selectorEnabled - a boolean representing whether or not a selector should be drawn on the left side of the above view showing a selected view on the behind view.
• selectorDrawable - a reference to a drawable to be used as the selector NOTE : in order to have the selector drawn, you must call SlidingMenu.setSelectedView(View v) with the selected view. Note that this will most likely not work with items in a ListView because of the way that Android recycles item views.

Caveats

• Your layouts have to be based on a viewgroup, unfortunatly this negates the <merge> optimisations.