以下內(nèi)容翻譯自android wear的官方教程,本人水平有限,如有錯(cuò)誤歡迎指出
home
以下正文
在android wear中的2D Picker模式允許用戶(hù)在一系列pages中瀏覽和選擇。Wearable UI Library使你非常容易地實(shí)現(xiàn)這個(gè)模式。
為了實(shí)現(xiàn)這個(gè)模式,你需要添加 GridViewPager
元素到你的activity的layout上并實(shí)現(xiàn)一個(gè)提供數(shù)頁(yè)信息的 FragmentGridPagerAdapter
。
添加一個(gè)網(wǎng)格紙(Page Grid)
在你的layout當(dāng)中添加以下元素
<android.support.wearable.view.GridViewPager
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/pager"
android:layout_width="match_parent"
android:layout_height="match_parent" />
你可以使用 定義android wear layouts中描述的技術(shù)來(lái)確保該控件在圓和方的表面上都顯示良好。
實(shí)現(xiàn)Adapter
一個(gè)page adpater為 GridViewPager
提供了一系列頁(yè)面。你需要繼承 FragmentGridPagerAdapter
來(lái)實(shí)現(xiàn)你的adapter.
下面的代碼展示了如何提供一系列帶有自定義圖片背景的靜態(tài)頁(yè)面。
public class SampleGridPagerAdapter extends FragmentGridPagerAdapter {
private final Context mContext;
private List mRows;
public SampleGridPagerAdapter(Context ctx, FragmentManager fm) {
super(fm);
mContext = ctx;
}
static final int[] BG_IMAGES = new int[] {
R.drawable.debug_background_1, ...
R.drawable.debug_background_5
};
// 一個(gè)用于每個(gè)頁(yè)面的簡(jiǎn)單靜態(tài)數(shù)據(jù)容器
private static class Page {
// static resources
int titleRes;
int textRes;
int iconRes;
...
}
// 創(chuàng)建一個(gè)靜態(tài)的二維pages表
private final Page[][] PAGES = { ... };
// 要重寫(xiě)(Override)的方法
...
}
這個(gè)adapter將會(huì)調(diào)用 [getFragment()
](http://developer.android.youdaxue.com/reference/android/support/wearable/view/FragmentGridPagerAdapter.html#getFragment(int, int))和 getBackgroundForRow()
方法來(lái)檢索(retrieve)每一行所要展示的內(nèi)容
// 獲取在特定位置的Fragment
@Override
public Fragment getFragment(int row, int col) {
Page page = PAGES[row][col];
String title =
page.titleRes != 0 ? mContext.getString(page.titleRes) : null;
String text =
page.textRes != 0 ? mContext.getString(page.textRes) : null;
CardFragment fragment = CardFragment.create(title, text, page.iconRes);
// 建議設(shè)置(card gravity, card expansion/scrolling)
fragment.setCardGravity(page.cardGravity);
fragment.setExpansionEnabled(page.expansionEnabled);
fragment.setExpansionDirection(page.expansionDirection);
fragment.setExpansionFactor(page.expansionFactor);
return fragment;
}
// 獲取每一行的背景圖片
@Override
public Drawable getBackgroundForRow(int row) {
return mContext.getResources().getDrawable(
(BG_IMAGES[row % BG_IMAGES.length]), null);
}
下面的例子展示了怎么檢索(retrieve)特定頁(yè)面的背景
// 為特定的page獲取背景圖片
@Override
public Drawable getBackgroundForPage(int row, int column) {
if( row == 2 && column == 1) {
// 返回特定的位置所要顯示的背景圖片
return mContext.getResources().getDrawable(R.drawable.bugdroid_large, null);
} else {
// 默認(rèn)每一行所設(shè)定的背景圖片
eturn GridPagerAdapter.BACKGROUND_NONE;
}
}
getRowCount()
告訴adapter有多少行內(nèi)容, getColumnCount()
返回每一行由多少個(gè)內(nèi)容。
// 獲取頁(yè)面的行數(shù)
@Override
public int getRowCount() {
return PAGES.length;
}
// 獲取頁(yè)面組對(duì)應(yīng)行的Pages的個(gè)數(shù)
@Override
public int getColumnCount(int rowNum) {
return PAGES[rowNum].length;
}
apapter實(shí)現(xiàn)的細(xì)節(jié)依賴(lài)于你想要設(shè)計(jì)什么樣的頁(yè)面組。每個(gè)頁(yè)面都是Fragment的子類(lèi)。在這個(gè)例子當(dāng)中,每個(gè)頁(yè)面是 CardFragment
的實(shí)例。你也可以在一個(gè)2D Picker中指定不同類(lèi)型的Pages,比如cards,action icon,或自定義。

并不是所有行都有相同數(shù)量的pages。你可以發(fā)現(xiàn)在本例中,每一行都有不同數(shù)量的pages,你也可以創(chuàng)建只有一行或一列的1D Picker.
GridViewPager
對(duì)于內(nèi)容超出邊界的頁(yè)面提供了可以滾動(dòng)內(nèi)容的支持。在本例中,我們?cè)O(shè)置了當(dāng)需要時(shí)自動(dòng)拓展卡片,所以用戶(hù)可以滾動(dòng)卡片的內(nèi)容。如果用戶(hù)滾動(dòng)到了底部,一個(gè)手柄(swipe)將會(huì)出現(xiàn)在同一方向來(lái)導(dǎo)航下一頁(yè)的內(nèi)容(如果下一頁(yè)有的話(huà))。
你可以用 [getBackgroundForPage()
](http://developer.android.youdaxue.com/reference/android/support/wearable/view/GridPagerAdapter.html#getBackgroundForPage(int, int)) 方法來(lái)指定每一個(gè)page的背景圖片。在用戶(hù)切換Page的時(shí)候,不同的背景圖片就會(huì)自動(dòng)出現(xiàn)平移和交叉淡化的效果。
給page grid分配一個(gè)adapter
在你的activity中,創(chuàng)建一個(gè)adapter的實(shí)例然后分配給GridViewPager
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
final GridViewPager pager = (GridViewPager) findViewById(R.id.pager);
pager.setAdapter(new SampleGridPagerAdapter(this, getFragmentManager()));
}
}