本文讲的是[译]Workcation App – 第三部分. 带有动画的标记(Animated Markers) 与 RecyclerView 的互动,
- 原文地址:Workcation App – Part 3. RecyclerView interaction with Animated Markers
- 原文作者:Mariusz Brona
- 译文出自:掘金翻译计划
- 译者:龙骑将杨影枫
- 校对者:Vivienmm、张拭心
Workcation App – 第三部分. 带有动画的标记(Animated Markers) 与 RecyclerView 的互动
欢迎阅读本系列文章的第三篇,此系列文章和我前一段时间完成的“研发”项目有关。在文章里,我会针对开发中遇到的动画问题分享一些解决办法。
Part 1: 自定义 Fragment 转场
Part 2: 带有动画的标记(Animating Markers) 与 MapOverlayLayout
Part 3: 带有动画的标记(Animated Markers) 与 RecyclerView 的互动
Part 4: 场景(Scenes)和 RecyclerView 的共享元素转场动画(Shared Element Transition)
项目的 Git 地址: Workcation App
动画的 Dribbble 地址: dribbble.com/shots/28812…
序言
几个月前我们开了一个部门会议,在会议上我的朋友 Paweł Szymankiewicz 给我演示了他在自己的“研发”项目上制作的动画。我非常喜欢这个动画,会后决定用代码实现它。我可没想到到我会摊上啥...
GIF 1 “动画效果”
开始吧!
就像上面 GIF 动画展示的,需要做的事情有很多。
- 在点击底部菜单栏最右方的菜单后,我们会跳转到一个新界面。在此界面中,地图通过缩放和渐显的转场动画在屏幕上方加载,Recycleview 的 item 随着转场动画从底部加载,地图上的标记点在转场动画执行的同时被添加到地图上.
- 当滑动底部的 RecycleView item 的时候,地图上的标记会通过闪烁来显示它们的位置(译者注:原文是show their position on the map,个人认为 position 有两层含义:一代表标记在地图上的位置,二代表标记所对应的 item 在 RecycleView 里的位置。)
- 在点击一个 item 以后,我们会进入到新界面。在此界面中,地图通过动画方式来显示出路径以及起始/结束标记。同时此 RecyclerView 的item 会通过转场动画展示一些关于此地点的描述,背景图片也会放大,还附有更详细的信息和一个按钮。
- 当后退时,详情页通过转场变成普通的 RecycleView Item,所有的地图标记再次显示,同时路径一起消失。
就这么多啦,这就是我准备在这一系列文章中向你展示的东西。在本文中,我会解决如何让标记与 RecycleView 产生互动。
需求
RecyclerView 有一些本地工具来管理自身的状态。我们可以设置 ItemAnimator 或者 ItemDecorator 来添加一些不错的动画效果,通过 ViewHolder 和 LayoutManager 来控制布局的尺寸和位置。我们还有 listener 来监听 RecyclerView 的特殊状态。
如上所示,这是一个横向的 RecyclerView,该 RecycleView 包含一组记录巴厘岛周边详情的 CardViews。当滑动 RecyclerView 的时候,对应的标记要做出闪烁。所以如何实现呢?当然是有一些问题需要解决的 !
OnScrollListener
OnScrollListener 是一个允许我们在 RecyclerView 的滑动事件被触发时接收回调的类(参见此处)。该类有 onScrolled 方法 —— 这是联系滚动位置(position)和标记的关键。该回调方法监听滚动事件。让我们看一看它长啥样:
Java
@Override
public void onScrolled(final RecyclerView recyclerView,final int dx,final int dy){
super.onScrolled(recyclerView,dx,dy);
}
如我们所见,此回调传入一个RecyclerView对象作为参数,还有整数型参数 dx 和 dy。“dx” 是横移量,“dy”是纵移量。在本项目中,我们只对 recycleview 参数感兴趣.
第一个想法
好吧,既然我们已经有了含有 onScrolled 方法的 OnScrollListener 类,那就不复杂了吧?我们需要判断某个 RecycleView 的 item 是否处于正中心,如果是的话就通知对应的标记闪烁。简单不?确实很简单,但是不管用 。再看一下动画,第一个 item 和最后一个 item 永远不会到达 RecycleView 的中心。
第二个想法
该怎么做呢?触发标记闪烁的触发点是随着 RecyclerView 的滑动而移动的。所以这个触发点的起始位置应该在第一个 item 的中心,最终位置应该在最后一个 item 的中心。我们需要做些数学计算来判断触发点和闪烁标记的关联。
管用吗?
还是不管用 。 onScrolle 方法不是每一个像素都被触发的。如果我们滑动 RecycleView 的速度太快,收到的回调就很少。那么应该怎么办呢?
第三个想法
很简单。既然不能计算移动的触发点 —— 因为看起来它不会包含“偏移量”的参数,那就移动“范围”。当该范围覆盖比如说 70% 的 RecycleView 子布局时,触发标记的闪烁。不妨把它想想成一个从左至右移动的矩形。让我们看看实现吧:
Java
public class HorizontalRecyclerViewScrollListener extends RecyclerView.OnScrollListener{
private static final int OFFSET_RANGE = 50;
private static final double COVER_FACTOR = 0.7;
private int[] itemBounds = null;
private final OnItemCoverListener listener;
public HorizontalRecyclerViewScrollListener(final OnItemCoverListener listener){
this.listener=listener;
}
@Override
public void onScrolled(final RecyclerView recyclerView,final int dx,final int dy){
super.onScrolled(recyclerView,dx,dy);
if(itemBounds == null)
fillItemBounds(recyclerView.getAdapter().getItemCount(),recyclerView);
for(int i=0;i<itemBounds.length;i++){
if(isInChildItemsRange(recyclerView.computeHorizontalScrollOffset(),itemBounds[i],OFFSET_RANGE))
listener.onItemCover(i);
}
}
private void fillItemBounds(final int itemsCount,final RecyclerView recyclerView){
itemBounds=new int[itemsCount];
int childWidth=(recyclerView.computeHorizontalScrollRange()-recyclerView.computeHorizontalScrollExtent())/itemsCount;
for(inti=0;i<itemsCount;i++){
itemBounds[i]=(int)(((childWidth*i+childWidth*(i+1))/2)*COVER_FACTOR);
}
}
private boolean isInChildItemsRange(final int offset,final int itemBound,final int range){
int rangeMin=itemBound-range;
int rangeMax=itemBound+range;
return (Math.min(rangeMin,rangeMax)<=offset) && (Math.max(rangeMin,rangeMax)>=offset);
}
public interface OnItemCoverListener{
void onItemCover(final int position);
}
}
首先,我们不希望新代码和 Fragment/Activity 混到一起,因此继承 RecyclerView.OnScrollListener 的类并重写必要的方法。在构造函数中传一个 listener 进去,当 RecycleView 的 item 的范围符合时条件时就调用该 listener 的 onItemCover 方法。在onScrolled 方法中,如果 itemBounds 为空我们可以调用 fillItemBounds 进行初始化。否则循环判断所有的边距,判断 RecycleView 的 item 是否被指定的范围覆盖。
方法 fillItemBounds 以 RecyclerView 的 item 个数为长度创建了一个整数数组。接下来它计算了子布局的宽度(也就是 RecyclerView 的 item 的宽度)。在最后它用“item 的范围”给数组赋值 —— 事实上,这些就是用来计算 RecycleView 是否处于子布局内的“中心”点。
当调用 onScrolled 方法时,我们遍历 RecyclerView 的 item,并使用 isInChildItemsRange 方法来判断他们所处的位置是否在范围内。该方法实际上就是当我们移动 RecycleView 时候的“矩形”。该方法计算 item 的区域(也就是我们计算并保存在 itemBounds里的中心点)与当前的偏移量是否重叠。如果符合条件的话,OnItemCoverListener 会调用 onItemCover 方法,传递指定的位置(position) 。通过此参数,我们就可以拿到判断当前的地图标记是哪个,让它进行闪烁。
//Implementation of the HorizontalRecyclerViewScrollListener
// HorizontalRecyclerViewScrollListener 的具体实现
...
recyclerView.addOnScrollListener(new HorizontalRecyclerViewScrollListener(this));
}
//OnItemCoverListener method implementation
// 实现 OnItemCoverListener 的方法
@Override
public void onItemCover(final int position){
mapOverlayLayout.showMarker(position);// 在此处刷新标记
}
//PulseOverlayLayout - see the 2nd article from the series
//PulseOverlayLayout - 参见系列的第二篇
public void showMarker(final int position){
((PulseMarkerView)markersList.get(position)).pulse();
}
//PulseMarkerView - see the 2nd article from the series
//PulseOverlayLayout - 参见系列的第二篇
public void pulse(){
startAnimation(scaleAnimation);
}
效果如下
总结
如我们所见,Android Framework 中有一些了不起的工具,但是在很多情况下还是需要思考怎么调用才能把事情按我们所想的实现。最开始的时候还不是很明确,但是现在我们已经找到解决办法了 。
多谢阅读!最后一篇会在星期二 4.04 发布。如果有疑问的话欢迎评论,如果觉得有用的话一定要分享哟!
原文发布时间为:2017年6月05日
本文来自合作伙伴掘金,了解相关信息可以关注掘金网站。