轉載請注明出處: 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);
}
@Override
public 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請在這裡下載下傳(免積分)