Android仿eleme点餐页面二级联动列表

2019-12-12 05:02:15

字体：大中小

来源：转载

供稿：网友

本周末外卖点得多，就仿一仿“饿了么”好了。先上图吧，这样的订单页面是不是很眼熟：

这里写图片描述

右边的listview分好组以后，在左边的Tab页建立索引。可以直接导航，是不是很方便。关键在于右边滑动，左边也会跟着滑；而点击左边呢，也能定位右边的项。它们存在这样一种特殊的交互。像这种联动的效果，还有些常见的例子呢，比如知乎采用了常见的toolbar＋viewPager的联动，只不过是上下布局：

这里写图片描述

再看看点评，它的城市选择页面也有这种联动的影子，只是稍微弱一点。侧边栏可以对listview进行索引，这最早是在微信好友列表里出现的把：

这里写图片描述

趁着周末，我也撸一个。就拓展性而言，应该可以适配以上所有情况吧。我称其为LinkedLayout，看下效果图：

这里写图片描述

我把右边按5个一组，可以看到，左边的索引＝右边／5

特点

右边滑动，左边跟着动

左边滑动到边界，右边跟着动

点击左边tab项，右边滑动定位到相应的group

源码

github 传送门: https://github.com/fashare2015/LinkedScrollDemo

知识点

做之前先罗列一下知识点，或者说我们能从这个demo里收获到什么。

面向抽象／接口编程

自定义 view

代理模式

UML类图

复习 listview && recyclerview 的细节

感觉做完以后收获最大的还是第一点，面向接口编程。事实上，完成功能的时间只占了一半，后边的时间一直在抽象和重构；哎，一步到位太难了，还是老老实实写具体类，再抽取基类把。

构思

UI部分

LinkedLayout

要做的呢是两个相互关联的列表，在左边的作为tab页，右边的作为content页。先不考虑交互，我们来打个界面：搞一个叫做LinkedLayout的类，用来盛放tab和content：

这里写图片描述

