以下内容翻译自android wear的官方教程,本人水平有限,如有错误欢迎指出
home
以下正文
在android wear中的2D Picker模式允许用户在一系列pages中浏览和选择。Wearable UI Library使你非常容易地实现这个模式。
为了实现这个模式,你需要添加 GridViewPager
元素到你的activity的layout上并实现一个提供数页信息的 FragmentGridPagerAdapter
。
添加一个网格纸(Page Grid)
在你的layout当中添加以下元素
<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中描述的技术来确保该控件在圆和方的表面上都显示良好。
实现Adapter
一个page adpater为 GridViewPager
提供了一系列页面。你需要继承 FragmentGridPagerAdapter
来实现你的adapter.
下面的代码展示了如何提供一系列带有自定义图片背景的静态页面。
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
};
// 一个用于每个页面的简单静态数据容器
private static class Page {
// static resources
int titleRes;
int textRes;
int iconRes;
...
}
// 创建一个静态的二维pages表
private final Page[][] PAGES = { ... };
// 要重写(Override)的方法
...
}
这个adapter将会调用 [getFragment()
](http://developer.android.youdaxue.com/reference/android/support/wearable/view/FragmentGridPagerAdapter.html#getFragment(int, int))和 getBackgroundForRow()
方法来检索(retrieve)每一行所要展示的内容
// 获取在特定位置的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);
// 建议设置(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)特定页面的背景
// 为特定的page获取背景图片
@Override
public Drawable getBackgroundForPage(int row, int column) {
if( row == 2 && column == 1) {
// 返回特定的位置所要显示的背景图片
return mContext.getResources().getDrawable(R.drawable.bugdroid_large, null);
} else {
// 默认每一行所设定的背景图片
eturn GridPagerAdapter.BACKGROUND_NONE;
}
}
getRowCount()
告诉adapter有多少行内容, getColumnCount()
返回每一行由多少个内容。
// 获取页面的行数
@Override
public int getRowCount() {
return PAGES.length;
}
// 获取页面组对应行的Pages的个数
@Override
public int getColumnCount(int rowNum) {
return PAGES[rowNum].length;
}
apapter实现的细节依赖于你想要设计什么样的页面组。每个页面都是Fragment的子类。在这个例子当中,每个页面是 CardFragment
的实例。你也可以在一个2D Picker中指定不同类型的Pages,比如cards,action icon,或自定义。
并不是所有行都有相同数量的pages。你可以发现在本例中,每一行都有不同数量的pages,你也可以创建只有一行或一列的1D Picker.
GridViewPager
对于内容超出边界的页面提供了可以滚动内容的支持。在本例中,我们设置了当需要时自动拓展卡片,所以用户可以滚动卡片的内容。如果用户滚动到了底部,一个手柄(swipe)将会出现在同一方向来导航下一页的内容(如果下一页有的话)。
你可以用 [getBackgroundForPage()
](http://developer.android.youdaxue.com/reference/android/support/wearable/view/GridPagerAdapter.html#getBackgroundForPage(int, int)) 方法来指定每一个page的背景图片。在用户切换Page的时候,不同的背景图片就会自动出现平移和交叉淡化的效果。
给page grid分配一个adapter
在你的activity中,创建一个adapter的实例然后分配给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()));
}
}