Android FragmentBreadCrumbs を使ってパン屑リストを作る

API Level 11 からパン屑リストを表示するための ViewGroup である FragmentBreadCrumbs が用意されています。

使い方は
res/layout/main.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:orientation="vertical" > <android.app.FragmentBreadCrumbs android:id="@+id/bread_crumbs" android:layout_width="match_parent" android:layout_height="wrap_content" /> ... </LinearLayout>

のようにレイアウトに入れてもいいし、

private FragmentBreadCrumbs mFragmentBreadCrumbs; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); mFragmentBreadCrumbs = new FragmentBreadCrumbs(this); ActionBar actionBar = getActionBar(); actionBar.setCustomView(mFragmentBreadCrumbs); actionBar.setDisplayShowCustomEnabled(true); actionBar.setDisplayShowTitleEnabled(false); ... }

のように ActionBar の CustomView として表示してもいい。

FragmentBreadCrumbs のリファレンスには ActionBar.setCustomView(View) を使って Action Bar に配置する目的のものです、とあるので Action Bar に置くのがいいのかな。
まぁでも iosched とかは普通にレイアウトに置いてるので、Action Bar に置かなくてもいいと思う。

setActivity(Activity a) で activity のインスタンスをセットして使う。

private FragmentBreadCrumbs mFragmentBreadCrumbs; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); mFragmentBreadCrumbs = new FragmentBreadCrumbs(this); ActionBar actionBar = getActionBar(); actionBar.setCustomView(mFragmentBreadCrumbs); actionBar.setDisplayShowCustomEnabled(true); actionBar.setDisplayShowTitleEnabled(false); mFragmentBreadCrumbs.setActivity(this); mFragmentBreadCrumbs.setMaxVisible(3); mFragmentBreadCrumbs.setParentTitle("preParent", "preSP", null); mFragmentBreadCrumbs.setTitle("preTitle", "preST"); mFragmentBreadCrumbs.setOnBreadCrumbClickListener(new FragmentBreadCrumbs.OnBreadCrumbClickListener() { @Override public boolean onBreadCrumbClick(BackStackEntry backStack, int flags) { if(backStack != null) { Log.d("onBreadCrumbClick", backStack.getName() + ", " + flags); } return false; } });

setMaxVisible(int max) メソッドで最大表示数を指定できる。

setMaxVisible() で 3 を指定した状態

最大表示数を指定していない状態

setParentTitle(CharSequence title, CharSequence shortTitle, View.OnClickListener listener) でパン屑リストの初期位置での親エントリのタイトルをセットできる。オプショナル。
shortTitle がどこで使われるのかはよくわからなかった。
第３引数でパン屑リストのこの親タイトルがタップされたときにリスナーをセットできる。

setTitle(CharSequence title, CharSequence shortTitle) で現在の位置でのパン屑リストのタイトルをセットできる。

setOnBreadCrumbClickListener(FragmentBreadCrumbs.OnBreadCrumbClickListener listener) でパン屑リストがタップされたときのリスナーをセットできる。パン屑リストの内の親エントリのどれかがタップされると、FragmentBreadCrumbs.OnBreadCrumbClickListener の onBreadCrumbClick(BackStackEntry backStack, int flags) が呼ばれ、第１引数で関連づけられている BackStackEntry が渡される。BackStackEntry は back stack で保持されるエントリで、FragmentTransaction.addToBackStack() によって生成され、FragmentManager が管理する。FragmentManager.getBackStackEntryAt() で取得することができる。



FragmentTransaction で、back stack に入れる BackStackEntry に FragmentBreadCrumbs のタイトルをセットできる。

• setBreadCrumbShortTitle(int res)
  このトランザクションが back stack 上にあるときにパン屑リストに表示されるショートタイトルのリソースIDをセットする
  
• setBreadCrumbShortTitle(CharSequence text)
  このトランザクションが back stack 上にあるときにパン屑リストに表示されるショートタイトルをセットする デバイスの言語設定が変わった場合に、文字をあとから変えることができないので推奨されていない
  
• setBreadCrumbTitle(int res)
  このトランザクションが back stack 上にあるときにパン屑リストに表示されるタイトルのリソースIDをセットする
  
• setBreadCrumbTitle(CharSequence text)
  このトランザクションが back stack 上にあるときにパン屑リストに表示されるタイトルをセットする デバイスの言語設定が変わった場合に、文字をあとから変えることができないので推奨されていない

@Override public void onClick(View v) { FragmentManager manager = getFragmentManager(); FragmentTransaction ft = manager.beginTransaction(); MainFragment2 fragment = MainFragment2.getInstance(); int id = v.getId(); switch (id) { case R.id.add_btn: { ft.setBreadCrumbShortTitle("sTitle"); ft.setBreadCrumbTitle("Title"); ft.addToBackStack("MainFragment2"); ft.add(R.id.container, fragment, "MainFragment"); break; } case R.id.remove_btn: { if(manager.getBackStackEntryCount() > 0) { manager.popBackStack(); ft.remove(fragment); } break; } ... } ft.commit(); }
addToBackStack() とひもづくので戻るボタンを押して戻すと、パン屑リストもちゃんと一段もどる。

ちなみに FragmentBreadCrumbs のデフォルトのスタイルは Widget_FragmentBreadCrumbs で定義されていて、styles.xml ではこんな感じ 677 <!-- Default style for {@link android.app.FragmentBreadCrumbs} view. --> 678 <style name="Widget.FragmentBreadCrumbs"> 679 <item name="android:padding">4dp</item> 680 <item name="android:animateLayoutChanges">true</item> 681 </style> ViewGroup なので LayoutTransition でパン屑リストが変わるときにもっと複雑なアニメーションをつけることも可能。