public class LinkedLayout extends LinearLayout {  private Context mContext;  private BaseScrollableContainer mTabContainer;  private BaseScrollableContainer mContentContainer;  private SectionIndexer mSectionIndexer; // 代理  ...}

我们让它继承了LinearLayout，同时持有两个Container的东东，还有一个上帝对象mContext，以及一个分组用的SectionIndexer。

BaseScrollableContainer

先别管这些，主要看两个Container,从名字上看一个是tab页,一个是content页，嘿嘿。因为它们都能scroll嘛，干脆搞一个BaseScrollableContainer把。取名为Container呢，当然是致敬Fragment啦。我们来定义一下这个类：
初步一想，无非有一个 mContext, 一个 viewGroup, 还有一些 Listener 嘛：

这里写图片描述

public abstract class BaseScrollableContainer<VG extends ViewGroup> {  protected Context mContext;  public VG mViewGroup;  protected RealOnScrollListener mRealOnScrollListener;  private EventDispatcher mEventDispatcher;  ...}

和我们预想的差不多嘛，mContext上下文，mViewGroup基本就是指代我们的两个listview了吧。当然，我之后可是要做toolbar+viewpager的，肯定得依赖抽象，不能直接写listview啦。余下两个是Listener，等我们界面搭好，写交互的时候在看把。

看来UML图还是有好处的，继承和依赖关系一目了然。

自定义View && 动态布局

好了到了自定义view地环节了。我们已经有了一个LinkedLayout,这是我们的activity_main.xml布局代码:

<?xml version="1.0" encoding="utf-8"?><RelativeLayout  xmlns:android="http://schemas.android.com/apk/res/android"  xmlns:tools="http://schemas.android.com/tools"  android:layout_width="match_parent"  android:layout_height="match_parent">  <com.fashare.linkedscrolldemo.ui.LinkedLayout    android:id="@+id/linked_layout"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:orientation="horizontal"/></RelativeLayout>

擦，就没了嘛？剩下的得靠Java代码来搞啦。回到LinkedLayout咱们来布局UI~:

public class LinkedLayout extends LinearLayout {  ...  private static final int MEASURE_BY_WEIGHT = 0;  private static final float WEIGHT_TAB = 1;  private static final float WEIGHT_CONTENT = 3;  public void setContainers(BaseScrollableContainer tabContainer, BaseScrollableContainer contentContainer) {    mTabContainer = tabContainer;    mContentContainer = contentContainer;    mTabContainer.setEventDispatcher(this);    mContentContainer.setEventDispatcher(this);    // 设置 LayoutParams    mTabContainer.mViewGroup.setLayoutParams(new LinearLayout.LayoutParams(        MEASURE_BY_WEIGHT,        ViewGroup.LayoutParams.WRAP_CONTENT,        WEIGHT_TAB    ));    mContentContainer.mViewGroup.setLayoutParams(new LinearLayout.LayoutParams(        MEASURE_BY_WEIGHT,        ViewGroup.LayoutParams.MATCH_PARENT,        WEIGHT_CONTENT    ));    this.addView(mTabContainer.mViewGroup);    this.addView(mContentContainer.mViewGroup);    this.setOrientation(HORIZONTAL);  }}

搞了个setContainers用来注入我们的Container,里边有一些像layout_height,layout_width,layout_weight,orientation之类的，很眼熟吧，和xml没差。顺便一提的是，我们用了weight属性来控制这个比例1:3，一直感觉这个属性比较神奇。。。

注入ViewGroup, 使用自定义的LinkedLayout

到这里为止，LinkedLayout已经布局好了，我们分别注入ViewGroup就可以用了。我这里分别用listview作tab,recyclerview作content。想像力有限，用来用去好像也就这么几个控件。。。这部分代码很简单，在MainActivity里，就不贴了。

子类化 BaseScrollableContainer

按照常理，下边应该实现基类了吧。前面的MainActivity中，我们是这样实例化的：

mTabContainer = new ListViewTabContainer(this, mListView); mContentContainer = new RecyclerViewContentContainer(this, mRecyclerView);

看名字一个是listview填充的tab,一个是recyclerview填充的content。就先实现这两个类吧，从图中可以看到，它们分别继承于BaseScrollableContainer,并被LinkedLayout所持有:

这里写图片描述

交互部分

与用户的交互：OnScrollListener 与代理模式

终于到了交互部分，既然是滑动，那少不了定义监听器啦。然而，麻烦在于listview和recyclerview各自的OnScrollListener还不一样，这个时候如果各自实现的话，既麻烦，又有冗余。像这样子：

// RecyclerViewpublic class RecyclerViewContentContainer extends BaseScrollableContainer<RecyclerView> {  ...  @Override  protected void setOnScrollListener() {    mViewGroup.addOnScrollListener(new ProxyOnScrollListener());  }  private class ProxyOnScrollListener extends RecyclerView.OnScrollListener {    @Override    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {      if(newState == RecyclerView.SCROLL_STATE_IDLE) {      // 停止滑动        1.停止时的逻辑...      }else if(newState == RecyclerView.SCROLL_STATE_DRAGGING){  // 按下拖动        2.刚刚拖动时的逻辑...      }    }    @Override    public void onScrolled(RecyclerView recyclerView, int dx, int dy) { // 滑动      3.滑动时的逻辑...    }  }}// ListViewpublic class ListViewTabContainer extends BaseScrollableContainer<ListView> {  ...  @Override  protected void setOnScrollListener() {    mViewGroup.setOnScrollListener(new ProxyOnScrollListener());    ...  }  public class ProxyOnScrollListener implements AbsListView.OnScrollListener{    @Override    public void onScrollStateChanged(AbsListView view, int scrollState) {      if(scrollState == SCROLL_STATE_IDLE) {       // 停止滑动        1.停止时的逻辑...      }else if(scrollState == SCROLL_STATE_TOUCH_SCROLL) // 按下拖动        2.刚刚拖动时的逻辑...    }    @Override    public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {      3.滑动时的逻辑...        // 滑动    }  }}

那该怎么办呢，虽然各自的OnScrollListener差异挺大，但是仔细观察可以发现其实很多逻辑都是类似的，可以共用的。这时恰恰可以用代理模式来做重构。我抽取了1、2、3处的逻辑，由于在抽象意义上是一致的，可以整理成接口：

public interface OnScrollListener {  // tab 点击事件  void onClick(int position);  // 1.滑动开始  void onScrollStart();  // 2.滑动结束  void onScrollStop();  // 3.触发 onScrolled()  void onScrolled();  // 用户手动滑, 触发的 onScrolled()  void onScrolledByUser();  // 程序调用 scrollTo(), 触发的 onScrolled()  void onScrolledByInvoked();}

与此同时，RecyclerView和ListView各自的监听器便分别作为代理类，把1、2、3的逻辑都委托给某个接盘侠，不必自己去实现，倒也落的轻松自在。如图所示：这里写图片描述

然后，让我们来看看这个接盘侠:RealOnScrollListener。。。

不愧是一个老实类，它老实地接盘了OnScrollListener的所有接口，并被两个代理类Proxy…所持有（图中并未画出。。）。
具体实现就不贴了，大家可以下源码来看。这里大致分析一下，它有三个成员：

public class RealOnScrollListener implements OnScrollListener {  public boolean isTouching = false; // 处于触摸状态  private int mCurPosition = 0;    // 当前选中项  private BaseViewGroupUtil<VG> mViewUtil; // ViewGroup 工具类  ...}

isTouching:

为啥要维护这个触摸状态呢？这是由于我们的效果是联动的。这就比较讨厌了，当onScrolled()被调用，我们分不清是用户的滑动，还是来自另一个列表滑动时的联动效果。那我们记录一下isTouching状态呢，就能区分开这两种情况了。
更改isTouching的逻辑在onScrollStart()和onScrollStop()里边。

mCurPosition：

这个很好解释，我们每次滑动需要记录当前位置，然后通知另一个列表进行联动。
这段逻辑在onScrolled()里边。

mViewUtil：
一个工具库，用于简化逻辑。大概有scrollTo(),setViewSelected(),UpdatePosOnScrolled()等方法，如图：

这里写图片描述

两个Container之间的交互

之前都是对用户的交互，终于到联动部分了。不急着实现，先回答我一个问题：假设我一个Activity里持有两个Fragment,问它们之间如何通信？

A同学大声道：用广播
B同学：EventBus !!!
C同学：看我 RxBus 。。。
别闹好吗。。。给我老老实实用Listener。显然，我们这里面临的是同样的场景。LinkedLayout=Activity,Container=Fragment。
动手前先定义Listener吧，要取个中二点的名字：

/* * 事件分发者 */public interface EventDispatcher {  /**   * 分发事件: fromView 中的 pos 被选中   * @param pos   * @param fromView   */  void dispatchItemSelectedEvent(int pos, View fromView);}/* * 事件接受者 */public interface EventReceiver {  /**   * 收到事件: 立即选中 newPos   * @param newPos   */  void selectItem(int newPos);}

然后LinkedLayout作为父级元素，肯定是分发者的角色，应当实现EventDispatcher；而BaseScrollableContainer作为子元素，接受该事件，应当实现EventReceiver。看下类图：

这里写图片描述

看下相应的实现（EventReceiver）：

public abstract class BaseScrollableContainer<VG extends ViewGroup>    implements EventReceiver {  protected RealOnScrollListener mRealOnScrollListener;  private EventDispatcher mEventDispatcher; // 持有分发者  ...  public void setEventDispatcher(EventDispatcher eventDispatcher) {    mEventDispatcher = eventDispatcher;  }  // 掉用 mEventDispatcher，也就是 LinkedLayout  protected void dispatchItemSelectedEvent(int curPosition){    if(mEventDispatcher != null)      mEventDispatcher.dispatchItemSelectedEvent(curPosition, mViewGroup);  }  @Override  public void selectItem(int newPos) {    mRealOnScrollListener.selectItem(newPos);  }  // OnScrollListener: 代理模式  public class RealOnScrollListener implements OnScrollListener {    ...    public void selectItem(int position){      mCurPosition = position;      Log.d("setitem", position + "");      // 来自另一边的联动事件      mViewUtil.smoothScrollTo(position);//      if(mViewUtil.isVisiblePos(position))  // curSection 可见时, 不滚动        mViewUtil.setViewSelected(position);    }    @Override    public void onClick(int position) {      isTouching = true;      mViewUtil.setViewSelected(mCurPosition = position);      dispatchItemSelectedEvent(position); // 点击tab，分发事件      isTouching = false;    }    ...    @Override    public void onScrolled() {      mCurPosition = mViewUtil.updatePosOnScrolled(mCurPosition);      if(isTouching)     // 来自用户, 通知 对方 联动        onScrolledByUser();      else          // 来自对方, 被动滑动不响应        onScrolledByInvoked();    }    @Override    public void onScrolledByUser() {      dispatchItemSelectedEvent(mCurPosition);  // 来自用户, 通知 对方 联动    }  }}

再看（EventDispatcher）：

public class LinkedLayout extends LinearLayout implements EventDispatcher {  private BaseScrollableContainer mTabContainer;  private BaseScrollableContainer mContentContainer;  private SectionIndexer mSectionIndexer; // 分组接口  ...  @Override  public void dispatchItemSelectedEvent(int pos, View fromView) {    if (fromView == mContentContainer.mViewGroup) { // 来自 content, 转发给 tab      int convertPos = mSectionIndexer.getSectionForPosition(pos);      mTabContainer.selectItem(convertPos);    } else {          // 来自 tab, 转发给 content      int convertPos = mSectionIndexer.getPositionForSection(pos);      mContentContainer.selectItem(convertPos);    }  }}

总结

到此为止，有没有一种酣畅淋漓的感觉？不管怎么说，面向对象是信仰，定义好接口以后，实现起来怎么写怎么舒服。
// TODO: 之前说了，这个联动是通用的。之后有时间会继续实现一个toolbar＋viewPager的联动…

彩蛋

高清无码类图：（完整）

这里写图片描述