Drawer Layout

http://developer.android.com/training/implementing-navigation/nav-drawer.html#DrawerLayout

 <menu xmlns:android="http://schemas.android.com/apk/res/android" >
     <!--
         R.menu.main
         android:showAsAction="ifRoom|withText"
                     如果有空间的话，就实现图标和文字。
      -->
     <item
         android:id="@+id/action_websearch"
         android:icon="@drawable/action_search"
         android:showAsAction="ifRoom|withText"
         android:title="@string/action_websearch"/>
 </menu>

 <resources>

     <string name="app_name">左侧菜单</string>

     <string-array name="planets_array">
         <item>Mercury</item>
         <item>Venus</item>
         <item>Earth</item>
         <item>Mars</item>
         <item>Jupiter</item>
         <item>Saturn</item>
         <item>Uranus</item>
         <item>Neptune</item>
     </string-array>

     <string name="drawer_open">打开</string>
     <string name="drawer_close">关闭</string>
     <string name="action_websearch">WebSearch</string>
     <string name="app_not_available">Sorry, there\'s no web browser available</string>

 </resources>

 <!--
       【 注意事项 】
      1、主内容视图一定要是DrawerLayout的第一个子视图。
      2、主要内容视图宽度和高度匹配父视图，即“match_parent”。
      3、必须显示指定抽屉视图(如ListView)的android:layout_gravity属性
            android:layout_gravity="start"，从左向右滑出菜单；
            android:layout_gravity="end", 从右向左滑出菜单；
                            不推荐使用"left"和"right"。
      4、抽屉视图的宽度以dp为单位，请不要超过320dp(为了总能看到一些主内容视图)
  --> 

 <!-- A DrawerLayout is intended to be used as the top-level content view using match_parent
     for both width and height to consume the full space available. -->
 <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" >

     <!--
          As the main content view, the view below consumes the entire
          space available using match_parent in both dimensions.
     -->
     <!-- 在这里面动态插入Fragment -->
     <FrameLayout
         android:id="@+id/content_frame"
         android:layout_width="match_parent"
         android:layout_height="match_parent" />

     <!--
          android:layout_gravity="start" tells DrawerLayout to treat
          this as a sliding drawer on the left side for left-to-right
          languages and on the right side for right-to-left languages.
          The drawer is given a fixed width in dp and extends the full height of
          the container. A solid background is used for contrast
          with the content view.
     -->

     <!--
          android:layout_gravity="start"  从左向右滑动
          android:layout_gravity="end"    从右向左滑动
          android:choiceMode="singleChoice"  单选模式
      -->
     <ListView
         android:id="@+id/left_drawer"
         android:layout_width="240dp"
         android:layout_height="match_parent"
         android:layout_gravity="start"
         android:background="#111"
         android:choiceMode="singleChoice"
         android:divider="@android:color/transparent"
         android:dividerHeight="0dp" />

 </android.support.v4.widget.DrawerLayout>

 package com.example.android.navigationdrawerexample;

 import java.util.Locale;

 import android.app.Activity;
 import android.app.Fragment;
 import android.app.FragmentManager;
 import android.content.Intent;
 import android.content.res.Configuration;
 import android.net.Uri;
 import android.os.Bundle;
 import android.support.v4.app.ActionBarDrawerToggle;
 import android.support.v4.view.GravityCompat;
 import android.support.v4.widget.DrawerLayout;
 import android.view.LayoutInflater;
 import android.view.Menu;
 import android.view.MenuInflater;
 import android.view.MenuItem;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.AdapterView;
 import android.widget.ArrayAdapter;
 import android.widget.ImageView;
 import android.widget.ListView;
 import android.widget.Toast;

 public class MainActivity extends Activity {
     private DrawerLayout mDrawerLayout;
     private ListView mDrawerList;

     /*  1、mDrawerLayout.setDrawerListener(DrawerLayout.DrawerListener);
         2、ActionBarDrawerToggle是DrawerLayout.DrawerListener的具体实现类；
           1)改变android.R.id.home图标(构造方法)。
           2)Drawer拉出、隐藏，带有android.R.id.home动画效果(syncState())。
           3)监听Drawer拉出、隐藏事件。
         3、覆写ActionBarDrawerToggle的onDrawerOpened()和onDrawerClosed()以监听抽屉拉出或隐藏事件。
     */
     private ActionBarDrawerToggle mDrawerToggle;

     //private CharSequence mDrawerTitle;
     private CharSequence mTitle;
     private String[] mPlanetTitles;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);

         mTitle = getTitle();
         // ListView列表数据
         mPlanetTitles = getResources().getStringArray(R.array.planets_array);
         mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout);
         mDrawerList = (ListView) findViewById(R.id.left_drawer);

         // set a custom shadow that overlays the main content when the drawer
         // opens
         mDrawerLayout.setDrawerShadow(R.drawable.drawer_shadow, GravityCompat.START);
         // set up the drawer's list view with items and click listener
         mDrawerList.setAdapter(new ArrayAdapter<String>(this,
                 R.layout.drawer_list_item, mPlanetTitles));
         mDrawerList.setOnItemClickListener(new DrawerItemClickListener());

         // enable ActionBar app icon to behave as action to toggle nav drawer
         // 开启ActionBar上APP ICON的功能
         getActionBar().setDisplayHomeAsUpEnabled(true);
         getActionBar().setHomeButtonEnabled(true);

         /**
          * 第4个和第5个参数:打开和关闭的描述资源
          */
         mDrawerToggle = new ActionBarDrawerToggle(
                 this,
                 mDrawerLayout,
                 R.drawable.ic_drawer,
                 R.string.drawer_open,
                 R.string.drawer_close) {
             /** 覆写他的两个方法 */
             @Override /** 当被关闭时，执行这个方法 */
             public void onDrawerClosed(View view) {
                 getActionBar().setTitle(mTitle);
                 invalidateOptionsMenu();
             }
             @Override  /** 当被打开时，执行这个方法 */
             public void onDrawerOpened(View drawerView) {
                 getActionBar().setTitle("请选择");
                 // 重绘菜单项的ActionBar。
                 // 当调用此方法的时候，它会自动调用一个方法:Call onPrepareOptionsMenu(所以要重写)。
                 invalidateOptionsMenu();
             }
         };
         mDrawerLayout.setDrawerListener(mDrawerToggle);

         if (savedInstanceState == null) {
             selectItem(0);
         }
     }

     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
         MenuInflater inflater = getMenuInflater();
         inflater.inflate(R.menu.main, menu);
         return super.onCreateOptionsMenu(menu);
     }

     /* Called whenever we call invalidateOptionsMenu() */
     @Override
     public boolean onPrepareOptionsMenu(Menu menu) {
         // 根据打开和关闭来实现右上角的图片显示。
         boolean drawerOpen = mDrawerLayout.isDrawerOpen(mDrawerList);  // 获取打开状态
         menu.findItem(R.id.action_websearch).setVisible(!drawerOpen);
         return super.onPrepareOptionsMenu(menu);
     }

     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         // 将ActionBar上的图标与Drawer结合起来。
         // 点击左上角的图标，打开和关闭抽屉。
         if (mDrawerToggle.onOptionsItemSelected(item)) {
             return true;
         }
         switch (item.getItemId()) {
         case R.id.action_websearch:  // 右上角查询按钮
             Intent intent = new Intent();
             intent.setAction("android.intent.action.VIEW");
             Uri uri = Uri.parse("http://www.baidu.com");
             intent.setData(uri);
             // catch event that there's no activity to handle intent
             if (intent.resolveActivity(getPackageManager()) != null) {
                 startActivity(intent);
             } else {
                 Toast.makeText(this, R.string.app_not_available,
                         Toast.LENGTH_LONG).show();
             }
             return true;
         default:
             return super.onOptionsItemSelected(item);
         }
     }

     /* The click listner for ListView in the navigation drawer */
     private class DrawerItemClickListener implements
             ListView.OnItemClickListener {
         @Override
         public void onItemClick(AdapterView<?> parent, View view, int position,
                 long id) {
             selectItem(position);
         }
     }

     private void selectItem(int position) {
         Fragment fragment = new PlanetFragment();
         Bundle args = new Bundle();
         // 传入参数
         args.putInt(PlanetFragment.ARG_PLANET_NUMBER, position);
         fragment.setArguments(args);

         FragmentManager fragmentManager = getFragmentManager();
         fragmentManager.beginTransaction()
                 .replace(R.id.content_frame, fragment).commit();

         // update selected item and title, then close the drawer
         mDrawerList.setItemChecked(position, true);
         setTitle(mPlanetTitles[position]);
         mDrawerLayout.closeDrawer(mDrawerList);
     }

     @Override
     public void setTitle(CharSequence title) {
         mTitle = title;
         getActionBar().setTitle(mTitle);
     }

     /**
      * When using the ActionBarDrawerToggle, you must call it during
      * onPostCreate() and onConfigurationChanged()...
      */

     @Override
     protected void onPostCreate(Bundle savedInstanceState) {
         super.onPostCreate(savedInstanceState);
         // 需要将ActionDrawerToggle与DrawerLayout的状态同步。
         // 将ActionBarDrawerToggle中的drawer图标，设置为ActionBar中的Home-Button的ICON。
         mDrawerToggle.syncState();   // 实现同步即可。
     }

     @Override   // 当屏幕旋转的时候调用。实现重新配置。
     public void onConfigurationChanged(Configuration newConfig) {
         super.onConfigurationChanged(newConfig);
         // Pass any configuration change to the drawer toggls
         mDrawerToggle.onConfigurationChanged(newConfig);
     }

     /**
      * Fragment that appears in the "content_frame", shows a planet
      */
     public static class PlanetFragment extends Fragment {
         public static final String ARG_PLANET_NUMBER = "planet_number";

         public PlanetFragment() {
             // Empty constructor required for fragment subclasses
         }

         @Override
         public View onCreateView(LayoutInflater inflater, ViewGroup container,
                 Bundle savedInstanceState) {
             View rootView = inflater.inflate(R.layout.fragment_planet,
                     container, false);
             int i = getArguments().getInt(ARG_PLANET_NUMBER);
             String planet = getResources()
                     .getStringArray(R.array.planets_array)[i];

             int imageId = getResources().getIdentifier(
                     planet.toLowerCase(Locale.getDefault()), "drawable",
                     getActivity().getPackageName());
             ((ImageView) rootView.findViewById(R.id.image))
                     .setImageResource(imageId);
             getActivity().setTitle(planet);
             return rootView;
         }
     }
 }