Android開源項目SlidingMenu深刻剖析

       Android開源項目SlidingMenu深刻剖析  

 

SlidingMenu簡介:

SlidingMenu 的是一種比較新的設置界面或配置界面效果，在主界面左滑或者右滑出現設置界面，能方便的進行各類操做.目前有大量的應用都在使用這一效果。如 Evernote、Google+、Foursquare等，國內的豌豆夾，人人，360手機助手等都使用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
     

[java] view plaincopy

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:

[java] view plaincopy

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:

[java] view plaincopy

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;變量:

[java] view plaincopy

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便可，這個是縮放動畫:

[java] view plaincopy

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

拉伸動畫:

[java] view plaincopy

mTransformer = new CanvasTransformer() {
@Override
public void transformCanvas(Canvas canvas, float percentOpen) {
canvas.scale(percentOpen, 1, 0, 0);
}
});