From f224edf03d718a4b112f0796ab4ad7bb146dfc5d Mon Sep 17 00:00:00 2001
From: Shane Neuville <shneuvil@microsoft.com>
Date: Thu, 29 Aug 2019 15:09:34 -0600
Subject: [PATCH] [Android/iOS] RefreshView (#7214)

* Swipe To Refresh

* pull in pull to refresh

* api changes

* Added RefreshView CoreGallery and Gallery Samples (using ScrollView, ListView, CollectionView, etc.)

* Code refactoring in RefreshViewRenderer (iOS)

* Updated RefreshView Android Renderer

* Fixed RefreshView Android samples in Core Gallery

* Added initial RefreshView UWP implementation

* Added another UWP RefreshView renderer using WinUI NuGet controls (RefreshContainer)

* - additional linker settings

* - uwp fixes

* - disable SkipMicrosoftUIXamlCheckTargetPlatformVersion check

* Update .nuspec/Xamarin.Forms.targets

* Limited RefreshView in Android to support only content using scroll.
Small changes in RefreshView iOS renderer.
Updated Core Gallery RefreshView samples.

* Fixed Visualizer colors in UWP RefreshView

* Added UWP RefreshPullDirection Platform Specific

* Small changes in code syntax in iOS renderer.

* Removed some unnecessary curly braces .

* Register effect provider in iOS RefreshView

* Changes in RefreshView UWP Dispose

* Added conditional code to manage the refresh control differently if it is iOS 10 or higher.

* Fixed error in Android Core Gallery (Linker)
Code refactoring and small changes (PR Feedback)

* Changes disposing the Android renderer

* - fix SkipMicrosoftUIXamlCheckTargetPlatformVersion so it can be turned off

* Removed UWP RefreshView renderer and Platform Specific

* - remove winui from nuspec

* - remove skip checks from targets

* - remove XamlControlsResources

* - remove skip check on UAP platform

* Revert changes in Android Core Gallery manifiest

* Revert unnecessary space in UAP Platform csproj

* Removed unnecessary new line in UWP Resources

* Simplified RefreshView iOS Renderer.
fixes #5882
---
 Stubs/Xamarin.Forms.Platform.cs               |   4 +
 ...rms.ControlGallery.WindowsUniversal.csproj |   1 +
 Xamarin.Forms.Controls/CoreGallery.cs         |   3 +
 .../CoreGalleryPages/CoreGalleryPage.cs       |  14 +-
 .../RefreshViewCoreGalleyPage.cs              | 120 ++++++++
 .../GalleryPages/GalleryBuilder.cs            |   2 +-
 .../RefreshCollectionViewGallery.xaml         |  36 +++
 .../RefreshCollectionViewGallery.xaml.cs      |  14 +
 .../RefreshLayoutGallery.xaml                 |  48 ++++
 .../RefreshLayoutGallery.xaml.cs              |  14 +
 .../RefreshListViewGallery.xaml               |  48 ++++
 .../RefreshListViewGallery.xaml.cs            |  14 +
 .../RefreshScrollViewGallery.xaml             |  47 +++
 .../RefreshScrollViewGallery.xaml.cs          |  14 +
 .../RefreshViewGallery.cs                     |  99 +++++++
 .../Xamarin.Forms.Controls.csproj             |   6 +-
 .../WindowsSpecific/RefreshView.cs            |  40 +++
 Xamarin.Forms.Core/RefreshView.cs             |  81 ++++++
 .../TestAttributes.cs                         |   5 +
 .../Properties/AssemblyInfo.cs                |   1 +
 .../Renderers/RefreshViewRenderer.cs          | 270 ++++++++++++++++++
 .../Xamarin.Forms.Platform.Android.csproj     |   1 +
 .../Properties/AssemblyInfo.cs                |   1 +
 .../Renderers/RefreshViewRenderer.cs          | 215 ++++++++++++++
 .../Xamarin.Forms.Platform.iOS.csproj         |   1 +
 .../Xamarin.Forms.Platform.cs                 |   4 +
 26 files changed, 1098 insertions(+), 5 deletions(-)
 create mode 100644 Xamarin.Forms.Controls/CoreGalleryPages/RefreshViewCoreGalleyPage.cs
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml.cs
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml.cs
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml.cs
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml.cs
 create mode 100644 Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshViewGallery.cs
 create mode 100644 Xamarin.Forms.Core/PlatformConfiguration/WindowsSpecific/RefreshView.cs
 create mode 100644 Xamarin.Forms.Core/RefreshView.cs
 create mode 100644 Xamarin.Forms.Platform.Android/Renderers/RefreshViewRenderer.cs
 create mode 100644 Xamarin.Forms.Platform.iOS/Renderers/RefreshViewRenderer.cs

diff --git a/Stubs/Xamarin.Forms.Platform.cs b/Stubs/Xamarin.Forms.Platform.cs
index 3625945cf98..3fae7482063 100644
--- a/Stubs/Xamarin.Forms.Platform.cs
+++ b/Stubs/Xamarin.Forms.Platform.cs
@@ -154,6 +154,10 @@ internal class _PageRenderer { }
 	[RenderWith (typeof (PhoneMasterDetailRenderer))]
 #endif
 	internal class _MasterDetailPageRenderer { }
+#if !TIZEN4_0
+	[RenderWith(typeof(RefreshViewRenderer))]
+#endif
+	internal class _RefreshViewRenderer { }
 }
 
 
diff --git a/Xamarin.Forms.ControlGallery.WindowsUniversal/Xamarin.Forms.ControlGallery.WindowsUniversal.csproj b/Xamarin.Forms.ControlGallery.WindowsUniversal/Xamarin.Forms.ControlGallery.WindowsUniversal.csproj
index afe63e73c81..91d6c915a43 100644
--- a/Xamarin.Forms.ControlGallery.WindowsUniversal/Xamarin.Forms.ControlGallery.WindowsUniversal.csproj
+++ b/Xamarin.Forms.ControlGallery.WindowsUniversal/Xamarin.Forms.ControlGallery.WindowsUniversal.csproj
@@ -24,6 +24,7 @@
     <AppxBundle>Always</AppxBundle>
     <RuntimeIdentifiers>win10-arm;win10-arm-aot;win10-x86;win10-x86-aot;win10-x64;win10-x64-aot</RuntimeIdentifiers>
     <GenerateAppxPackageOnBuild>False</GenerateAppxPackageOnBuild>
+    <SkipMicrosoftUIXamlCheckTargetPlatformVersion>true</SkipMicrosoftUIXamlCheckTargetPlatformVersion>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug|ARM'">
     <DebugSymbols>true</DebugSymbols>
