Android第三方開源架構之SlidingMenu詳解 [轉載]

標籤：android   style   http   io   ar   color   os   使用   sp   

SlidingMenu簡介:
       SlidingMenu的是一種比較新的設定介面或配置介面效果，在主介面左滑或者右滑出現設定介面，能方便的進行各種操作.目前有大量的應用都在使用這一效果。如Evernote、Google+、Foursquare等，國內的豌豆夾，人人，360手機小幫手等都使用SlidingMenu的介面方案。

       開源架構，整合了另一個開源項目ActionBarSherlock：點擊下載。
       
       注意： SlidingMenu依賴於另一個開源項目ActionBarSherlock（在上面），所以需要將ActionBarSherlock添加作為SlidingMenu的庫工程，否則會報資源找不到錯誤。
然後再將SlidingMenu添加到自己的工程中去。
下面說說AcitonBarSherlock的匯入方式（）：

1、先將actionbarsherlock檔案夾匯入工程。
2、將actionbarsherlock-samples檔案夾裡的demo檔案匯入工程。
3、把actionbarsherlock檔案add到demo工程即可。
SlidingMenu步驟（）：

1、將library匯入工程。
2、將example匯入工程。
3、將actionbarsherlock檔案add到library，需要先刪除library工程lib裡的v4包，不然會報錯。
4、然後再將library（這時候的library是包含actionbarsherlock的）add到example，這是需要修改一個代碼。看：


在匯入的過程中，難免會遇到很多錯誤：
     總結一下：
           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] 
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]  
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]  
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]  
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]  
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]  
mTransformer = new CanvasTransformer() {  
@Override  
public void transformCanvas(Canvas canvas, float percentOpen) {  
canvas.scale(percentOpen, 1, 0, 0);  
}  
}); 

 

原文出處 : http://www.cnhonkerarmy.com/thread-206972-1-1.html

Android第三方開源架構之SlidingMenu詳解 [轉載]