Android 开源项目侧边栏菜单(SlidingMenu)使用详解

项目下载地址：https://github.com/jfeinstein10/slidingmenu
注意： slidingmenu依赖于另一个开源项目actionbarsherlock，所以需要将actionbarsherlock添加作为slidingmenu的库工程，否则会报资源找不到错误。
然后再将slidingmenu添加到自己的工程中去。

slidingmenu集成常见错误:

jar mismatch! fix your dependencies ：引用的工程和自身工程以来的jar包版本不一致导致的冲突。确保slidingmenu和actionbarsherlock所使用的jar包版本一致

如果使用到actionbarsherlock的相关api，可能报找不到getsupportactionbar等actionbarsherlock的方法。原因是使用actionbarsherlock的activity需继承于sherlockactivity，修改slidingmenu library中的slidingfragmentactivity，让它继承于sherlockfragmentactivity，重新编译library导入。

slidingmenu 常用属性介绍:

menu.setmode(slidingmenu.left);//设置左滑菜单

menu.settouchmodeabove(slidingmenu.touchmode_fullscreen);//设置滑动的屏幕范围，该设置为全屏区域都可以滑动

menu.setshadowdrawable(r.drawable.shadow);//设置阴影图片

menu.setshadowwidthres(r.dimen.shadow_width);//设置阴影图片的宽度

menu.setbehindoffsetres(r.dimen.slidingmenu_offset);//slidingmenu划出时主页面显示的剩余宽度

menu.setbehindwidth(400);//设置slidingmenu菜单的宽度

menu.setfadedegree(0.35f);//slidingmenu滑动时的渐变程度

menu.attachtoactivity(this, slidingmenu.sliding_content);//使slidingmenu附加在activity上

menu.setmenu(r.layout.menu_layout);//设置menu的布局文件

menu.toggle();//动态判断自动关闭或开启slidingmenu

menu.showmenu();//显示slidingmenu

menu.showcontent();//显示内容

menu.setonopenlistener(onopenlistener);//监听slidingmenu打开

关于关闭menu有两个监听，简单的来说，对于menu close事件，一个是when,一个是after

menu.onclosedlistener(onclosedlistener);//监听slidingmenu关闭时事件

menu.onclosedlistener(onclosedlistener);//监听slidingmenu关闭后事件

左右都可以划出slidingmenu菜单只需要设置

menu.setmode(slidingmenu.left_right);属性，然后设置右侧菜单的布局文件

menu.setsecondaryshadowdrawable(r.drawable.shadowright);//右侧菜单的阴影图片

使用fragment实现slidingmenu:

1.首先activity继承自slidingmenu包下的slidingfragmentactivity

2. setcontentview(r.layout.content_frame);//该layout为一个全屏的framelayout

3. setbehindcontentview(r.layout.menu_frame);//设置slidingmenu使用的布局，同样是一个全屏的framelayout

4.设置slidingmenu左侧菜单的fragment

setbehindcontentview(r.layout.menu_frame); 
fragmenttransaction t = this.getsupportfragmentmanager().begintransaction(); 
leftmenufragment = new menufragment(); 
t.replace(r.id.menu_frame, leftmenufragment); 
t.commit(); 

menufragment其实就是一个fragment，显示一个listview
然后点击listview的每一项的时候，通知activity切换不同的fragment
为了看清效果，我们新建5个frament，分别是
fragment1, fragment2, fragment3, fragment4, fragment5
在slidingmenu中用listview显示。

设置主页面显示的fragment:

if (savedinstancestate == null) {//== null的时候新建fragment1 
contentfragment = new fragment1(); 
} else {//不等于null，直接get出来 
//不等于null，找出之前保存的当前activity显示的fragment 
contentfragment = getsupportfragmentmanager().getfragment(savedinstancestate, "contentfragment"); 
} 
//设置内容fragment 
getsupportfragmentmanager() 
.begintransaction() 
.replace(r.id.content_frame, contentfragment) 
.commit(); 

在activity的onsaveinstancestate中保存当前显示的fragment
getsupportfragmentmanager().putfragment(outstate, "contentfragment", contentfragment);

设置slidingmenu属性