diff --git a/Xamarin.Forms.Controls/CoreGallery.cs b/Xamarin.Forms.Controls/CoreGallery.cs
index 915cbb307ad..c1316c50d1c 100644
--- a/Xamarin.Forms.Controls/CoreGallery.cs
+++ b/Xamarin.Forms.Controls/CoreGallery.cs
@@ -11,6 +11,7 @@
 using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
 using Xamarin.Forms.Controls.GalleryPages.VisualStateManagerGalleries;
 using Xamarin.Forms.Controls.Issues;
+using Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries;
 
 namespace Xamarin.Forms.Controls
 {
@@ -337,6 +338,8 @@ public override string ToString()
 				new GalleryPageFactory(() => new ProgressBarCoreGalleryPage(), "ProgressBar Gallery"),
 				new GalleryPageFactory(() => new MaterialProgressBarGallery(), "ProgressBar & Slider Gallery (Material)"),
 				new GalleryPageFactory(() => new MaterialActivityIndicatorGallery(), "ActivityIndicator Gallery (Material)"),
+				new GalleryPageFactory(() => new RefreshViewGallery(), "RefreshView Gallery"),
+				new GalleryPageFactory(() => new RefreshViewCoreGalleryPage(), "RefreshView Core Gallery"),
 				new GalleryPageFactory(() => new ScrollGallery(), "ScrollView Gallery"),
 				new GalleryPageFactory(() => new ScrollGallery(ScrollOrientation.Horizontal), "ScrollView Gallery Horizontal"),
 				new GalleryPageFactory(() => new ScrollGallery(ScrollOrientation.Both), "ScrollView Gallery 2D"),
diff --git a/Xamarin.Forms.Controls/CoreGalleryPages/CoreGalleryPage.cs b/Xamarin.Forms.Controls/CoreGalleryPages/CoreGalleryPage.cs
index e00770ad2af..3f64475e6ff 100644
--- a/Xamarin.Forms.Controls/CoreGalleryPages/CoreGalleryPage.cs
+++ b/Xamarin.Forms.Controls/CoreGalleryPages/CoreGalleryPage.cs
@@ -45,7 +45,14 @@ internal CoreGalleryPage()
 
 			Build(Layout);
 
-			Content = new ScrollView { AutomationId = "GalleryScrollView", Content = Layout };
+			if (SupportsScroll)
+				Content = new ScrollView { AutomationId = "GalleryScrollView", Content = Layout };
+			else
+			{
+				var content = new Grid { AutomationId = "GalleryScrollView" };
+				content.Children.Add(Layout);
+				Content = content;
+			}
 		}
 
 		protected virtual void InitializeElement(T element) { }
@@ -229,6 +236,11 @@ protected virtual bool SupportsFocus
 			get { return true; }
 		}
 
