Xamarin自定义布局系列——支持无限滚动的自动轮播视图CarouselView

简介: 原文:Xamarin自定义布局系列——支持无限滚动的自动轮播视图CarouselView背景简述 自动轮播视图(CarouselView)在现在App中的地位不言而喻,绝大多数的App中都有类似的视图,无论是WebApp还是Native App。
原文: Xamarin自定义布局系列——支持无限滚动的自动轮播视图CarouselView

背景简述


自动轮播视图(CarouselView)在现在App中的地位不言而喻,绝大多数的App中都有类似的视图,无论是WebApp还是Native App。在安卓、iOS以及Windows(UWP)开发中,有一些控件可以很方便的来实现类似的效果。

  1. ViewPager(安卓)
  2. UIScrollView(iOS)
  3. 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视图的显示,还需要实现交互部分:

  • 订阅ViewPagerPageSelected事件,再订阅方法中调用ViewPanelOnSelectChanged()方法,用于通知订阅了ViewPanelSelectChanged事件的所有对象;

  • ViewPanel的属性Select是委托类型,通过为该属性赋值,真正设置ViewPanel显示的子视图(调用ViewPager的SetCurrentItem()方法);

iOS:

iOS的ViewPanel实际是利用iOS中UIScrollView实现,唯一需要用Renderer实现的,就是设置UIScrollViewPagingEnabled属性为Ture,这样该滚动条就可以按页滚动了

实现逻辑如下:
ViewPanel继承自ScrolView,设置为水平方向滚动,然后设置其Content为一个水平方向的StackLayout,把要显示的子试图添加到StackLayout中。这样,只要StackLayout的宽度超出ScrolView的显示宽度后,就会出现水平滚动条,通过实现Renderer设置滚动条的PagingEnabled属性,就能每次滚动都完整的滚动一个子视图的宽度,如果子视图的宽度恰好为页面宽度,那就有了轮播图的效果。

为了让子视图的宽度就是ScrollView的可视宽度,需要重写该ScrollViewOnMeasureLayoutChildren方法。可以自定义一个继承自StackLayoutHorizentalStackLayout来重写以上两个方法。

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和她并不相同,所以我们要做一次他们的同步,同步发生在ViewPanelChildren属性改变的时候,如下:

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);
    }...
}

至此,同样视图显示部分就完成了,还剩交互部分,和安卓中一样,设计两个部分:

  • 订阅UIScrollViewScrollView_DecelerationEnded事件,再订阅方法中计算当前选中的索引,然后调用ViewPanel的OnSelectChanged()方法,用于通知订阅了ViewPanelSelectChanged事件的所有对象;

      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就是阉割版的自动轮播视图,相比自动轮播,只少了两块儿

  1. 无限滚动

    逻辑如下图:实际添加到显示ViewPanel中的子视图比设定的多两个,第一个设置为设定子视图的最后一个,最后一个设置为设定子视图的第一个。结合下图以向右滚动为例(红色),当滚动到索引为3(黑色标号)的子视图,也就是设定子视图的最后一个,此时继续向右滚动,滚动到索引为4的子视图,他和索引为1的子视图显示内容相同,当滚动完成后,继续滚动到索引为1的子视图,这次滚动很特殊,没有任何动画效果,直接跳转,因为滚动前后显示的视图相同,所以肉眼看不出任何区别,给人以无限滚动的假象。
    无限轮播示例

  2. 自动轮播

    这个简单,设置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

