Android SlidingMenu组件完整教程与实战

发表于 更新于

1 概述

Android中的SlidingMenu组件允许用户通过侧滑来展示或隐藏侧边栏，通常用于导航选项或额外功能的展示。

核心特性：

  • 由Jeff Gilfelt开发
  • 提供易于使用的API
  • 支持与Fragment集成
  • 可自定义滑动方向和模式

虽然新材料倾向于使用NavigationView，SlidingMenu仍然在旧版本或需要定制的项目中有其应用价值。

2 组件集成

2.1 添加依赖

在 build.gradle 中添加：

1
2
3
dependencies {
    implementation 'com.jeremyfeinstein.slidingmenu:library:1.3@aar'
}

2.2 布局配置

1
2
3
4
<com.jeremyfeinstein.slidingmenu.lib.SlidingMenu
    android:id="@+id/slidingmenulayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

2.3 Activity初始化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public class MainActivity extends SlidingFragmentActivity {
    
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 配置SlidingMenu
        setBehindContentView(R.layout.menu_frame);
        getSlidingMenu().setMode(SlidingMenu.LEFT);
        getSlidingMenu().setTouchModeAbove(SlidingMenu.TOUCHMODE_FULLSCREEN);
        getSlidingMenu().setShadowWidthRes(R.dimen.shadow_width);
        getSlidingMenu().setShadowDrawable(R.drawable.shadow_left);
        getSlidingMenu().setBehindOffsetRes(R.dimen.slidingmenu_offset);
        getSlidingMenu().setFadeDegree(0.35f);
    }
}

3 常用配置

3.1 菜单属性设置

方法 说明
setMenuWidth(int) 设置菜单宽度
setShadowWidthRes(int) 设置阴影宽度
setShadowDrawable(int) 设置阴影图片
setTouchModeAbove(int) 设置触摸模式
setFadeDegree(float) 设置渐变程度

3.2 触摸模式

1
2
3
4
5
6
7
8
// 仅在菜单显示时允许滑动
slidingMenu.setTouchModeAbove(SlidingMenu.TOUCHMODE_NONE);

// 全屏可滑动
slidingMenu.setTouchModeAbove(SlidingMenu.TOUCHMODE_FULLSCREEN);

// 边缘滑动
slidingMenu.setTouchModeAbove(SlidingMenu.TOUCHMODE_MARGIN);

3.3 滑动方向

1
2
3
4
5
6
7
8
// 左侧滑动
slidingMenu.setMode(SlidingMenu.LEFT);

// 右侧滑动
slidingMenu.setMode(SlidingMenu.RIGHT);

// 双侧滑动
slidingMenu.setMode(SlidingMenu.LEFT_RIGHT);

4 Fragment集成

4.1 创建菜单Fragment

1
2
3
4
5
6
7
8
9
public class MenuFragment extends Fragment {
    
    @Override
    public View onCreateView(LayoutInflater inflater, 
                             ViewGroup container, 
                             Bundle savedInstanceState) {
        return inflater.inflate(R.layout.fragment_menu, container, false);
    }
}

4.2 加载Fragment

1
2
3
4
5
6
7
8
9
10
11
// 在Activity中加载菜单Fragment
getSupportFragmentManager()
    .beginTransaction()
    .replace(R.id.menu_frame, new MenuFragment())
    .commit();

// 加载内容Fragment
getSupportFragmentManager()
    .beginTransaction()
    .replace(R.id.content_frame, new HomeFragment())
    .commit();

4.3 布局适配

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<RelativeLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 菜单区域 -->
    <FrameLayout
        android:id="@+id/menu_frame"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:background="#FF0000"/>

    <!-- 主内容区域 -->
    <FrameLayout
        android:id="@+id/content_frame"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_toRightOf="@id/menu_frame"
        android:background="#00FF00"/>

</RelativeLayout>

5 高级配置

5.1 滑动模式

模式 说明
SLIDING_CONTENT_ONLY 仅内容区域滑动
SLIDING_WINDOW 整个窗口滑动
SLIDING_CONTENT_FLIPPED 内容区域翻转

5.2 动态切换模式

1
2
3
4
5
// 切换到内容滑动模式
slidingMenu.setMode(SlidingMenu.SLIDING_CONTENT_ONLY);

// 切换到窗口滑动模式
slidingMenu.setMode(SlidingMenu.SLIDING_WINDOW);

5.3 事件监听

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
slidingMenu.setOnOpenListener(new SlidingMenu.OnOpenListener() {
    @Override
    public void onOpen() {
        // 菜单打开时触发
    }
});

slidingMenu.setOnCloseListener(new SlidingMenu.OnCloseListener() {
    @Override
    public void onClose() {
        // 菜单关闭时触发
    }
});

slidingMenu.setOnClosedListener(new SlidingMenu.OnClosedListener() {
    @Override
    public void onClosed() {
        // 菜单完全关闭后触发
    }
});

6 触摸事件处理

6.1 自定义触摸监听

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
view.setOnTouchListener(new View.OnTouchListener() {
    @Override
    public boolean onTouch(View v, MotionEvent event) {
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                // 触摸按下
                break;
            case MotionEvent.ACTION_MOVE:
                // 触摸移动
                break;
            case MotionEvent.ACTION_UP:
                // 触摸抬起
                break;
        }
        return true;
    }
});

6.2 事件分发机制

方法 说明
dispatchTouchEvent 事件分发
onInterceptTouchEvent 事件拦截
onTouchEvent 事件处理

7 动画效果

7.1 内置动画

1
2
3
4
// 透明度动画
AlphaAnimation alphaAnim = new AlphaAnimation(0.0f, 1.0f);
alphaAnim.setDuration(500);
view.startAnimation(alphaAnim);

7.2 动画集合

1
2
3
4
AnimationSet animationSet = new AnimationSet(true);
animationSet.addAnimation(alphaAnim);
animationSet.addAnimation(translateAnim);
view.startAnimation(animationSet);

8 实践技巧

8.1 常见问题

问题 解决方案
菜单与内容不同步 确保Fragment生命周期同步
滑动卡顿 优化布局层级，减少复杂视图
阴影不显示 检查阴影资源文件是否存在

8.2 性能优化

  • 减少布局层级
  • 使用硬件加速
  • 合理设置动画帧率（60fps）
  • 避免频繁的Fragment事务

8.3 用户体验原则

  • 一致性：保持应用风格统一
  • 反馈：对用户操作给予即时反馈
  • 简化：简化操作流程，避免复杂交互

9 示例项目

推荐参考 zhy_slidemenu_demo 示例项目，学习不同场景下的SlidingMenu使用方式。

总结

SlidingMenu是Android实现侧滑菜单的经典方案，通过本文可掌握：

  • 组件集成与配置
  • Fragment集成方法
  • 触摸事件处理
  • 动画效果实现
  • 性能优化技巧

适用于需要侧滑导航的Android应用开发场景。