+		protected virtual bool SupportsScroll
+		{
+			get { return true; }
+		}
+
 		protected void Add(ViewContainer<T> viewContainer)
 		{
 			_viewContainers.Add(viewContainer);
diff --git a/Xamarin.Forms.Controls/CoreGalleryPages/RefreshViewCoreGalleyPage.cs b/Xamarin.Forms.Controls/CoreGalleryPages/RefreshViewCoreGalleyPage.cs
new file mode 100644
index 00000000000..e84faf7782a
--- /dev/null
+++ b/Xamarin.Forms.Controls/CoreGalleryPages/RefreshViewCoreGalleyPage.cs
@@ -0,0 +1,120 @@
+using System;
+using System.Windows.Input;
+using Xamarin.Forms.CustomAttributes;
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls
+{
+	[Preserve(AllMembers = true)]
+	internal class RefreshViewCoreGalleryPage : CoreGalleryPage<RefreshView>
+	{
+		protected override bool SupportsFocus
+		{
+			get { return false; }
+		}
+
+		protected override bool SupportsScroll
+		{
+			get { return false; }
+		}
+
+		protected override void InitializeElement(RefreshView element)
+		{
+			base.InitializeElement(element);
+
+			BindingContext = new RefreshCoreGalleryViewModel();
+
+			element.Content = CreateContent();
+			element.SetBinding(RefreshView.CommandProperty, "RefreshCommand");
+			element.SetBinding(RefreshView.IsRefreshingProperty, "IsRefreshing");
+		}
+
+		protected override void Build(StackLayout stackLayout)
+		{
+			base.Build(stackLayout);
+
+			var refreshColorContainer = new ViewContainer<RefreshView>(Test.RefreshView.RefreshColor, new RefreshView
+			{
+				Content = CreateContent(),
+				RefreshColor = Color.Red
+			});
+
+			refreshColorContainer.View.SetBinding(RefreshView.CommandProperty, "RefreshCommand");
+			refreshColorContainer.View.SetBinding(RefreshView.IsRefreshingProperty, "IsRefreshing");
+
+			Add(refreshColorContainer);
+		}
+
+		ScrollView CreateContent()
+		{
+			var scrollView = new ScrollView
+			{
+				BackgroundColor = Color.Green,
+				HeightRequest = 250
+			};
+
+			var content = new Grid();
+
+			var refreshLabel = new Label
+			{
+				HorizontalOptions = LayoutOptions.Center,
+				VerticalOptions = LayoutOptions.Center,
+				TextColor = Color.White
+			};
+
+			refreshLabel.SetBinding(Label.TextProperty, "Info");
+			content.Children.Add(refreshLabel);
+			scrollView.Content = content;
+
+			return scrollView;
+		}
+	}
+
+	[Preserve(AllMembers = true)]
+	public class RefreshCoreGalleryViewModel : BindableObject
+	{
+		const int RefreshDuration = 1;
+
+		private bool _isRefresing;
+		private string _info;
+
+		public RefreshCoreGalleryViewModel()
+		{
+			Info = "RefreshView (Pull To Refresh)";
+		}
+
+		public bool IsRefreshing
+		{
+			get { return _isRefresing; }
+			set
+			{
+				_isRefresing = value;
+				OnPropertyChanged();
+			}
+		}
+
+		public string Info
+		{
+			get { return _info; }
+			set
+			{
+				_info = value;
+				OnPropertyChanged();
+			}
+		}
+
+		public ICommand RefreshCommand => new Command(ExecuteRefresh);
+
+		private void ExecuteRefresh()
+		{
+			IsRefreshing = true;
+
+			Device.StartTimer(TimeSpan.FromSeconds(RefreshDuration), () =>
+			{
+				IsRefreshing = false;
+				Info = "Refreshed (Pull To Refresh again)";
+				return false;
+			});
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/GalleryBuilder.cs b/Xamarin.Forms.Controls/GalleryPages/GalleryBuilder.cs
index eb9507714cf..c68badb2e71 100644
--- a/Xamarin.Forms.Controls/GalleryPages/GalleryBuilder.cs
+++ b/Xamarin.Forms.Controls/GalleryPages/GalleryBuilder.cs
@@ -7,7 +7,7 @@ public static class GalleryBuilder
 		public static Button NavButton(string galleryName, Func<ContentPage> gallery, INavigation nav)
 		{
 			var automationId = System.Text.RegularExpressions.Regex.Replace(galleryName, " |\\(|\\)", string.Empty);
-			var button = new Button { Text = $"{galleryName}", AutomationId = automationId, FontSize = 10, HeightRequest = 30 };
+			var button = new Button { Text = $"{galleryName}", AutomationId = automationId, FontSize = 10, HeightRequest = Device.RuntimePlatform == Device.Android ? 40 : 30 };
 			button.Clicked += (sender, args) => { nav.PushAsync(gallery()); };
 			return button;
 		}
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml
new file mode 100644
index 00000000000..f94bd0fda8d
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<ContentPage
+    xmlns="http://xamarin.com/schemas/2014/forms"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    x:Class="Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries.RefreshCollectionViewGallery"
+    Title="CollectionView (Pull To Refresh)">
+    <ContentPage.Content>
+        <RefreshView
+            IsRefreshing="{Binding IsRefreshing}"
+            RefreshColor="Pink"
+            Command="{Binding RefreshCommand}"
+            HorizontalOptions="FillAndExpand"
+            VerticalOptions="FillAndExpand">
+            <CollectionView
+                ItemsSource="{Binding Items}">
+                <CollectionView.ItemTemplate>
+                     <DataTemplate>
+                        <Grid>
+                            <Grid.ColumnDefinitions>
+                                <ColumnDefinition Width="48" />
+                                <ColumnDefinition Width="*" />
+                            </Grid.ColumnDefinitions>
+                            <BoxView
+                                Grid.Column="0"
+                                Color="{Binding Color}"
+                                HeightRequest="48"/>
+                            <Label
+                                Grid.Column="1"
+                                Text="{Binding Name}"/>
+                        </Grid>
+                    </DataTemplate>
+                </CollectionView.ItemTemplate>
+            </CollectionView>
+        </RefreshView>
+    </ContentPage.Content>
+</ContentPage>
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml.cs b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml.cs
new file mode 100644
index 00000000000..273136068cc
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshCollectionViewGallery.xaml.cs
@@ -0,0 +1,14 @@
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries
+{
+	[Preserve(AllMembers = true)]
+	public partial class RefreshCollectionViewGallery : ContentPage
+	{
+		public RefreshCollectionViewGallery()
+		{
+			InitializeComponent();
+			BindingContext = new RefreshViewModel();
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml
new file mode 100644
index 00000000000..d9f48dede07
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<ContentPage
+    xmlns="http://xamarin.com/schemas/2014/forms"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    x:Class="Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries.RefreshLayoutGallery"
+    Title="Layout (Pull To Refresh)">
+    <ContentPage.Resources>
+        <ResourceDictionary>
+
+             <DataTemplate x:Key="RefreshItemTemplate">
+                 <Grid
+                     HeightRequest="100"
+                     WidthRequest="100">
+                     <Grid.RowDefinitions>
+                         <RowDefinition Height="*" />
+                         <RowDefinition Height="Auto" />
+                     </Grid.RowDefinitions>
+                    <BoxView
+                        Grid.Row="0"
+                        Color="{Binding Color}"/>
+                     <Label
+                         Grid.Row="1"
+                         Text="{Binding Name}"/>
+                   </Grid>
+             </DataTemplate>
+
+        </ResourceDictionary>
+    </ContentPage.Resources>
+    <ContentPage.Content>
+        <RefreshView
+            IsRefreshing="{Binding IsRefreshing}"
+            RefreshColor="Red"
+            Command="{Binding RefreshCommand}"
+            HorizontalOptions="FillAndExpand"
+            VerticalOptions="FillAndExpand">
+            <StackLayout
+                Padding="6">
+                <Label
+                    FontSize="Medium"
+                    FontAttributes="Bold"
+                    Text="The Content of a RefreshView must be a scrollable control, such as ScrollView, CollectionView, ListView, etc."/>
+                <Label
+                    FontSize="Small"
+                    Text="Setting the Content to a control like Grid will result in undefined behavior."/>
+            </StackLayout>
+        </RefreshView> 
+    </ContentPage.Content>
+</ContentPage>
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml.cs b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml.cs
new file mode 100644
index 00000000000..f1f04db5707
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshLayoutGallery.xaml.cs
@@ -0,0 +1,14 @@
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries
+{
+	[Preserve(AllMembers = true)]
+	public partial class RefreshLayoutGallery : ContentPage
+	{
+		public RefreshLayoutGallery()
+		{
+			InitializeComponent();
+			BindingContext = new RefreshViewModel();
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml
new file mode 100644
index 00000000000..b3ee912454a
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<ContentPage
+    xmlns="http://xamarin.com/schemas/2014/forms"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    x:Class="Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries.RefreshListViewGallery"
+    Title="ListView (Pull To Refresh)">
+    <ContentPage.Content>
+        <StackLayout>
+            <Button
+                Text="Trigger Refresh"
+                Command="{Binding RefreshCommand}"/>
+            <RefreshView
+                IsRefreshing="{Binding IsRefreshing}"
+                BackgroundColor="Red"
+                RefreshColor="Yellow"
+                Command="{Binding RefreshCommand}"
+                HorizontalOptions="FillAndExpand"
+                VerticalOptions="FillAndExpand">
+                <ListView
+                    ItemsSource="{Binding Items}"
+                    Header = "Header"
+                    Footer = "Footer"
+                    HasUnevenRows="True"
+                    SeparatorVisibility="None">
+                    <ListView.ItemTemplate>
+                        <DataTemplate>
+                            <ViewCell>
+                                <Grid>
+                                    <Grid.ColumnDefinitions>
+                                        <ColumnDefinition Width="48" />
+                                        <ColumnDefinition Width="*" />
+                                    </Grid.ColumnDefinitions>
+                                    <BoxView
+                                        Grid.Column="0"
+                                        Color="{Binding Color}"
+                                        HeightRequest="48"/>
+                                    <Label
+                                        Grid.Column="1"
+                                        Text="{Binding Name}"/>
+                                </Grid>
+                            </ViewCell>
+                        </DataTemplate>
+                    </ListView.ItemTemplate>
+                </ListView>
+            </RefreshView>
+        </StackLayout>
+    </ContentPage.Content>
+</ContentPage>
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml.cs b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml.cs
new file mode 100644
index 00000000000..281156569b8
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshListViewGallery.xaml.cs
@@ -0,0 +1,14 @@
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries
+{
+	[Preserve(AllMembers = true)]
+	public partial class RefreshListViewGallery : ContentPage
+	{
+		public RefreshListViewGallery()
+		{
+			InitializeComponent();
+			BindingContext = new RefreshViewModel();
+		}
+	}
+}
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml
new file mode 100644
index 00000000000..f659d1866e1
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<ContentPage
+    xmlns="http://xamarin.com/schemas/2014/forms"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    x:Class="Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries.RefreshScrollViewGallery"
+    Title="ScrollView (Pull To Refresh)">
+    <ContentPage.Resources>
+        <ResourceDictionary>
+
+             <DataTemplate x:Key="RefreshItemTemplate">
+                 <Grid
+                     HeightRequest="120"
+                     WidthRequest="120">
+                     <Grid.RowDefinitions>
+                         <RowDefinition Height="*" />
+                         <RowDefinition Height="Auto" />
+                     </Grid.RowDefinitions>
+                    <BoxView
+                        Grid.Row="0"
+                        Color="{Binding Color}"/>
+                     <Label
+                         Grid.Row="1"
+                         Text="{Binding Name}"/>
+                   </Grid>
+             </DataTemplate>
+
+        </ResourceDictionary>
+    </ContentPage.Resources>
+    <ContentPage.Content>
+        <RefreshView
+            IsRefreshing="{Binding IsRefreshing}"
+            RefreshColor="Red"
+            Command="{Binding RefreshCommand}"
+            HorizontalOptions="FillAndExpand"
+            VerticalOptions="FillAndExpand">
+            <ScrollView>
+                <FlexLayout
+                    Direction="Row"
+                    Wrap="Wrap"
+                    AlignItems="Stretch"
+                    AlignContent="Start"
+                    BindableLayout.ItemsSource="{Binding Items}"
+                    BindableLayout.ItemTemplate="{StaticResource RefreshItemTemplate}"/>
+            </ScrollView>
+        </RefreshView> 
+    </ContentPage.Content>
+</ContentPage>
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml.cs b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml.cs
new file mode 100644
index 00000000000..704fd2f7ca0
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshScrollViewGallery.xaml.cs
@@ -0,0 +1,14 @@
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries
+{
+	[Preserve(AllMembers = true)]
+	public partial class RefreshScrollViewGallery : ContentPage
+	{
+		public RefreshScrollViewGallery()
+		{
+			InitializeComponent();
+			BindingContext = new RefreshViewModel();
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshViewGallery.cs b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshViewGallery.cs
new file mode 100644
index 00000000000..4653a7d1a03
--- /dev/null
+++ b/Xamarin.Forms.Controls/GalleryPages/RefreshViewGalleries/RefreshViewGallery.cs
@@ -0,0 +1,99 @@
+using System;
+using System.Collections.ObjectModel;
+using System.Windows.Input;
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.Forms.Controls.GalleryPages.RefreshViewGalleries
+{
+	[Preserve(AllMembers = true)]
+	public class RefreshViewGallery : ContentPage
+	{
+		public RefreshViewGallery()
+		{
+			Title = "RefreshView Gallery";
+			Content = new StackLayout
+			{
+				Children =
+				{
+					new Button { Text ="Enable CollectionView", AutomationId = "EnableCollectionView", Command = new Command(() => Device.SetFlags(new[] { ExperimentalFlags.CollectionViewExperimental })) },
+					GalleryBuilder.NavButton("Refresh Layout Gallery", () => new RefreshLayoutGallery(), Navigation),
+					GalleryBuilder.NavButton("Refresh ScrollView Gallery", () => new RefreshScrollViewGallery(), Navigation),
+					GalleryBuilder.NavButton("Refresh ListView Gallery", () => new RefreshListViewGallery(), Navigation),
+					GalleryBuilder.NavButton("Refresh CollectionView Gallery", () => new RefreshCollectionViewGallery(), Navigation)
+				}
+			};
+		}
+	}
+
+	[Preserve(AllMembers = true)]
+	public class RefreshItem
+	{
+		public string Name { get; set; }
+		public Color Color { get; set; }
+	}
+
+	[Preserve(AllMembers = true)]
+	public class RefreshViewModel : BindableObject
+	{
+		const int RefreshDuration = 2;
+
+		readonly Random _random;
+		bool _isRefresing;
+		ObservableCollection<RefreshItem> _items;
+		
+		public RefreshViewModel()
+		{
+			_random = new Random();
+			Items = new ObservableCollection<RefreshItem>();
+			LoadItems();
+		}
+
+		public bool IsRefreshing
+		{
+			get { return _isRefresing; }
+			set
+			{
+				_isRefresing = value;
+				OnPropertyChanged();
+			}
+		}
+
+		public ObservableCollection<RefreshItem> Items
+		{
+			get { return _items; }
+			set
+			{
+				_items = value;
+				OnPropertyChanged();
+			}
+		}
+
+		public ICommand RefreshCommand => new Command(ExecuteRefresh);
+
+		void LoadItems()
+		{
+			for (int i = 0; i < 50; i++)
+			{
+				Items.Insert(i, new RefreshItem
+				{
+					Color = Color.FromRgb(_random.Next(0, 255), _random.Next(0, 255), _random.Next(0, 255)),
+					Name = DateTime.Now.AddMinutes(i).ToString("F")
+				});
+			}
+		}
+
+		void ExecuteRefresh()
+		{
+			IsRefreshing = true;
+
+			Device.StartTimer(TimeSpan.FromSeconds(RefreshDuration), () =>
+			{
+				LoadItems();
+
+				IsRefreshing = false;
+
+				return false;
+			});
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Controls/Xamarin.Forms.Controls.csproj b/Xamarin.Forms.Controls/Xamarin.Forms.Controls.csproj
index 63952a42a2b..6f71481b402 100644
--- a/Xamarin.Forms.Controls/Xamarin.Forms.Controls.csproj
+++ b/Xamarin.Forms.Controls/Xamarin.Forms.Controls.csproj
@@ -28,7 +28,7 @@
     <ProjectReference Include="..\Xamarin.Forms.Maps\Xamarin.Forms.Maps.csproj" />
     <ProjectReference Include="..\Xamarin.Forms.Xaml\Xamarin.Forms.Xaml.csproj" />
   </ItemGroup>
-
+  
   <ItemGroup>
     <EmbeddedResource Include="BuildNumber.txt" />
     <EmbeddedResource Include="GalleryPages\crimson.jpg" />
@@ -112,9 +112,9 @@
     </EmbeddedResource>
     <EmbeddedResource Update="GalleryPages\ControlTemplateXamlPage.xaml">
       <Generator>MSBuild:UpdateDesignTimeXaml</Generator>
-    </EmbeddedResource>
+    </EmbeddedResource>   
   </ItemGroup>
-
+  
   <Target Name="CreateControllGalleryConfig" BeforeTargets="Build">
     <CreateItem Include="blank.config">
       <Output TaskParameter="Include" ItemName="ConfigFile" />
diff --git a/Xamarin.Forms.Core/PlatformConfiguration/WindowsSpecific/RefreshView.cs b/Xamarin.Forms.Core/PlatformConfiguration/WindowsSpecific/RefreshView.cs
new file mode 100644
index 00000000000..61d4d8712cd
--- /dev/null
+++ b/Xamarin.Forms.Core/PlatformConfiguration/WindowsSpecific/RefreshView.cs
@@ -0,0 +1,40 @@
+namespace Xamarin.Forms.PlatformConfiguration.WindowsSpecific
+{
+	using FormsElement = Forms.RefreshView;
+
+	public static class RefreshView
+	{
+		public enum RefreshPullDirection
+		{
+			LeftToRight,
+			TopToBottom,
+			RightToLeft,
+			BottomToTop
+		}
+
+		public static readonly BindableProperty RefreshPullDirectionProperty = BindableProperty.Create("RefreshPullDirection", typeof(RefreshPullDirection), typeof(FormsElement), RefreshPullDirection.TopToBottom);
+
+		public static void SetRefreshPullDirection(BindableObject element, RefreshPullDirection value)
+		{
+			element.SetValue(RefreshPullDirectionProperty, value);
+		}
+
+		public static RefreshPullDirection GetRefreshPullDirection(this IPlatformElementConfiguration<Windows, FormsElement> config)
+		{
+			return GetRefreshPullDirection(config.Element);
+		}
+
+		public static RefreshPullDirection GetRefreshPullDirection(BindableObject element)
+		{
+			return (RefreshPullDirection)element.GetValue(RefreshPullDirectionProperty);
+		}
+
+		public static IPlatformElementConfiguration<Windows, FormsElement> SetRefreshPullDirection(
+			this IPlatformElementConfiguration<Windows, FormsElement> config, RefreshPullDirection value)
+		{
+			SetRefreshPullDirection(config.Element, value);
+			return config;
+		}
+	}
+
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Core/RefreshView.cs b/Xamarin.Forms.Core/RefreshView.cs
new file mode 100644
index 00000000000..d19a577ee54
--- /dev/null
+++ b/Xamarin.Forms.Core/RefreshView.cs
@@ -0,0 +1,81 @@
+using System;
+using System.Windows.Input;
+using Xamarin.Forms.Platform;
+
+namespace Xamarin.Forms
+{
+	[ContentProperty("Content")]
+	[RenderWith(typeof(_RefreshViewRenderer))]
+	public class RefreshView : ContentView, IElementConfiguration<RefreshView>
+	{
+		readonly Lazy<PlatformConfigurationRegistry<RefreshView>> _platformConfigurationRegistry;
+
+		public RefreshView()
+		{
+			IsClippedToBounds = true;
+			VerticalOptions = LayoutOptions.FillAndExpand;
+			HorizontalOptions = LayoutOptions.FillAndExpand;
+
+			_platformConfigurationRegistry = new Lazy<PlatformConfigurationRegistry<RefreshView>>(() => new PlatformConfigurationRegistry<RefreshView>(this));
+		}
+
+		public static readonly BindableProperty IsRefreshingProperty =
+			BindableProperty.Create(nameof(IsRefreshing), typeof(bool), typeof(RefreshView), false);
+
+		public bool IsRefreshing
+		{
+			get { return (bool)GetValue(IsRefreshingProperty); }
+			set { SetValue(IsRefreshingProperty, value); }
+		}
+
+		public static readonly BindableProperty CommandProperty =
+			BindableProperty.Create(nameof(Command), typeof(ICommand), typeof(RefreshView));
+
+		public ICommand Command
+		{
+			get { return (ICommand)GetValue(CommandProperty); }
+			set { SetValue(CommandProperty, value); }
+		}
+
+		public static readonly BindableProperty CommandParameterProperty =
+			BindableProperty.Create(nameof(CommandParameter),
+				typeof(object),
+				typeof(RefreshView),
+				null,
+				propertyChanged: (bindable, oldvalue, newvalue) => ((RefreshView)bindable).RefreshCommandCanExecuteChanged(bindable, EventArgs.Empty));
+
+		public object CommandParameter
+		{
+			get { return GetValue(CommandParameterProperty); }
+			set { SetValue(CommandParameterProperty, value); }
+		}
+
+		void RefreshCommandCanExecuteChanged(object sender, EventArgs eventArgs)
+		{
+			if (Command != null)
+				IsEnabled = Command.CanExecute(CommandParameter);
+		}
+
+		public static readonly BindableProperty RefreshColorProperty =
+			BindableProperty.Create(nameof(RefreshColor), typeof(Color), typeof(RefreshView), Color.Default);
+
+		public Color RefreshColor
+		{
+			get { return (Color)GetValue(RefreshColorProperty); }
+			set { SetValue(RefreshColorProperty, value); }
+		}
+
+		protected override SizeRequest OnMeasure(double widthConstraint, double heightConstraint)
+		{
+			if (Content == null)
+				return new SizeRequest(new Size(100, 100));
+
+			return base.OnMeasure(widthConstraint, heightConstraint);
+		}
+
+		public IPlatformElementConfiguration<T, RefreshView> On<T>() where T : IConfigPlatform
+		{
+			return _platformConfigurationRegistry.Value.On<T>();
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.CustomAttributes/TestAttributes.cs b/Xamarin.Forms.CustomAttributes/TestAttributes.cs
index d5e4d0c5fcb..1e1ea241f9e 100644
--- a/Xamarin.Forms.CustomAttributes/TestAttributes.cs
+++ b/Xamarin.Forms.CustomAttributes/TestAttributes.cs
@@ -662,6 +662,11 @@ public enum ProgressBar
 			ProgressColor
 		}
 
+		public enum RefreshView
+		{
+			RefreshColor
+		}
+
 		public enum RelativeLayout
 		{
 			Children,
diff --git a/Xamarin.Forms.Platform.Android/Properties/AssemblyInfo.cs b/Xamarin.Forms.Platform.Android/Properties/AssemblyInfo.cs
index ed9c158fae0..3a5f06c39ae 100644
--- a/Xamarin.Forms.Platform.Android/Properties/AssemblyInfo.cs
+++ b/Xamarin.Forms.Platform.Android/Properties/AssemblyInfo.cs
@@ -37,6 +37,7 @@
 [assembly: ExportRenderer (typeof (CarouselPage), typeof (CarouselPageRenderer))]
 [assembly: ExportRenderer (typeof (Page), typeof (PageRenderer))]
 [assembly: ExportRenderer (typeof (MasterDetailPage), typeof (MasterDetailRenderer))]
+[assembly: ExportRenderer (typeof (RefreshView), typeof (RefreshViewRenderer))]
 #endif
 
 [assembly: ExportRenderer(typeof(Shell), typeof(ShellRenderer))]
diff --git a/Xamarin.Forms.Platform.Android/Renderers/RefreshViewRenderer.cs b/Xamarin.Forms.Platform.Android/Renderers/RefreshViewRenderer.cs
new file mode 100644
index 00000000000..858a106ecbf
--- /dev/null
+++ b/Xamarin.Forms.Platform.Android/Renderers/RefreshViewRenderer.cs
@@ -0,0 +1,270 @@
+using System;
+using System.ComponentModel;
+using Android.Content;
+using Android.OS;
+using Android.Support.V4.View;
+using Android.Support.V4.Widget;
+using Android.Support.V7.Widget;
+using Android.Views;
+using Android.Widget;
+using Xamarin.Forms.Internals;
+using AView = Android.Views.View;
+
+namespace Xamarin.Forms.Platform.Android
+{
+	public class RefreshViewRenderer : SwipeRefreshLayout, IVisualElementRenderer, IEffectControlProvider, SwipeRefreshLayout.IOnRefreshListener
+	{
+		bool _isDisposed;
+		bool _init;
+		bool _refreshing;
+		IVisualElementRenderer _renderer;
+		int? _defaultLabelFor;
+
+		public event EventHandler<VisualElementChangedEventArgs> ElementChanged;
+		public event EventHandler<PropertyChangedEventArgs> ElementPropertyChanged;
+
+		public RefreshViewRenderer(Context context)
+			: base(context)
+		{
+
+		}
+
+		public VisualElementTracker Tracker { get; private set; }
+
+		public ViewGroup ViewGroup => this;
+
+		public AView View => this;
+
+		public SwipeRefreshLayout SwipeRefreshLayout => View as SwipeRefreshLayout;
+
+		public VisualElement Element { get; private set; }
+
+		public RefreshView RefreshView => Element != null ? (RefreshView)Element : null;
+
+		public override bool Refreshing
+		{
+			get
+			{
+				return _refreshing;
+			}
+			set
+			{
+				_refreshing = value;
+
+				if (RefreshView != null && RefreshView.IsRefreshing != _refreshing)
+					RefreshView.IsRefreshing = _refreshing;
+
+				if (base.Refreshing == _refreshing)
+					return;
+
+				base.Refreshing = _refreshing;
+			}
+		}
+
+		public override bool CanChildScrollUp() => CanScrollUp(_renderer.View);
+
+		public void SetElement(VisualElement element)
+		{
+			var oldElement = Element;
+
+			if (oldElement != null)
+				oldElement.PropertyChanged -= HandlePropertyChanged;
+
+			Element = element;
+
+			if (Element != null)
+			{
+				UpdateContent();
+				Element.PropertyChanged += HandlePropertyChanged;
+			}
+
+			if (!_init)
+			{
+				_init = true;
+				Tracker = new VisualElementTracker(this);
+				SetOnRefreshListener(this);
+			}
+
+			UpdateColors();
+			UpdateIsRefreshing();
+			UpdateIsEnabled();
+
+			ElementChanged?.Invoke(this, new VisualElementChangedEventArgs(oldElement, Element));
+			EffectUtilities.RegisterEffectControlProvider(this, oldElement, element);
+		}
+
+		void UpdateContent()
+		{
+			if (_renderer != null)
+			{
+				_renderer.View.RemoveFromParent();
+				_renderer.Dispose();
+				_renderer = null;
+			}
+
+			if (RefreshView.Content != null)
+			{
+				_renderer = Platform.CreateRenderer(RefreshView.Content, Context);
+
+				Platform.SetRenderer(RefreshView.Content, _renderer);
+
+				if (_renderer.View.Parent != null)
+					_renderer.View.RemoveFromParent();
+
+				using (var layoutParams = new LayoutParams(LayoutParams.MatchParent, LayoutParams.MatchParent))
+					SwipeRefreshLayout.AddView(_renderer.View, layoutParams);
+			}
+		}
+
+		void UpdateColors()
+		{
+			if (RefreshView == null)
+				return;
+
+			if (RefreshView.RefreshColor != Color.Default)
+				SetColorSchemeColors(RefreshView.RefreshColor.ToAndroid());
+			if (RefreshView.BackgroundColor != Color.Default)
+				SetProgressBackgroundColorSchemeColor(RefreshView.BackgroundColor.ToAndroid());
+		}
+
+		void UpdateIsRefreshing() => Refreshing = RefreshView.IsRefreshing;
+
+		void UpdateIsEnabled() => SwipeRefreshLayout.Enabled = RefreshView.IsEnabled;
+
+		bool CanScrollUp(AView view)
+		{
+			if (!(view is ViewGroup viewGroup))
+				return base.CanChildScrollUp();
+
+			if (Forms.SdkInt < BuildVersionCodes.JellyBean && viewGroup.IsScrollContainer)
+				return base.CanChildScrollUp();
+
+			if (!CanScrollUpViewByType(view))
+				return false;
+
+			for (int i = 0; i < viewGroup.ChildCount; i++)
+			{
+				var child = viewGroup.GetChildAt(i);
+
+				if (!CanScrollUpViewByType(child))
+					return false;
+
+				if (child is SwipeRefreshLayout)
+				{
+					return CanScrollUp(child as ViewGroup);
+				}
+			}
+
+			return true;
+		}
+
+		bool CanScrollUpViewByType(AView view)
+		{
+			if (view is AbsListView absListView)
+			{
+				if (absListView.FirstVisiblePosition == 0)
+				{
+					var subChild = absListView.GetChildAt(0);
+
+					return subChild != null && subChild.Top != 0;
+				}
+
+				return true;
+			}
+
+			if(view is RecyclerView recyclerView)
+				return recyclerView.ScrollY < 0;
+
+			if (view is global::Android.Widget.ScrollView scrollview)
+				return scrollview.ScrollY < 0;
+
+			if (view is NestedScrollView nestedScrollView)
+				return nestedScrollView.ScrollY < 0;
+
+			return true;
+		}
+
+		public void OnRefresh()
+		{
+			if (RefreshView?.Command?.CanExecute(RefreshView?.CommandParameter) ?? false)
+			{
+				RefreshView.Command.Execute(RefreshView?.CommandParameter);
+			}
+		}
+
+		void HandlePropertyChanged(object sender, PropertyChangedEventArgs e)
+		{
+			if (e.PropertyName == ContentView.ContentProperty.PropertyName)
+				UpdateContent();
+			else if (e.PropertyName == VisualElement.IsEnabledProperty.PropertyName)
+				UpdateIsEnabled();
+			else if (e.PropertyName == RefreshView.IsRefreshingProperty.PropertyName)
+				UpdateIsRefreshing();
+			else if (e.IsOneOf(RefreshView.RefreshColorProperty, VisualElement.BackgroundColorProperty))
+				UpdateColors();
+
+			ElementPropertyChanged?.Invoke(sender, e);
+
+		}
+
+		public SizeRequest GetDesiredSize(int widthConstraint, int heightConstraint)
+		{
+			_renderer.View.Measure(widthConstraint, heightConstraint);
+
+			return new SizeRequest(new Size(_renderer.View.MeasuredWidth, _renderer.View.MeasuredHeight), new Size(100, 100));
+		}
+
+		public void UpdateLayout() => Tracker?.UpdateLayout();
+
+		protected override void Dispose(bool disposing)
+		{
+			if (_isDisposed)
+				return;
+
+			if (disposing)
+			{
+				if (Element != null)
+				{
+					Element.PropertyChanged -= HandlePropertyChanged;
+				}
+
+				if (_renderer != null)
+					_renderer.View.RemoveFromParent();
+
+				_renderer?.Dispose();
+				_renderer = null;
+
+				Tracker?.Dispose();
+				Tracker = null;
+
+				_init = false;
+			}
+
+			_isDisposed = true;
+
+			base.Dispose(disposing);
+		}
+
+		public void SetLabelFor(int? id)
+		{
+			if (_defaultLabelFor == null)
+			{
+				_defaultLabelFor = ViewCompat.GetLabelFor(this);
+			}
+
+			ViewCompat.SetLabelFor(this, (int)(id ?? _defaultLabelFor));
+		}
+
+		void IEffectControlProvider.RegisterEffect(Effect effect)
+		{
+			if (effect is PlatformEffect platformEffect)
+				OnRegisterEffect(platformEffect);
+		}
+
+		void OnRegisterEffect(PlatformEffect effect)
+		{
+			effect.SetContainer(this);
+			effect.SetControl(this);
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Platform.Android/Xamarin.Forms.Platform.Android.csproj b/Xamarin.Forms.Platform.Android/Xamarin.Forms.Platform.Android.csproj
index 34319ff20e1..beff24516b1 100644
--- a/Xamarin.Forms.Platform.Android/Xamarin.Forms.Platform.Android.csproj
+++ b/Xamarin.Forms.Platform.Android/Xamarin.Forms.Platform.Android.csproj
@@ -331,6 +331,7 @@
     <Compile Include="StepperRendererManager.cs" />
     <Compile Include="AppCompat\CheckBoxRenderer.cs" />
     <Compile Include="AppCompat\CheckBoxDesignerRenderer.cs" />
+    <Compile Include="Renderers\RefreshViewRenderer.cs" />
   </ItemGroup>
   <Import Project="$(MSBuildExtensionsPath)\Xamarin\Android\Xamarin.Android.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it.
diff --git a/Xamarin.Forms.Platform.iOS/Properties/AssemblyInfo.cs b/Xamarin.Forms.Platform.iOS/Properties/AssemblyInfo.cs
index 09ba19c940b..e375d5e97f9 100644
--- a/Xamarin.Forms.Platform.iOS/Properties/AssemblyInfo.cs
+++ b/Xamarin.Forms.Platform.iOS/Properties/AssemblyInfo.cs
@@ -35,6 +35,7 @@
 [assembly: ExportRenderer(typeof(CarouselPage), typeof(CarouselPageRenderer))]
 [assembly: ExportRenderer(typeof(Page), typeof(PageRenderer))]
 [assembly: ExportRenderer(typeof(MasterDetailPage), typeof(PhoneMasterDetailRenderer), UIUserInterfaceIdiom.Phone)]
+[assembly: ExportRenderer(typeof(RefreshView), typeof(RefreshViewRenderer))]
 #endif
 
 [assembly: ExportRenderer(typeof(MasterDetailPage), typeof(TabletMasterDetailRenderer), UIUserInterfaceIdiom.Pad)]
diff --git a/Xamarin.Forms.Platform.iOS/Renderers/RefreshViewRenderer.cs b/Xamarin.Forms.Platform.iOS/Renderers/RefreshViewRenderer.cs
new file mode 100644
index 00000000000..72b17ca0631
--- /dev/null
+++ b/Xamarin.Forms.Platform.iOS/Renderers/RefreshViewRenderer.cs
@@ -0,0 +1,215 @@
+using System;
+using System.ComponentModel;
+using UIKit;
+using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
+
+namespace Xamarin.Forms.Platform.iOS
+{
+	public class RefreshViewRenderer : ViewRenderer<RefreshView, UIView>, IEffectControlProvider
+	{
+		bool _isDisposed;
+		bool _isRefreshing;
+		bool _usingLargeTitles;
+		nfloat _origininalY;
+		nfloat _refreshControlHeight;
+		UIView _refreshControlParent;
+		UIRefreshControl _refreshControl;
+
+		public bool IsRefreshing
+		{
+			get { return _isRefreshing; }
+			set
+			{
+				_isRefreshing = value;
+
+				if (_isRefreshing)
+					_refreshControl.BeginRefreshing();
+				else
+					_refreshControl.EndRefreshing();
+
+				TryOffsetRefresh(this, IsRefreshing);
+			}
+		}
+
+		protected override void OnElementChanged(ElementChangedEventArgs<RefreshView> e)
+		{
+			base.OnElementChanged(e);
+
+			if (e.OldElement != null || Element == null)
+				return;
+
+			if (e.NewElement != null)
+			{
+				if (Control == null)
+				{
+					if (Forms.IsiOS11OrNewer)
+					{
+						var parentNav = e.NewElement.FindParentOfType<NavigationPage>();
+						_usingLargeTitles = parentNav != null && parentNav.OnThisPlatform().PrefersLargeTitles();
+					}
+
+					_refreshControl = new UIRefreshControl();
+					_refreshControl.ValueChanged += OnRefresh;
+					_refreshControlParent = this;
+				}
+			}
+
+			UpdateColors();
+			UpdateIsRefreshing();
+			UpdateIsEnabled();
+		}
+
+		protected override void OnElementPropertyChanged(object sender, PropertyChangedEventArgs e)
+		{
+			base.OnElementPropertyChanged(sender, e);
+
+			if (e.PropertyName == VisualElement.IsEnabledProperty.PropertyName)
+				UpdateIsEnabled();
+			else if (e.PropertyName == RefreshView.IsRefreshingProperty.PropertyName)
+				UpdateIsRefreshing();
+			else if (e.IsOneOf(RefreshView.RefreshColorProperty, VisualElement.BackgroundColorProperty))
+				UpdateColors();
+		}
+
+		protected override void SetBackgroundColor(Color color)
+		{
+			if (_refreshControl == null)
+				return;
+
+			_refreshControl.BackgroundColor = color != Color.Default ? color.ToUIColor() : null;
+		}
+
+		protected override void Dispose(bool disposing)
+		{
+			if (_isDisposed)
+				return;
+
+			if (disposing && Control != null)
+			{
+				_refreshControl.ValueChanged -= OnRefresh;
+				_refreshControl.Dispose();
+				_refreshControl = null;
+				_refreshControlParent = null;
+			}
+
+			_isDisposed = true;
+			base.Dispose(disposing);
+		}
+
+		bool TryOffsetRefresh(UIView view, bool refreshing)
+		{
+			if (view is UIScrollView scrollView)
+			{
+				if (scrollView.ContentOffset.Y < 0)
+					return true;
+
+				if (refreshing)
+					scrollView.SetContentOffset(new CoreGraphics.CGPoint(0, _origininalY - _refreshControlHeight), true);
+				else
+					scrollView.SetContentOffset(new CoreGraphics.CGPoint(0, _origininalY), true);
+
+				return true;
+			}
+
+			if (view is UIWebView)
+			{
+				return true;
+			}
+
+			if (view.Subviews == null)
+				return false;
+
+			for (int i = 0; i < view.Subviews.Length; i++)
+			{
+				var control = view.Subviews[i];
+				if (TryOffsetRefresh(control, refreshing))
+					return true;
+			}
+
+			return false;
+		}
+
+		bool TryInsertRefresh(UIView view, int index = 0)
+		{
+			_refreshControlParent = view;
+
+			if (view is UIScrollView scrollView)
+			{
+				if (CanUseRefreshControlProperty())
+					scrollView.RefreshControl = _refreshControl;
+				else
+					scrollView.InsertSubview(_refreshControl, index);
+
+				scrollView.AlwaysBounceVertical = true;
+
+				_origininalY = scrollView.ContentOffset.Y;
+				_refreshControlHeight = _refreshControl.Frame.Size.Height;
+
+				return true;
+			}
+
+			if (view is UIWebView webView)
+			{
+				webView.ScrollView.InsertSubview(_refreshControl, index);
+				return true;
+			}
+
+			if (view.Subviews == null)
+				return false;
+
+			for (int i = 0; i < view.Subviews.Length; i++)
+			{
+				var control = view.Subviews[i];
+				if (TryInsertRefresh(control, i))
+					return true;
+			}
+
+			return false;
+		}
+
+		void UpdateColors()
+		{
+			if (Element == null || _refreshControl == null)
+				return;
+
+			if (Element.RefreshColor != Color.Default)
+				_refreshControl.TintColor = Element.RefreshColor.ToUIColor();
+
+			SetBackgroundColor(Element.BackgroundColor);
+		}
+
+		void UpdateIsRefreshing()
+		{
+			IsRefreshing = Element.IsRefreshing;
+		}
+
+		void UpdateIsEnabled()
+		{
+			if (Element.IsEnabled)
+				TryInsertRefresh(_refreshControlParent);
+			else
+			{
+				if (_refreshControl.Superview != null)
+					_refreshControl.RemoveFromSuperview();
+			}
+		}
+
+		bool CanUseRefreshControlProperty()
+		{
+			return Forms.IsiOS10OrNewer && !_usingLargeTitles;
+		}
+
+		void OnRefresh(object sender, EventArgs e)
+		{
+			if (Element?.Command?.CanExecute(Element?.CommandParameter) ?? false)
+			{
+				Element.Command.Execute(Element?.CommandParameter);
+			}
+		}
+
+		void IEffectControlProvider.RegisterEffect(Effect effect)
+		{
+			VisualElementRenderer<VisualElement>.RegisterEffect(effect, this, NativeView);
+		}
+	}
+}
\ No newline at end of file
diff --git a/Xamarin.Forms.Platform.iOS/Xamarin.Forms.Platform.iOS.csproj b/Xamarin.Forms.Platform.iOS/Xamarin.Forms.Platform.iOS.csproj
index f82e2dcf9d5..41c01631161 100644
--- a/Xamarin.Forms.Platform.iOS/Xamarin.Forms.Platform.iOS.csproj
+++ b/Xamarin.Forms.Platform.iOS/Xamarin.Forms.Platform.iOS.csproj
@@ -224,6 +224,7 @@
     <Compile Include="Renderers\IButtonLayoutRenderer.cs" />
     <Compile Include="Renderers\SearchHandlerAppearanceTracker.cs" />
     <Compile Include="Renderers\CheckBoxRenderer.cs" />
+    <Compile Include="Renderers\RefreshViewRenderer.cs" />
   </ItemGroup>
   <ItemGroup>
     <EmbeddedResource Include="Resources\StringResources.ar.resx" />
diff --git a/Xamarin.Forms.Platform/Xamarin.Forms.Platform.cs b/Xamarin.Forms.Platform/Xamarin.Forms.Platform.cs
index d7cbce0aa82..7a7a478016a 100644
--- a/Xamarin.Forms.Platform/Xamarin.Forms.Platform.cs
+++ b/Xamarin.Forms.Platform/Xamarin.Forms.Platform.cs
@@ -87,6 +87,10 @@ internal class _ProgressBarRenderer
 	{
 	}
 
+	internal class _RefreshViewRenderer
+	{
+	}
+
 	internal class _ScrollViewRenderer
 	{
 	}