目录
相关文章
|
Android开发 iOS开发 容器
Xamarin自定义布局系列——PivotPage(多页面切换控件)
原文:Xamarin自定义布局系列——PivotPage(多页面切换控件) PivotPage ———— 多页面切换控件 PivotPage是一个多页面切换控件,类似安卓中的ViewPager和UWP中的Pivot枢轴控件。
1167 0
|
虚拟化 容器
Xamarin自定义布局系列——ListView的一个自定义实现ItemsControl(横向列表)
原文:Xamarin自定义布局系列——ListView的一个自定义实现ItemsControl(横向列表) 在以前写UWP程序的时候,了解到在ListView或者ListBox这类的列表空间中,有一个叫做ItemsPannel的属性,它是所有列表中子元素实际的容器,如果要让列表进行横向排列,只需要在...
1074 0
|
Android开发 iOS开发
Xamarin自定义布局系列——瀑布流布局
原文:Xamarin自定义布局系列——瀑布流布局 Xamarin.Forms以Xamarin.Android和Xamarin.iOS等为基础,自己实现了一整套比较完整的UI框架,包含了绝大多数常用的控件,如下图 虽然XF(Xamarin.Forms简称XF,下同)为我们提供大这么多的控件,但在实际使用中,会发现这些控件的可定制性特别差,基本上都需要里利用Renderer来做一些修改。
1092 0
|
XML Android开发 数据格式
xamarin android自定义标题栏(自定义属性、回调事件)
自定义控件的基本要求 这篇文章就当是自定义控件入门,看了几篇android关于自定义控件的文章,了解了一下,android自定义控件主要有3种方式: 自绘控件:继承View类,所展示的内容在OnDraw方法中绘制出来 组合控件:不需要绘制视图显示的内容,只用系统原生的控件,将几个控件组合起来,(这就是这篇文章要写的自定义标题栏) 继承控件:继承原生的控件类,在原生的属性上增加新的功能。
1475 0
|
XML Android开发 数据格式
xamarin android自定义spinner
以前弄的一个下拉框时自带的spinner,感觉好丑,实际效果实在满足不了基本的UI界面要求,还是自己动手丰衣足食,看了网上关于android中自定义spinner的文章,感觉实现原理还是比较简单,所以这里用xamarin android来实现自定义spinner样式。
1676 0
|
Android开发 Java 数据格式
Xamarin Android自定义文本框
xamarin android 自定义文本框简单的用法 关键点在于,监听EditText的内容变化,不同于java中文本内容变化去调用EditText.addTextChangedListener(mTextWatcher);为EditText设置内容变化监听! 简单来说就是添加一个AfterTextChanged 事件就OK了,这是最简单的一种做法,当然你要想java那样去监听也可以的。
1142 0
|
6月前
|
开发工具 Android开发 iOS开发
使用xamarin开发Android、iOS报错failed to open directory: 系统找不到指定的文件
使用vs2019学习xamarin时,创建新程序。使用模拟器真机等测试都报错如下图错误: ![请在此添加图片描述](https://developer-private-1258344699.cos.ap-guangzhou.myqcloud.com/column/article/5877188/20231030-de8ce5fd.png?x-cos-security-token=r4KyZDEowPT0kGTL0LqE8EnwfN1Nzexadb05dcffed3939ff8d7591c528c01706nvpGSE93QwHpZM8NwhJNTZctNRQa0l3KDhEnqj8P7d8t
63 0
使用xamarin开发Android、iOS报错failed to open directory: 系统找不到指定的文件
|
Java C# Android开发
.NET(WinCE、WM)开发转Android开发 ——Xamarin和Smobiler对比
WinCE从1995年诞生至今,已有20多年的发展历史,行业成熟方案覆盖范围广,从车载、工控、手持机都有涉及,且方案成熟。 近些年,Android以后来居上的态势,逐渐渗透至各行业领域,硬件手持大厂也把产品线重心向Android手持迁移,基于Android的行业解决方案越来越成熟,WinCE的开发人才流失,在WinCE解决方案上吃老本的企业寻求转型。
|
Web App开发 测试技术 Android开发
xamarin开发android收集的一些工具
原文:xamarin开发android收集的一些工具 xamarin开发android收集的一些工具 工欲善其事,必先利其器,从16年下半年开始做xamarin相关的开发,平时使用的一些工具和google插件给大家分享一下,都有下载地址,持续更新。
1485 0
|
XML Java Android开发
Xamarin android如何反编译apk文件
Xamarin android 如何反编译 apk文件 这里推荐一款XamarinAndroid开发的小游戏,撸棍英雄,游戏很简单,的确的是有点大。等一下我们来翻翻译这个Xamarin Android 开发的小游戏 下载链接:http://shouji.
1336 0