Skip to content

An Android library that allows you to easily create applications with slide-in menus. You may use it in your Android apps provided that you cite this project and include the license in your app. Thanks!

License

Notifications You must be signed in to change notification settings

zing333/SlidingMenu

 
 

Repository files navigation

SlidingMenu (Play Store Demo)

SlidingMenu is an Open Source Android library that allows developers to easily create applications with sliding menus like those made popular in the Google+, YouTube, and Facebook apps. Feel free to use it all you want in your Android apps provided that you cite this project and include the license in your app.

SlidingMenu is currently used in some awesome Android apps. Here's a list of some of them:

If you are using SlidingMenu in your app and would like to be listed here, please let me know via Twitter!

Here's an older video of the example application in this repository : http://youtu.be/8vNaANLHw-c

Also, you can follow the project on Twitter : @SlidingMenu

Setup

  • In Eclipse, just import the library as an Android library project. Project > Clean to generate the binaries you need, like R.java, etc.
  • Then, just add SlidingMenu as a dependency to your existing project and you're good to go!

Setup with ActionBarSherlock

  • Setup as above.
  • Checkout a clean copy of ActionBarSherlock and import into your Eclipse workspace.
  • Add ActionBarSherlock as a dependency to SlidingMenu
  • Go into the SlidingActivities that you plan on using make them extend Sherlock___Activity instead of ___Activity.

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 SlidingActivity.

  • In your Activity's onCreate method, you will have to call setContentView, as usual, and also setBehindContentView, which has the same syntax as setContentView. setBehindContentView will place the view in the "behind" portion of the SlidingMenu. You will have access to the getSlidingMenu method so you can customize the SlidingMenu to your liking.
  • If you want to use another library such as ActionBarSherlock, you can just change the SlidingActivities to extend the SherlockActivities instead of the regular Activities.

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.

Simple Example

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);
	}
    
}

XML Usage

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

<com.jeremyfeinstein.slidingmenu.lib.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.

Developed By

  • Jeremy Feinstein

License

Copyright 2012-2014 Jeremy Feinstein

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
<TITLE>Bookmarks</TITLE>

Bookmarks

书签栏

CoordinatorLayout使用详解: 打造折叠悬浮效果 - jxf_access的专栏 - CSDN博客
细说 AppbarLayout,如何理解可折叠 Toolbar 的定制 - frank 的专栏 - CSDN博客
RxJava和RxAndroid使用详解 - andoop的博客 - CSDN博客
RxJava简介及在androidstudio中引入RxAndroid - idaretobe的专栏 - CSDN博客
RxJava(RxAndroid)基本使用入门 - xu_song的专栏 - CSDN博客
android之ExoPlayer探索 - dengpeng_的博客 - CSDN博客
com.google.android.exoplayer2.extractor.mp4 (ExoPlayer library)
仿网易云音乐播放界面 - 简书
AndroidO audio系统之框架简介(一) - marshal_zsx的博客 - CSDN博客
Android AudioFocus音频焦点机制学习和理解 - 天花板的随笔 - CSDN博客
开源License及分类 - yzying1980的专栏 - CSDN博客
UniversalMusicPlayer 解析一看就懂 - liucheng61214的专栏 - CSDN博客
Android Room Orm框架学习 - 简书
GMTC分享——当插件化遇到 Android P - xinzhou201的专栏 - CSDN博客
chrome怎么显示菜单栏?_百度知道
SystemUI 7.0学习总结一-SystemUI的启动 - songjinghao的专栏 - CSDN博客
android SystemUI 流程分析 - andyhuabing的专栏 - CSDN博客
android启动--深入理解zygote - andyhuabing的专栏 - CSDN博客
《深入理解Android 卷III》第七章 深入理解SystemUI - Innost的专栏 - CSDN博客
Downloads - ADB Driver Installer
Android 7.1.2(Android N) SystemUI--Recents Task... - 简书
TensorFlow android demo 车道线 车辆 人脸 动作 骨架 识别 检测 - 安卓源码 安卓巴士 - 安卓开发 - Android开发 - 安卓 - 移动互联网门户
frameworks/base/policy/src/com/android/internal/policy/impl/PhoneWindowManag_百度搜索
史上最详细的Android系统SystemUI 启动过程详细解析 - 简书
图解Android - Zygote, System Server 启动分析 - 漫天尘沙 - 博客园
Android O Car Launcher解析 - 简书

