このセクションの導入:
このセクションでは、基本UIコントロール部分の最後のコントロールを紹介します:DrawerLayout、公式が提供するスライドメニューコントロールです。前のセクションのViewPagerと同じように、3.0以降で導入されました。低バージョンで使用するにはv4互換パッケージが必要です。スライドメニューと言えば、github上のSlidingMenuを使ったことがある人も多いでしょう。ただし、2つのバージョンがあるようです。1つは単体のもの、もう1つは別のオープンソースプロジェクトActionBarSherlockに依存するものです。Googleがこのコントロールを提供しているので、使わない手はありません。しかもMaterial Design設計規範では、至る所で見られる多くのスライドメニューのアニメーション効果は、ほとんどToolbar + DrawerLayoutで実現できます。このセクションでは、このDrawerLayoutの基本的な使い方を探っていきます。また、ドロワーコントロールと呼ぶ人もいます。公式ドキュメント:DrawerLayout
1. 使用上の注意事項
- 1. メインコンテンツビューは必ずDrawerLayoutの最初の子ビューであること
- 2. メインコンテンツビューの幅と高さはmatch_parentにする必要があります
- 3. スライドビューのandroid:を明示的に指定する必要がありますlayout_gravity属性android:layout_gravity = "start" の場合、左から右にメニューがスライドアウトします android:layout_gravity = "end" の場合、右から左にメニューがスライドアウトします left と right の使用は推奨しません!!!
- スライドビューの幅はdp単位で、超えないことを推奨します320dp(メインコンテンツビューを常に少しでも見えるようにするため)
- スライドイベントの設定:mDrawerLayout.setDrawerListener(DrawerLayout.DrawerListener);
- 一つ言っておくと:Actionbarと組み合わせて使用でき、ユーザーがActionbar上のアプリアイコンをクリックすると、スライドメニューがポップアップします! ここでは次のものを使用しますActionBarDrawerToggleこれはDrawerLayout.DrawerListenerの具体的な実装クラスで、 ActionBarDrawerToggleのonDrawerOpened()とonDrawerClosed()をオーバーライドして、ドロワーが引き出される、または非表示になるイベントを監視できます! ただし、ここでは説明しません。5.0以降はToolbarを使用するためです! 興味があれば、自分で関連ドキュメントを調べてください!
2. コード例の使用
サンプル1:単一スライドメニューの実装
実行効果図:

実装の主要コード:
まずはメインレイアウトです。注意:最外部はDrawerLayoutにしてください!!!!
activity_main.xml:
<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">
<FrameLayout
android:id="@+id/ly_content"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<ListView
android:id="@+id/list_left_drawer"
android:layout_width="180dp"
android:layout_height="match_parent"
android:layout_gravity="start"
android:background="#080808"
android:choiceMode="singleChoice"
android:divider="#FFFFFF"
android:dividerHeight="1dp" />
</android.support.v4.widget.DrawerLayout>
次にListViewのレイアウトコードとドメインクラスです:Itemは簡単なので省略します。直接、中央のFragmentのレイアウトとコードを示します! また、Adapterは以前作成した再利用可能なMyAdapterをそのまま使用します!
fg_content.xml:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<TextView
android:id="@+id/tv_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:textSize="25sp" />
</RelativeLayout>
ContentFragment.java:
/**
* Created by Jay on 2015/10/8 0008.
*/
public class ContentFragment extends Fragment {
private TextView tv_content;
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fg_content, container, false);
tv_content = (TextView) view.findViewById(R.id.tv_content);
String text = getArguments().getString("text");
tv_content.setText(text);
return view;
}
}
最後にActivityクラスです
MainActivity.java:
public class MainActivity extends AppCompatActivity implements AdapterView.OnItemClickListener{
private DrawerLayout drawer_layout;
private ListView list_left_drawer;
private ArrayList<Item> menuLists;
private MyAdapter<Item> myAdapter = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
drawer_layout = (DrawerLayout) findViewById(R.id.drawer_layout);
list_left_drawer = (ListView) findViewById(R.id.list_left_drawer);
menuLists = new ArrayList<Item>();
menuLists.add(new Item(R.mipmap.iv_menu_realtime,"实时信息"));
menuLists.add(new Item(R.mipmap.iv_menu_alert,"提醒通知"));
menuLists.add(new Item(R.mipmap.iv_menu_trace,"活动路线"));
menuLists.add(new Item(R.mipmap.iv_menu_settings,"相关设置"));
myAdapter = new MyAdapter<Item>(menuLists,R.layout.item_list) {
@Override
public void bindView(ViewHolder holder, Item obj) {
holder.setImageResource(R.id.img_icon,obj.getIconId());
holder.setText(R.id.txt_content, obj.getIconName());
}
};
list_left_drawer.setAdapter(myAdapter);
list_left_drawer.setOnItemClickListener(this);
}
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
ContentFragment contentFragment = new ContentFragment();
Bundle args = new Bundle();
args.putString("text", menuLists.get(position).getIconName());
contentFragment.setArguments(args);
FragmentManager fm = getSupportFragmentManager();
fm.beginTransaction().replace(R.id.ly_content,contentFragment).commit();
drawer_layout.closeDrawer(list_left_drawer);
}
}
コードはとても簡単なので、詳しい説明は省略します~
サンプル2. 左右2つのスライドメニューの実装
うーん、気づいたかもしれませんが、上記のDrawerLayoutのレイアウトから、DrawerLayoutは最大3つの部分から構成されることがだいたい推測できます: 中央のコンテンツ部分、左のスライドメニュー部分、右のスライドメニュー部分です! 次に、2つのスライドメニューを持つサンプルを書いてみましょう!
実行効果図:

コード実装:
まず、2つのFragmentと対応するレイアウトを作成します。それらはそれぞれ左右のスライドメニューです!
左側のFragment:
レイアウト:fg_left.xml、ここでは画像を1つ使っただけで、クリックすると新しいActivityが表示されます;もちろん、自分のニーズに応じて拡張できます!
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/img_bg"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@mipmap/bg_menu_left"/>
</LinearLayout>
対応するLeftFragment.java:
/**
* Created by Jay on 2015/10/9 0009.
*/
public class LeftFragment extends Fragment{
private DrawerLayout drawer_layout;
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fg_left, container, false);
ImageView img_bg = (ImageView) view.findViewById(R.id.img_bg);
img_bg.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
getActivity().startActivity(new Intent(getActivity(),OtherActivity.class));
drawer_layout.closeDrawer(Gravity.START);
}
});
return view;
}
//暴露给Activity,用于传入DrawerLayout,因为点击后想关掉DrawerLayout
public void setDrawerLayout(DrawerLayout drawer_layout){
this.drawer_layout = drawer_layout;
}
}
右側のFragment:
レイアウトは3つのボタンだけで、クリックすると中央部分のFragmentを置き換えます。レイアウトはfg_right.xmlコードは次のとおりです:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#2F9AF2"
android:gravity="center"
android:orientation="vertical">
<Button
android:id="@+id/btn_one"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="菜单项一" />
<Button
android:id="@+id/btn_two"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="菜单项二" />
<Button
android:id="@+id/btn_three"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="菜单项三" />
</LinearLayout>
次に対応するのはRightFragment.java:
/**
* Created by Jay on 2015/10/9 0009.
*/
public class RightFragment extends Fragment implements View.OnClickListener{
private DrawerLayout drawer_layout;
private FragmentManager fManager;
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fg_right, container, false);
view.findViewById(R.id.btn_one).setOnClickListener(this);
view.findViewById(R.id.btn_two).setOnClickListener(this);
view.findViewById(R.id.btn_three).setOnClickListener(this);
fManager = getActivity().getSupportFragmentManager();
return view;
}
@Override
public void onClick(View v) {
switch (v.getId()){
case R.id.btn_one:
ContentFragment cFragment1 = new ContentFragment("1.点击了右侧菜单项一",R.color.blue);
fManager.beginTransaction().replace(R.id.fly_content,cFragment1).commit();
drawer_layout.closeDrawer(Gravity.END);
break;
case R.id.btn_two:
ContentFragment cFragment2 = new ContentFragment("2.点击了右侧菜单项二",R.color.red);
fManager.beginTransaction().replace(R.id.fly_content,cFragment2).commit();
drawer_layout.closeDrawer(Gravity.END);
break;
case R.id.btn_three:
ContentFragment cFragment3 = new ContentFragment("3.点击了右侧菜单项三",R.color.yellow);
fManager.beginTransaction().replace(R.id.fly_content,cFragment3).commit();
drawer_layout.closeDrawer(Gravity.END);
break;
}
}
public void setDrawerLayout(DrawerLayout drawer_layout){
this.drawer_layout = drawer_layout;
}
}
さらに、中央部分を埋めるContentFragmentもあります。レイアウト:fg_content.xml次のとおりです:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<TextView
android:id="@+id/tv_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:textSize="25sp" />
</RelativeLayout>
ContentFragment.java:
public class ContentFragment extends Fragment {
private TextView tv_content;
private String strContent;
private int bgColor;
public ContentFragment(String strContent,int bgColor) {
this.strContent = strContent;
this.bgColor = bgColor;
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fg_content, container, false);
view.setBackgroundColor(getResources().getColor(bgColor));
tv_content = (TextView) view.findViewById(R.id.tv_content);
tv_content.setText(strContent);
return view;
}
}
書き終えたら、ActivityのレイアウトとActivityのコードに進みます: その前に、上部バーのレイアウトも作成する必要があります:
view_topbar.xml:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="#DCDEDB">
<Button
android:id="@+id/btn_right"
android:layout_width="40dp"
android:layout_height="40dp"
android:layout_centerVertical="true"
android:layout_alignParentRight="true"
android:background="@drawable/btn_selctor"/>
</RelativeLayout>
次にactivity_main.xml:
<android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/drawer_layout"
android:layout_width="match_parent"
android:layout_height="match_parent">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<include
android:id="@+id/topbar"
layout="@layout/view_topbar"
android:layout_width="wrap_content"
android:layout_height="48dp" />
<FrameLayout
android:id="@+id/fly_content"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
<fragment
android:id="@+id/fg_left_menu"
android:name="jay.com.drawerlayoutdemo2.LeftFragment"
android:layout_width="300dp"
android:layout_height="match_parent"
android:layout_gravity="start"
android:tag="LEFT"
tools:layout="@layout/fg_left" />
<fragment
android:id="@+id/fg_right_menu"
android:name="jay.com.drawerlayoutdemo2.RightFragment"
android:layout_width="100dp"
android:layout_height="match_parent"
android:layout_gravity="end"
android:tag="RIGHT"
tools:layout="@layout/fg_right" />
</android.support.v4.widget.DrawerLayout>
最後にMainActivity.java:
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
private DrawerLayout drawer_layout;
private FrameLayout fly_content;
private View topbar;
private Button btn_right;
private RightFragment fg_right_menu;
private LeftFragment fg_left_menu;
private FragmentManager fManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
fManager = getSupportFragmentManager();
fg_right_menu = (RightFragment) fManager.findFragmentById(R.id.fg_right_menu);
fg_left_menu = (LeftFragment) fManager.findFragmentById(R.id.fg_left_menu);
initViews();
}
private void initViews() {
drawer_layout = (DrawerLayout) findViewById(R.id.drawer_layout);
fly_content = (FrameLayout) findViewById(R.id.fly_content);
topbar = findViewById(R.id.topbar);
btn_right = (Button) topbar.findViewById(R.id.btn_right);
btn_right.setOnClickListener(this);
//设置右面的侧滑菜单只能通过编程来打开
drawer_layout.setDrawerLockMode(DrawerLayout.LOCK_MODE_LOCKED_CLOSED,
Gravity.END);
drawer_layout.setDrawerListener(new DrawerLayout.DrawerListener() {
@Override
public void onDrawerSlide(View view, float v) {
}
@Override
public void onDrawerOpened(View view) {
}
@Override
public void onDrawerClosed(View view) {
drawer_layout.setDrawerLockMode(
DrawerLayout.LOCK_MODE_LOCKED_CLOSED, Gravity.END);
}
@Override
public void onDrawerStateChanged(int i) {
}
});
fg_right_menu.setDrawerLayout(drawer_layout);
fg_left_menu.setDrawerLayout(drawer_layout);
}
@Override
public void onClick(View v) {
drawer_layout.openDrawer(Gravity.RIGHT);
drawer_layout.setDrawerLockMode(DrawerLayout.LOCK_MODE_UNLOCKED,
Gravity.END); //解除锁定
}
}
では、これで完成です~。ふう。次に、コードを見るときに疑問に思うかもしれない点を説明します:
- 1. drawer_layout.openDrawer(Gravity.END);
この文は、どのメニューを開くかを設定するもので、STARTは左側、ENDは右側を表します- 2. drawer_layout.setDrawerLockMode(DrawerLayout.LOCK_MODE_LOCKED_CLOSED,Gravity.END); 右側のスライドメニューをロックします。ジェスチャーで閉じたり開いたりすることはできず、コードでのみ開くことができます!つまりopenDrawerメソッドを呼び出します! 次に drawer_layout.setDrawerLockMode(DrawerLayout.LOCK_MODE_UNLOCKED,Gravity.END); ロック状態を解除します。つまり、ジェスチャーでスライドメニューを閉じることができます。 最後にドロワーが閉じるときに呼び出します: drawer_layout.setDrawerLockMode(DrawerLayout.LOCK_MODE_LOCKED_CLOSED, Gravity.END); 右側のスライドメニューを再度ロックします!
- 3. レイアウトコード内のTag属性の役割は? 答え:ここでは使用していません。DrawerListenerのonDrawerSlideメソッドをオーバーライドするとき、その最初のパラメータdrawerViewを使って、drawerView.getTag().equals("START")を呼び出すことで、どのメニューがイベントをトリガーしたかを判断できます!そして対応する操作を行うことができます!
3. コード例のダウンロード
DrawerLayoutDemo.zip
DrawerLayoutDemo2.zip
このセクションのまとめ:
では、このセクションでは公式のスライドコントロールDrawerLayoutの基本的な使い方を紹介しました。とても便利に使えます! もちろん、ここでは簡単な使用デモにすぎません。また、弘扬大神が次の記事を書いているのを見かけました:Android DrawerLayout でQQ5.2の双方向スライドメニューをハイクオリティ再現興味があれば見てみてください。このセクションの内容を読み終えていれば、それほど苦労せずに理解できると思います。では!
このセクションはここまでです。UIコントロールの章に別れを告げましょう~。次の章では描画とアニメーションを始めます。 上級編のカスタムコントロールシリーズの基礎を固めるためです!