sm = getslidingmenu();
//如果只显示左侧菜单就是用left,右侧就right，左右都支持就left_right
sm.setmode(slidingmenu.left_right);//设置菜单滑动模式，菜单是出现在左侧还是右侧，还是左右两侧都有
sm.setshadowdrawable(r.drawable.shadow);//设置阴影的图片资源
sm.setshadowwidthres(r.dimen.shadow_width);//设置阴影图片的宽度
//sm.setbehindwidth(200);//设置菜单的宽
sm.setbehindoffsetres(r.dimen.slidingmenu_offset);//slidingmenu划出时主页面显示的剩余宽度
sm.settouchmodeabove(slidingmenu.touchmode_fullscreen);//设置滑动的区域

支持右侧划出菜单:

//slidingmenu可以同时支持划出左右两侧的菜单，互不冲突，而且动画优美，体验良好。
sm.setsecondarymenu(r.layout.menu_frame2);//设置右侧菜单
sm.setsecondaryshadowdrawable(r.drawable.shadowright);//设置右侧菜单阴影的图片资源
//右侧slidingmenu的fragment
getsupportfragmentmanager().begintransaction().replace(r.id.menu_frame2, new samplelistfragment()).commit();

设置actionbar可以被点击:

getsupportactionbar().sethomebuttonenabled(true);//actionbar主按键可以被点击
getsupportactionbar().setdisplayhomeasupenabled(true);//显示向左的图标
setslidingactionbarenabled(false);//左右两侧slidingmenu的fragment是否显示标题栏

切换主页面显示的fragment:

public void switchcontent(fragment f) {
//给内容fragment赋值，并在onsaveinstancestate时保存这个fragment
contentfragment = f;
fragmenttransaction  t = getsupportfragmentmanager().begintransaction();
t.replace(r.id.content_frame, f);
t.commit();
sm.showcontent();

使用普通activity实现slidingmenu:

slidingmenu menu = new slidingmenu(this);//直接new，而不是getslidingmenu 
menu.setmode(slidingmenu.left); 
menu.settouchmodeabove(slidingmenu.touchmode_fullscreen); 
menu.setshadowdrawable(r.drawable.shadow); 
menu.setshadowwidthres(r.dimen.shadow_width); 
menu.setbehindoffsetres(r.dimen.slidingmenu_offset); 
menu.setbehindwidth(400);//设置slidingmenu菜单的宽度 
menu.setfadedegree(0.35f); 
menu.attachtoactivity(this, slidingmenu.sliding_content);//必须调用 
menu.setmenu(r.layout.menu_layout_left);//就是普通的layout布局 
menu.setbehindcanvastransformer(mtransformer); 

相应slidingmenu里的点击事件，因为slidingmenu已经被包含在了activity中了，所以直接findviewbyid(id),拿到view之后就可以进行相应的处理。

支持左右两侧都能划出菜单

menu.setsecondarymenu(r.layout.menu_layout_right);
menu.setsecondaryshadowdrawable(r.drawable.shadowright);

右侧菜单一样直接findviewbyid(id),拿到view之后就可以任意处理了

更换slidingmenu的动画

slidingmenu支持左滑或者右滑时定义不同的动画，包括拉伸，缩放，旋转等动画。就是在滑动的过程中，slidingmenu如何出现的动画。
动画使用也很简单
首先定义canvastransformer mtransformer;变量:

mtransformer = new canvastransformer() { 
@override 
public void transformcanvas(canvas canvas, float percentopen) {
float scale = (float) (percentopen*0.25 + 0.75); 
canvas.scale(scale, scale, canvas.getwidth()/2, canvas.getheight()/2);
}
};

然后将mtransformer对象设置给slidingmenu即可，这个是缩放动画:

private void initslidupcanvastransformer() { 
mtransformer = new canvastransformer() { 
 
@override 
public void transformcanvas(canvas canvas, float percentopen) { 
canvas.translate(0, canvas.getheight()*(1-interp.getinterpolation(percentopen))); 
} 
}; 
} 
 
private static interpolator interp = new interpolator() { 
@override 
public float getinterpolation(float t) { 
t -= 1.0f; 
return t * t * t + 1.0f; 
} 
}; 

拉伸动画:

mtransformer = new canvastransformer() { 
@override 
public void transformcanvas(canvas canvas, float percentopen) { 
canvas.scale(percentopen, 1, 0, 0); 
} 
});