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); } });
上一篇: Android中使用定时器的三种方法
下一篇: Java中常用的代码汇总