============================================================================ 1.frameworks/base/core/java/com/android/internal/os/ZygoteInit.java

public static void main(String argv[]) { ……此处省略一万字,下同 //启动system_server进程 if (startSystemServer) { startSystemServer(abiList, socketName); } ……此处省略一万字,下同 } private static boolean startSystemServer(String abiList, String socketName) throws MethodAndArgsCaller, RuntimeException { ……
pid = Zygote.forkSystemServer( parsedArgs.uid, parsedArgs.gid, parsedArgs.gids, parsedArgs.debugFlags, null, parsedArgs.permittedCapabilities, parsedArgs.effectiveCapabilities); …… }

2.frameworks/base/core/java/com/android/internal/os/Zygote.java public static int forkSystemServer(int uid, int gid, int[] gids, int debugFlags, int[][] rlimits, long permittedCapabilities, long effectiveCapabilities) { VM_HOOKS.preFork(); //通过JNI正式fork出system_server进程,并返回system_server的进程ID int pid = nativeForkSystemServer( uid, gid, gids, debugFlags, rlimits, permittedCapabilities, effectiveCapabilities); …… }

  1. frameworks/base/services/java/com/android/server/SystemServer.java public static void main(String[] args) { new SystemServer().run(); } private void run() { …… //Create the system service manager. mSystemServiceManager = new SystemServiceManager(mSystemContext);

startBootstrapServices(); startCoreServices(); startOtherServices(); …… }

private void startBootstrapServices() { …… // Activity manager runs the show. mActivityManagerService = mSystemServiceManager.startService( ActivityManagerService.Lifecycle.class).getService(); …… } private void startOtherServices() { …… statusBar = new StatusBarManagerService(context, wm); ServiceManager.addService(Context.STATUS_BAR_SERVICE, statusBar); …… startSystemUi(context); …… } static final void startSystemUi(Context context) { Intent intent = new Intent(); intent.setComponent(new ComponentName("com.android.systemui", "com.android.systemui.SystemUIService")); intent.addFlags(Intent.FLAG_DEBUG_TRIAGED_MISSING); //Slog.d(TAG, "Starting service: " + intent); context.startServiceAsUser(intent, UserHandle.SYSTEM); }

4.frameworks/base/packages/SystemUI/src/com/android/systemui/SystemUIService.java public void onCreate() { super.onCreate(); ((SystemUIApplication) getApplication()).startServicesIfNeeded(); } 5. frameworks/base/packages/SystemUI/src/com/android/systemui/SystemUIApplication.java private final Class[] SERVICES = new Class[] { com.android.systemui.tuner.TunerService.class, com.android.systemui.keyguard.KeyguardViewMediator.class, com.android.systemui.recents.Recents.class, com.android.systemui.volume.VolumeUI.class, Divider.class, com.android.systemui.statusbar.SystemBars.class, com.android.systemui.usb.StorageNotification.class, com.android.systemui.power.PowerUI.class, com.android.systemui.media.RingtonePlayer.class, com.android.systemui.keyboard.KeyboardUI.class, com.android.systemui.tv.pip.PipUI.class, com.android.systemui.shortcut.ShortcutKeyDispatcher.class, com.android.systemui.VendorServices.class }; public void startServicesIfNeeded() { startServicesIfNeeded(SERVICES); } private void startServicesIfNeeded(Class[] services) { …… //创建相关Service实例,比如SystemBars(PhoneStatusBar)(最近任务栏) //frameworks/base/packages/SystemUI/src/com/android/ //systemui/statusbar/SystemBars.java(PhoneStatusBar.java) Object newService = SystemUIFactory.getInstance().createInstance(cl); mServices[i] = (SystemUI) ((newService == null) ? cl.newInstance() : newService); …… mServices[i].start(); …… if (mBootCompleted) { mServices[i].onBootCompleted(); } } frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/SystemBars.java public void start() { …… mServiceMonitor = new ServiceMonitor(TAG, DEBUG, mContext, Settings.Secure.BAR_SERVICE_COMPONENT, this); mServiceMonitor.start(); // will call onNoService if no remote service is found }

@Override public void onNoService() { …… createStatusBarFromConfig(); // fallback to using an in-process implementation } private void createStatusBarFromConfig() { …… //frameworks/base/packages/SystemUI/res/values/config.xml final String clsName = mContext.getString(R.string.config_statusBarComponent); …… cls = mContext.getClassLoader().loadClass(clsName); …… mStatusBar = (BaseStatusBar) cls.newInstance(); …… mStatusBar.start(); …… }

frameworks/base/packages/SystemUI/res/values/config.xml

com.android.systemui.statusbar.phone.StatusBar frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/PhoneStatusBar.java @Override public void start() { …… super.start(); …… } private void addStatusBarWindow() { …… makeStatusBarView(); mStatusBarWindowManager = new StatusBarWindowManager(mContext); …… } protected PhoneStatusBarView makeStatusBarView() { …… inflateStatusBarWindow(context); …… mNotificationPanel = (NotificationPanelView) mStatusBarWindow.findViewById( R.id.notification_panel); mNotificationPanel.setStatusBar(this); …… } protected void inflateStatusBarWindow(Context context) { mStatusBarWindow = (StatusBarWindowView) View.inflate(context, R.layout.super_status_bar, null); }

frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/BaseStatusBar.java public void start() { …… createAndAddWindows(); …… } frameworks/base/packages/SystemUI/res/layout/super_status_bar.xml <com.android.systemui.statusbar.phone.StatusBarWindowView xmlns:android="http://schemas.android.com/apk/res/android" xmlns:sysui="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent" android:fitsSystemWindows="true">

<com.android.systemui.statusbar.BackDropView
        android:id="@+id/backdrop"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:visibility="gone"
        sysui:ignoreRightInset="true"
        >
    <ImageView android:id="@+id/backdrop_back"
               android:layout_width="match_parent"
               android:scaleType="centerCrop"
               android:layout_height="match_parent" />
    <ImageView android:id="@+id/backdrop_front"
               android:layout_width="match_parent"
               android:layout_height="match_parent"
               android:scaleType="centerCrop"
               android:visibility="invisible" />
</com.android.systemui.statusbar.BackDropView>

<com.android.systemui.statusbar.ScrimView android:id="@+id/scrim_behind"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:importantForAccessibility="no"
    sysui:ignoreRightInset="true"
    />

<com.android.systemui.statusbar.AlphaOptimizedView
    android:id="@+id/heads_up_scrim"
    android:layout_width="match_parent"
    android:layout_height="@dimen/heads_up_scrim_height"
    android:background="@drawable/heads_up_scrim"
    sysui:ignoreRightInset="true"
    android:importantForAccessibility="no"/>

<include layout="@layout/status_bar"
    android:layout_width="match_parent"
    android:layout_height="@dimen/status_bar_height" />

<include layout="@layout/brightness_mirror" />

<ViewStub android:id="@+id/fullscreen_user_switcher_stub"
          android:layout="@layout/car_fullscreen_user_switcher"
          android:layout_width="match_parent"
          android:layout_height="match_parent"/>

<include layout="@layout/status_bar_expanded"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:visibility="gone" />

<com.android.systemui.statusbar.ScrimView android:id="@+id/scrim_in_front"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:importantForAccessibility="no"
    sysui:ignoreRightInset="true"
    />

</com.android.systemui.statusbar.phone.StatusBarWindowView>

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

About

An Android library that allows you to easily create applications with slide-in menus. You may use it in your Android apps provided that you cite this project and include the license in your app. Thanks!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%