Android組件——建立DrawerLayout導航

標籤：drawerlayout   navigation   drawer   抽屜導航   

轉載請註明出處： http://blog.csdn.net/allen315410/article/details/42875231概述本篇部落格是對developer.android.com/上的Training課程的簡單翻譯，若是覺得翻譯出來的理解有困難，請點擊下方連結查看原文！

關於DrawerLayout的Training：http://developer.android.com/training/implementing-navigation/nav-drawer.html

關於DrawerLayout的API：http://developer.android.com/reference/android/support/v4/widget/DrawerLayout.html

建立抽屜布局

        建立一個抽屜布局必須得以DrawerLayout作為XML檔案的根節點，記住，DrawerLayout引用的是android.support.v4.DrawerLayout，然後在布局內部新增內容視圖地區和一個或者兩個抽屜視圖地區，這裡理解抽屜視圖即為上面描述的菜單視圖。例如下面一段布局中顯示，在布局中添加一個FrameLayout作為內容地區（通常用來呈現Fragment），另外在下面定義了一個listView用來呈現抽屜菜單視圖：

<android.support.v4.widget.DrawerLayout    xmlns:android="http://schemas.android.com/apk/res/android"    android:id="@+id/drawer_layout"    android:layout_width="match_parent"    android:layout_height="match_parent">    <!-- The main content view -->    <FrameLayout        android:id="@+id/content_frame"        android:layout_width="match_parent"        android:layout_height="match_parent" />    <!-- The navigation drawer -->    <ListView android:id="@+id/left_drawer"        android:layout_width="240dp"        android:layout_height="match_parent"        android:layout_gravity="start"        android:choiceMode="singleChoice"        android:divider="@android:color/transparent"        android:dividerHeight="0dp"        android:background="#111"/></android.support.v4.widget.DrawerLayout>

這個布局檔案示範了一些重要的布局特徵.

• 主要內容的視圖(FrameLayout)必須是DrawLayout的第一個子項目, 因為隱藏式瀏覽選單是在主要內容視圖的上面.
• 主要內容視圖設定為匹配父視圖的寬度和高度, 因為它代表了整個介面隱藏式瀏覽選單是隱藏的.
• 抽屜視圖(ListView)必須指定其水平重力與android:layout_gravity屬性。支援從右至左(RTL)語言,指定值與 "start" 代替 "left"(所以抽屜裡出現在布局的右側當布局是RTL時).
• 抽屜視圖指定其寬度用dp單位和高度匹配父視圖。抽屜裡的寬度不能超過320 dp, 所以使用者總是可以看到主要內容視圖的一部分.

初始化抽屜列表        在你的Activity中, 第一件事就是初始化隱藏式瀏覽選單列表裡面的元素, 你如何做取決於你的應用程式的內容,但一個隱藏式瀏覽選單通常包括一個ListView, 因此清單應該由一個Adapter填充(例如ArrayAdapter或SimpleCursorAdapter).
例如, 這裡示範了如何用String array來初始化一個導航列表.

public class MainActivity extends Activity {    private String[] mPlanetTitles;    private DrawerLayout mDrawerLayout;    private ListView mDrawerList;    ...    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        mPlanetTitles = getResources().getStringArray(R.array.planets_array);        mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);        mDrawerList = (ListView) findViewById(R.id.left_drawer);        // Set the adapter for the list view        mDrawerList.setAdapter(new ArrayAdapter<String>(this,                R.layout.drawer_list_item, mPlanetTitles));        // Set the list's click listener        mDrawerList.setOnItemClickListener(new DrawerItemClickListener());        ...    }}

這個代碼調用setOnItemClickListener()去接收隱藏式瀏覽選單列表的點擊事件. 下一節將展示如何?這個介面,當使用者選擇一個Item時改變內容視圖.

處理導航點擊事件當使用者選擇了抽屜列表裡面的一個Item時, 系統調用onItemClickListener上的onItemClick(), 給setOnItemClickListener().
你在onItemClick()方法裡面做什麼, 取決於你的app實現的結構. 在下面的例子中, 選擇每一個Item都會在主要內容的布局中插入一個不同的Fragment.

