*以下内容翻译自android wear的官方教程,本人水平有限,如有错误欢迎指出
home
以下正文
列表可以让用户在手表上在一系列选择中选择一个项目(item)。本文将介绍如何在你的app上创建列表
Wearable UI Library包含的WearableListView
可以为手表创建最佳的列表。
创建列表的方法:
- 添加一个WearableListView
元素在你的activity的layout中。 - 实现Item的layout
- 用上面实现的来创建item的layout
- 创建用来填充(populate)列表配适器(adapter)
- 把配适器分配给WearableListView元素
以下是详细步骤
添加一个List View
这个list view 在BoxInsertLayout当中,所以这个列表可以合适的显示在圆形和方形的设备上。
<android.support.wearable.view.BoxInsetLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:background="@drawable/robot_background"
android:layout_height="match_parent"
android:layout_width="match_parent">
<FrameLayout
android:id="@+id/frame_layout"
android:layout_height="match_parent"
android:layout_width="match_parent"
app:layout_box="left|bottom|right">
<android.support.wearable.view.WearableListView
android:id="@+id/wearable_list"
android:layout_height="match_parent"
android:layout_width="match_parent">
</android.support.wearable.view.WearableListView>
</FrameLayout>
</android.support.wearable.view.BoxInsetLayout>
创建WearableListItemLayout的实现
在很多的实例中,每个项目(item)都包含了一个icon和一个说明。而在下面的 WearableListView.OnCenterProximityListener接口的实现中,这种布局也会在用户划过这个列表项时改变icon的颜色和淡化文本。
public class WearableListItemLayout extends LinearLayout
implements WearableListView.OnCenterProximityListener {
private ImageView mCircle;
private TextView mName;
private final float mFadedTextAlpha;
private final int mFadedCircleColor;
private final int mChosenCircleColor;
public WearableListItemLayout(Context context) {
this(context, null);
}
public WearableListItemLayout(Context context, AttributeSet attrs) {
this(context, attrs, 0);
}
public WearableListItemLayout(Context context, AttributeSet attrs,int defStyle){
super(context, attrs, defStyle);
mFadedTextAlpha = getResources().
getInteger(R.integer.action_text_faded_alpha) / 100f;
mFadedCircleColor = getResources().getColor(R.color.grey);
mChosenCircleColor = getResources().getColor(R.color.blue);
}
// 获取在layout定义中的icon和文本控件。
@Override
protected void onFinishInflate() {
super.onFinishInflate();
// 这些时在layout文件中的项目(items)的定义
// (在下一个section)
mCircle = (ImageView) findViewById(R.id.circle);
mName = (TextView) findViewById(R.id.name);
}
@Override
public void onCenterPosition(boolean animate) {
mName.setAlpha(1f);
((GradientDrawable)mCircle.getDrawable()).setColor(mChosenCircleColor);
}
@Override
public void onNonCenterPosition(boolean animate) {
((GradientDrawable)mCircle.getDrawable()).setColor(mFadedCircleColor);
mName.setAlpha(mFadedTextAlpha);
}
}
你可以创造一个animator来扩大icon。在onCenterPosition和onNonCenterPosition这两个回调方法中,你可以自定义动画。关于动画你可以查看 Animating with ObjectAnimator
定义item的layout
res/layout/list_item.xml
<com.example.android.support.wearable.notifications.WearableListItemLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:gravity="center_vertical"
android:layout_width="match_parent"
android:layout_height="80dp">
<ImageView
android:id="@+id/circle"
android:layout_height="20dp"
android:layout_margin="16dp"
android:layout_width="20dp"
android:src="@drawable/wl_circle"/>
<TextView
android:id="@+id/name"
android:gravity="center_vertical|left"
android:layout_width="wrap_content"
android:layout_marginRight="16dp"
android:layout_height="match_parent"
android:fontFamily="sans-serif-condensed-light"
android:lineSpacingExtra="-4sp"
android:textColor="@color/text_color"
android:textSize="16sp"/>
</com.example.android.support.wearable.notifications.WearableListItemLayout>
创建一个用于填充列表的配适器
下面的一个字符串数据集(dataset)的Adapter。
private static final class Adapter extends WearableListView.Adapter {
private String[] mDataset;
private final Context mContext;
private final LayoutInflater mInflater;
// 为数据集提供一个合适的构造函数
public Adapter(Context context, String[] dataset) {
mContext = context;
mInflater = LayoutInflater.from(context);
mDataset = dataset;
}
// 提供你要使用的控件的引用
public static class ItemViewHolder extends WearableListView.ViewHolder {
private TextView textView;
public ItemViewHolder(View itemView) {
super(itemView);
// 在item的layout中找TextView
textView = (TextView) itemView.findViewById(R.id.name);
}
}
// 创建新的views
// (被WearableListView's layout manager回调)
@Override
public WearableListView.ViewHolder onCreateViewHolder(ViewGroup parent,int viewType) {
// Inflate 我们的item的layout
return new ItemViewHolder(mInflater.inflate(R.layout.list_item, null));
}
// 刷新item的内容
// 比起新建一个,list会刷新一下内容来重用。
// (由WearableListView's layout manager来调用)
@Override
public void onBindViewHolder(WearableListView.ViewHolder holder,int position) {
// 重新获取text view
ItemViewHolder itemHolder = (ItemViewHolder) holder;
TextView view = itemHolder.textView;
// 刷新文本内容
view.setText(mDataset[position]);
// 替换item的元数据
holder.itemView.setTag(position);
}
// 返回你的数据集(dataset)的大小
// (由WearableListView's layout manager调用)
@Override
public int getItemCount() {
return mDataset.length;
}
}
把Adapter分配给列表并设置单击时间
在你的activity中,把上面的adapter的实例(instance)分配给 WearableListView.OnCenterProximityListener
。然后设置点击事件
public class WearActivity extends Activity implements WearableListView.ClickListener {
// 数据集样例
String[] elements = { "List Item 1", "List Item 2", ... };
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.my_list_activity);
// 获取listview
WearableListView listView = (WearableListView) findViewById(R.id.wearable_list);
// 将adapter 分配给listview
listView.setAdapter(new Adapter(this, elements));
// 设置单击事件
listView.setClickListener(this);
}
// 单击事件的实现
@Override
public void onClick(WearableListView.ViewHolder v) {
Integer tag = (Integer) v.itemView.getTag();
// 使用ViewHolder当中的数据来实现一些操作
}
@Override
public void onTopEmptyRegionClick() {
}
}