背景简述
自动轮播视图(CarouselView)在现在App中的地位不言而喻,绝大多数的App中都有类似的视图,无论是WebApp还是Native App。在安卓、iOS以及Windows(UWP)开发中,有一些控件可以很方便的来实现类似的效果。
- ViewPager(安卓)
- UIScrollView(iOS)
- FlipView(UWP)
Xamarin.Forms怎么实现自动轮播视图呢?
Xamarin.Forms有自己的一套布局系统,结合各平台特性,也可以实现一个比较好的自动轮播视图。
上次介绍我实现的一个多页面水平切换布局中,提到我使用了一个叫做ViewPanel
的自定义布局,他与自动轮播视图相比,只是缺少了无线滚动和自动轮播,这次也以这个布局为基础,来实现自动轮播视图。
核心依然是ViewPanel
在各个平台中的具体实现:
Portable:
...
public static readonly BindableProperty ChildrenProperty = BindableProperty.Create("Children", typeof(IList), typeof(ViewPanel), propertyChanged: OnChildrenChanged);
public IList Children
{
get { return (IList)this.GetValue(ChildrenProperty); }
set { SetValue(ChildrenProperty, value); }
}
...
依赖属性Children
是一个集合类型,它用来存储需要在ViewPanel
中显示的视图,一般子视图的都从Xamarin.Forms.View
派生或者是他本身
其次,ViewPanel
能交互,需要实现一个事件,一个方法
-
event EventHandler SelectChanged
:当ViewPanel
中显示的元素改变时提供通知,并且提供OnSelectChanged()
来触发该事件
*void select()
:用于设置ViewPanel
需要显示的子视图(实际Select
会是一个委托,因为ViewPanel
并不能设置当前显示的内容,需要调用各平台一些特定的方法实现)
安卓:
直接利用Renderer
实现
ViewPanelRenderer : ViewRenderer<ViewPanel, ViewPager>
在安卓平台上,ViewPanel
直接利用ViewPager
来实现,所以ViewPanel
对子元素的布局等方法都会无效,所有的子元素布局,显示状态都由ViewPager
来管理,ViewPanel
的作用只限于提供子视图。而ViewPager
中子视图的创建删除都由相应的Adapter
来实现,这儿用到的是ViewPagerAdapter
。
ViewPagerAdpter
需要的子视图的类型是Android.Views.View
,而上面提到,ViewPanel
提供的子视图类型是Xamarin.Forms.View
,所以在添加Xamarin.Forms.View
类型视图到ViewPagerAdpter
中的时候,需要完成一次转换,实则是获取Xamarin.Forms.View
类型对象对应在安卓平台中的Renderer
,实现方法如下:
//view is Xamarin.Forms.View
var renderer = Platform.CreateRenderer(view);
var viewGroup = renderer.ViewGroup;
//viewGroup is Android.Views.View
需要注意,虽然子试图的布局直接由ViewPager
来管理,但是ViewPager
本身的位置,大小是可以由ViewPanel
自己或者他的上层布局决定的。如果它的父布局没有约束他的位置大小,那么他可以通过在ViewPanel
中重写的OnMeasure
方法来自定义自己的大小:
protected override SizeRequest OnMeasure(double widthConstraint, double heightConstraint)
{
...
//最简单的就是返回固定尺寸,但通常不这么写,一般根据它的子视图位置大小等信息,来相应的设置他自己的尺寸,测量子元素的尺寸可以调用`Measure()`方法;
return new SizeRequest(new Size(385, 400));
}
完成了ViewPanel
视图的显示,还需要实现交互部分:
订阅
ViewPager
的PageSelected
事件,再订阅方法中调用ViewPanel
的OnSelectChanged()
方法,用于通知订阅了ViewPanel
的SelectChanged
事件的所有对象;ViewPanel
的属性Select
是委托类型,通过为该属性赋值,真正设置ViewPanel
显示的子视图(调用ViewPager的SetCurrentItem()方法);
iOS:
iOS的ViewPanel
实际是利用iOS中UIScrollView
实现,唯一需要用Renderer
实现的,就是设置UIScrollView
的PagingEnabled
属性为Ture
,这样该滚动条就可以按页滚动了
实现逻辑如下:ViewPanel
继承自ScrolView
,设置为水平方向滚动,然后设置其Content
为一个水平方向的StackLayout
,把要显示的子试图添加到StackLayout
中。这样,只要StackLayout
的宽度超出ScrolView
的显示宽度后,就会出现水平滚动条,通过实现Renderer
设置滚动条的PagingEnabled
属性,就能每次滚动都完整的滚动一个子视图的宽度,如果子视图的宽度恰好为页面宽度,那就有了轮播图的效果。
为了让子视图的宽度就是ScrollView
的可视宽度,需要重写该ScrollView
的OnMeasure
和LayoutChildren
方法。可以自定义一个继承自StackLayout
的HorizentalStackLayout
来重写以上两个方法。
protected override SizeRequest OnMeasure(double widthConstraint, double heightConstraint)
{
var measuredList = new List<SizeRequest>();
foreach (var item in this.Children)
{
measuredList.Add(item.Measure(ViewPanel.MeasureWidth, double.PositiveInfinity));
}
if (Children == null || Children.Count <= 0)
{
return new SizeRequest(new Size(ViewPanel.MeasureWidth, 0));
}
//ViewPanel.Panel.Width就是滚动条可视宽度
Size size = new Size(ViewPanel.Panel.Width * Children.Count(), measuredList.Select(m => m.Request.Height).OrderByDescending(m => m).First());
return new SizeRequest(size, size);
}
protected override void LayoutChildren(double x, double y, double width, double height)
{
double posX = 0;
foreach (var item in this.Children)
{
item.Layout(new Rectangle(posX, y, ViewPanel.MeasureWidth, height));
posX += ViewPanel.MeasureWidth;
}
}
现在有一个问题,在ViewPanel
中,我们定义了Children
属性,用来存放子视图,但是在iOS中,StackLayout
的属性Children
和她并不相同,所以我们要做一次他们的同步,同步发生在ViewPanel
的Children
属性改变的时候,如下:
static void OnChildrenChanged(BindableObject sender, Object oldValue, Object newValue)
{
...
var viewPanel = sender as ViewPanel;
var stackLayout = viewPanel.Content as StackLayout;
stackLayout.Children.Clear();
foreach (View item in viewPanel.Children)
{
stackLayout.Children.Add(item);
}...
}
至此,同样视图显示部分就完成了,还剩交互部分,和安卓中一样,设计两个部分:
-
订阅
UIScrollView
的ScrollView_DecelerationEnded
事件,再订阅方法中计算当前选中的索引,然后调用ViewPanel的OnSelectChanged()
方法,用于通知订阅了ViewPanel
的SelectChanged
事件的所有对象;private void ScrollView_DecelerationEnded(object sender, EventArgs e) { var index = (int)(_viewPanel.ScrollX / _viewPanel.Width); if (_viewPanel.Width / 2 < (_viewPanel.ScrollX % _viewPanel.Width)) { index++; } _viewPanel.CurrentIndex = index; _viewPanel.OnSelectChanged(); }
-
ViewPanel
的属性Select
是委托类型,通过为该属性赋值,真正设置ViewPanel
显示的子视图(根据索引来计算滚动条的水平位置,并设置他);public void Select(int index, bool animate = true) { var perWidth = _viewPanel.Width; _viewPanel.CurrentIndex = index; _viewPanel.ScrollToAsync(index * perWidth, _viewPanel.ScrollY, animate); }
实现了ViewPanel
,如何利用他实现自动轮播?
之前介绍到,ViewPanel
就是阉割版的自动轮播视图,相比自动轮播,只少了两块儿
-
无限滚动
逻辑如下图:实际添加到显示
ViewPanel
中的子视图比设定的多两个,第一个设置为设定子视图的最后一个,最后一个设置为设定子视图的第一个。结合下图以向右滚动为例(红色),当滚动到索引为3(黑色标号)的子视图,也就是设定子视图的最后一个,此时继续向右滚动,滚动到索引为4的子视图,他和索引为1的子视图显示内容相同,当滚动完成后,继续滚动到索引为1的子视图,这次滚动很特殊,没有任何动画效果,直接跳转,因为滚动前后显示的视图相同,所以肉眼看不出任何区别,给人以无限滚动的假象。 -
自动轮播
这个简单,设置Timer即可。
总结
自动轮播视图(CarouselView)的核心思想就是这些,其他具体代码就不在这儿贴出,文末留出GitHub地址。在实现中,遇到一些问题或是新的,总结如下:
- 在自定义布局中,
OnMeasure
方法不是100%会被调用的,这个布局的大小是否已经被约束;
下面是我摘抄的一段话,来解释这个:
As you’ve seen, it is not guaranteed that the OnSizeRequest override will be called. The method doesn’t need to be called if the size of the layout is governed by its parent rather than its children. The method definitely will be called if one or both of the constraints are infinite, or if the layout class has nondefault settings of VerticalOptions or HorizontalOptions. Otherwise, a call to OnSizeRequest is not guaranteed and you shouldn’t rely on it.
Renderer
实现中,可以利用Xamarin已经为我们提供的Renderer
,而不是自己利用ViewRenderer
去自定义,这样很大程度上能避免去写一些iOS、安卓和UWP中相关的代码。这次实践中iOS平台下的ViewPanel
就直接派生自ScrollViewRenderer
依赖属性,自定义布局的知识在自定义一个控件,
Renderer
的时候是非常重要的······
本次实践相关连接:
GitHub项目地址:cjw1115/PivotPage