SlidingMenu是一个很好使用的侧滑菜单开源项目,它的表现形式类似于DrawerLayout和SlidingDrawer,具体效果如下图所示,左侧为侧滑Menu菜单,右侧黑色部分为内容显示视图Content:
下面是SlidingMenu主要的方法:
全局常量:
//侧滑菜单通过手势的打开方式
publicstatic final int TOUCHMODE_MARGIN = 0; //触摸屏幕边缘打开侧滑菜单
publicstatic final int TOUCHMODE_FULLSCREEN = 1;//触摸屏幕的任何位置打开侧滑菜单
publicstatic final int TOUCHMODE_NONE = 2; //禁止通过手势打开侧滑菜单
//侧滑菜单的显示位置
publicstatic final int LEFT = 0; //侧滑菜单显示在内容视图左边
publicstatic final int RIGHT = 1; //侧滑菜单显示在内容视图右边
publicstatic final int LEFT_RIGHT = 2; //侧滑菜单放在内容视图的左边和右边
公用方法:
/** *设置内容显示视图的布局资源 * @param res 布局文件资源ID */ public void setContent(int res) { setContent(LayoutInflater.from(getContext()).inflate(res, null)); } /** * 设置内容显示视图的布局资源 * @param view 自定义View视图 */ public void setContent(View view) { mViewAbove.setContent(view); showContent(); } /** * 返回内容显示视图 * @return 当前内容显示视图 */ public View getContent() { return mViewAbove.getContent(); } /** * 设置侧滑菜单的布局* * @param res 布局资源id */ public void setMenu(int res) { setMenu(LayoutInflater.from(getContext()).inflate(res, null)); } /** * 设置侧滑菜单的界面 * @param view 自定义View视图 */ public void setMenu(View v) { mViewBehind.setContent(v); } /** * 获取侧滑菜单视图 * @return 侧滑菜单视图 */ public View getMenu() { return mViewBehind.getContent(); } /** * 是否使能侧滑菜单,如果设置为false则表示不能通过手势或者其它方式呼出侧滑菜单 * @param b 是否使能侧滑菜单 */ public void setSlidingEnabled(boolean b) { mViewAbove.setSlidingEnabled(b); } /** * 返回侧滑菜单的使能状态 * * @return true, 侧滑菜单可用 */ public boolean isSlidingEnabled() { return mViewAbove.isSlidingEnabled(); } /** * 设置侧滑菜单的显示方式 * @param mode 设置侧滑菜单显示位置 LEFT/RIGHT/LEFT_RIGHT */ public void setMode(int mode) { if (mode != LEFT && mode != RIGHT && mode != LEFT_RIGHT) { throw new IllegalStateException("SlidingMenu mode must be LEFT, RIGHT, or LEFT_RIGHT"); } mViewBehind.setMode(mode); } /** * 返回当前侧滑菜单处于那种显示模式 * @return 侧滑菜单当前显示模式,LEFT/RIGHT */ public int getMode() { return mViewBehind.getMode(); } /** * 设置侧滑菜单是否处于静止状态 * @param b true侧滑菜单处于静止状态, false 禁止侧滑菜单处于静止状态 */ public void setStatic(boolean b) { if (b) { setSlidingEnabled(false); mViewAbove.setCustomViewBehind(null); mViewAbove.setCurrentItem(1); } else { mViewAbove.setCurrentItem(1); mViewAbove.setCustomViewBehind(mViewBehind); setSlidingEnabled(true); } } /** * 显示侧滑菜单 */ public void showMenu() { showMenu(true); } /** * 显示侧滑菜单 * * @param animate true打开侧滑菜单时有动画效果, false 打开侧滑菜单时没有动画效果 */ public void showMenu(boolean animate) { mViewAbove.setCurrentItem(0, animate); } /** * 关闭侧滑菜单并显示内容视图 */ public void showContent() { showContent(true); } /** *关闭侧滑菜单并显示内容视图 * * @param animate true 打开内容显示视图时有动画效果, false打开内容视图时没有动画效果 */ public void showContent(boolean animate) { mViewAbove.setCurrentItem(1, animate); } /** * 切换侧滑菜单和内容显示视图的显示状态 * 切换侧滑菜单视图和内容显示视图,显示隐藏都带动画 */ public void toggle() { toggle(true); } /** * 切换侧滑菜单视图和内容显示视图,可设置显示隐藏是否带动画 * @param animate true 切换时有动画效果, false切换时没有动画效果 */ public void toggle(boolean animate) { if (isMenuShowing()) { showContent(animate); } else { showMenu(animate); } } /** * 侧滑菜单是否处于显示状态 * @return true 侧滑显示处于显示状态 false 侧滑菜单处于不可见状态 */ public boolean isMenuShowing() { return mViewAbove.getCurrentItem() == 0 || mViewAbove.getCurrentItem() == 2; } /** * 得到侧滑菜单右侧相对于屏幕右侧的距离 * @return 侧滑菜单右侧相对于屏幕右侧的距离 */ public int getBehindOffset() { return ((RelativeLayout.LayoutParams)mViewBehind.getLayoutParams()).rightMargin; } /** * 设置侧滑菜右侧相对于屏幕右侧的距离 * @param i 侧滑菜右侧相对于屏幕右侧的距离 */ public void setBehindOffset(int i) { mViewBehind.setWidthOffset(i); } /** * 设置侧滑菜单宽度 * @param i 侧滑菜单宽度*/ @SuppressWarnings("deprecation") public void setBehindWidth(int i) /** * 获取slidingmenu手势打开模式 * @return slidingmenu手势打开模式 */ public int getTouchModeAbove() { return mViewAbove.getTouchMode(); } /** * 设置SlidingMenu手势打开模式 * @param i SlidingMenu手势打开模式 */ public void setTouchModeAbove(int i) { if (i != TOUCHMODE_FULLSCREEN && i != TOUCHMODE_MARGIN && i != TOUCHMODE_NONE) { throw new IllegalStateException("TouchMode must be set to either" + "TOUCHMODE_FULLSCREEN or TOUCHMODE_MARGIN or TOUCHMODE_NONE."); } mViewAbove.setTouchMode(i); } /** * 设置阴影宽度 * @param 阴影宽度,单位为像素 */ public void setShadowWidth(int pixels) { mViewBehind.setShadowWidth(pixels); }