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

1. setBehindContentView(R.layout.menu_frame);  
2. FragmentTransaction t = this.getSupportFragmentManager().beginTransaction();  
3. leftMenuFragment = new MenuFragment();  
4. t.replace(R.id.menu_frame, leftMenuFragment);  
5. t.commit();  

MenuFragment其實就是一個Fragment，顯示一個ListView

然後點選ListView的每一項的時候，通知Activity切換不同的Fragment

為了看清效果，我們建立5個Frament，分别是

Fragment1, Fragment2, Fragment3, Fragment4, Fragment5

在SlidingMenu中用ListView顯示。

設定首頁面顯示的Fragment:

1. if (savedInstanceState == null) {//== null的時候建立Fragment1  
2. contentFragment = new Fragment1();  
3. } else {//不等于null，直接get出來  
4. //不等于null，找出之前儲存的目前Activity顯示的Fragment  
5. contentFragment = getSupportFragmentManager().getFragment(savedInstanceState, "contentFragment");  
6. }  
7. //設定内容Fragment  
8. getSupportFragmentManager()  
9. .beginTransaction()  
10. .replace(R.id.content_frame, contentFragment)  
11. .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:

1. slidingMenu menu = new SlidingMenu(this);//直接new，而不是getSlidingMenu  
2. menu.setMode(SlidingMenu.LEFT);  
3. menu.setTouchModeAbove(SlidingMenu.TOUCHMODE_FULLSCREEN);  
4. menu.setShadowDrawable(R.drawable.shadow);  
5. menu.setShadowWidthRes(R.dimen.shadow_width);  
6. menu.setBehindOffsetRes(R.dimen.slidingmenu_offset);  
7. menu.setBehindWidth(400);//設定SlidingMenu菜單的寬度  
8. menu.setFadeDegree(0.35f);  
9. menu.attachToActivity(this, SlidingMenu.SLIDING_CONTENT);//必須調用  
10. menu.setMenu(R.layout.menu_layout_left);//就是普通的layout布局  
11. 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;變量:

1. mTransformer = new CanvasTransformer() {  
2. @Override  
3. public void transformCanvas(Canvas canvas, float percentOpen) {  
4. float scale = (float) (percentOpen*0.25 + 0.75);  
5. canvas.scale(scale, scale, canvas.getWidth()/2, canvas.getHeight()/2);  
7. };  

然後将mTransformer對象設定給SlidingMenu即可，這個是縮放動畫:

1. private void initSlidUpCanvasTransformer() {  
5. canvas.translate(0, canvas.getHeight()*(1-interp.getInterpolation(percentOpen)));  
9. private static Interpolator interp = new Interpolator() {  
11. public float getInterpolation(float t) {  
12. t -= 1.0f;  
13. return t * t * t + 1.0f;  

拉伸動畫:

4. canvas.scale(percentOpen, 1, 0, 0);