創(chuàng)建2D選擇器(2D Picker)

以下內(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,或自定義。

*GridViewPager*

并不是所有行都有相同數(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()));  
  }
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容