private class DrawerItemClickListener implements ListView.OnItemClickListener {    @Override    public void onItemClick(AdapterView parent, View view, int position, long id) {        selectItem(position);    }}/** Swaps fragments in the main content view */private void selectItem(int position) {    // Create a new fragment and specify the planet to show based on position    Fragment fragment = new PlanetFragment();    Bundle args = new Bundle();    args.putInt(PlanetFragment.ARG_PLANET_NUMBER, position);    fragment.setArguments(args);    // Insert the fragment by replacing any existing fragment    FragmentManager fragmentManager = getFragmentManager();    fragmentManager.beginTransaction()                   .replace(R.id.content_frame, fragment)                   .commit();    // Highlight the selected item, update the title, and close the drawer    mDrawerList.setItemChecked(position, true);    setTitle(mPlanetTitles[position]);    mDrawerLayout.closeDrawer(mDrawerList);}@Overridepublic void setTitle(CharSequence title) {    mTitle = title;    getActionBar().setTitle(mTitle);}

監聽開啟和關閉事件       偵聽抽屜開啟和關閉事件,調用你的DrawerLayout setDrawerListener(), 並將其傳遞給DrawerLayout.DrawerListener的實現. 這個介面提供了回調抽屜事件, 如onDrawerOpened()和onDrawerClosed ()。
      然而, 相對於實現DrawerLayout.DrawerListener, 如果你的Activity包括工具列, 可以代替繼承ActionBarDrawerToggle類. ActionBarDrawerToggle實現了DrawerLayout.DrawerListener. 所以你仍然可以覆蓋這些回調, 但它也有助於正確的互動行為, 在工具列的表徵圖和隱藏式瀏覽選單之間(下一節將進一步討論)。
      就像在隱藏式瀏覽選單設計指南一樣,當抽屜是可見的時候, 你應該修改工具列的內容, 如改變標題和刪除操作Item. 下面的代碼用ActionBarDrawerToggle類的一個執行個體, 顯示了如何重寫DrawerLayout.DrawerListener的回調方法:

public class MainActivity extends Activity {    private DrawerLayout mDrawerLayout;    private ActionBarDrawerToggle mDrawerToggle;    private CharSequence mDrawerTitle;    private CharSequence mTitle;    ...    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        ...        mTitle = mDrawerTitle = getTitle();        mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);        mDrawerToggle = new ActionBarDrawerToggle(this, mDrawerLayout,                R.drawable.ic_drawer, R.string.drawer_open, R.string.drawer_close) {            /** Called when a drawer has settled in a completely closed state. */            public void onDrawerClosed(View view) {                super.onDrawerClosed(view);                getActionBar().setTitle(mTitle);                invalidateOptionsMenu(); // creates call to onPrepareOptionsMenu()            }            /** Called when a drawer has settled in a completely open state. */            public void onDrawerOpened(View drawerView) {                super.onDrawerOpened(drawerView);                getActionBar().setTitle(mDrawerTitle);                invalidateOptionsMenu(); // creates call to onPrepareOptionsMenu()            }        };        // Set the drawer toggle as the DrawerListener        mDrawerLayout.setDrawerListener(mDrawerToggle);    }    /* Called whenever we call invalidateOptionsMenu() */    @Override    public boolean onPrepareOptionsMenu(Menu menu) {        // If the nav drawer is open, hide action items related to the content view        boolean drawerOpen = mDrawerLayout.isDrawerOpen(mDrawerList);        menu.findItem(R.id.action_websearch).setVisible(!drawerOpen);        return super.onPrepareOptionsMenu(menu);    }}

下一節描述ActionBarDrawerToggle建構函式參數和其他所需的步驟來設定它來處理工具列的表徵圖.

開啟關閉應用表徵圖        使用者可以開啟和關閉隱藏式瀏覽選單, 通過手指從螢幕左側的邊緣滑動, 但如果你使用工具列, 你應該也能允許使用者開啟和關閉它, 通過觸摸應用程式圖示. 應用程式圖示也可以顯示一個特殊的表徵圖關於隱藏式瀏覽選單的狀態. 你可以實現所有這些行為通過使用ActionBarDrawerToggle, 如前一節所示。
讓ActionBarDrawerToggle工作, 建立一個它的執行個體用它的構造方法, 這就需要以下參數:

• 持有抽屜的Activity.
• DrawerLayout對象.
• 一個Drawable資源作為抽屜指標.
• 字串資源描述"開啟抽屜"動作.
• 字串資源描述"關閉抽屜"動作.

然後, 無論你是否已經建立了一個ActionBarDrawerToggle的子類作為你的抽屜的Listener, 你需要在幾個Activity生命週期的地方, 調用你的ActionBarDrawerToggle:

public class MainActivity extends Activity {    private DrawerLayout mDrawerLayout;    private ActionBarDrawerToggle mDrawerToggle;    ...    public void onCreate(Bundle savedInstanceState) {        ...        mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);        mDrawerToggle = new ActionBarDrawerToggle(                this,                  /* host Activity */                mDrawerLayout,         /* DrawerLayout object */                R.drawable.ic_drawer,  /* nav drawer icon to replace 'Up' caret */                R.string.drawer_open,  /* "open drawer" description */                R.string.drawer_close  /* "close drawer" description */                ) {            /** Called when a drawer has settled in a completely closed state. */            public void onDrawerClosed(View view) {                super.onDrawerClosed(view);                getActionBar().setTitle(mTitle);            }            /** Called when a drawer has settled in a completely open state. */            public void onDrawerOpened(View drawerView) {                super.onDrawerOpened(drawerView);                getActionBar().setTitle(mDrawerTitle);            }        };        // Set the drawer toggle as the DrawerListener        mDrawerLayout.setDrawerListener(mDrawerToggle);        getActionBar().setDisplayHomeAsUpEnabled(true);        getActionBar().setHomeButtonEnabled(true);    }    @Override    protected void onPostCreate(Bundle savedInstanceState) {        super.onPostCreate(savedInstanceState);        // Sync the toggle state after onRestoreInstanceState has occurred.        mDrawerToggle.syncState();    }    @Override    public void onConfigurationChanged(Configuration newConfig) {        super.onConfigurationChanged(newConfig);        mDrawerToggle.onConfigurationChanged(newConfig);    }    @Override    public boolean onOptionsItemSelected(MenuItem item) {        // Pass the event to ActionBarDrawerToggle, if it returns        // true, then it has handled the app icon touch event        if (mDrawerToggle.onOptionsItemSelected(item)) {          return true;        }        // Handle your other action bar items...        return super.onOptionsItemSelected(item);    }    ...}

官方Demo請在這裡下載（免積分）

Android組件——建立DrawerLayout導航