feat(android): refreshControl offset property

android/modules/ui/src/java/ti/modules/titanium/ui/RefreshControlProxy.java

@@ -13,7 +13,10 @@
 import org.appcelerator.kroll.KrollDict;
 import org.appcelerator.kroll.KrollProxy;
 import org.appcelerator.titanium.TiC;
+import org.appcelerator.titanium.TiDimension;
 import org.appcelerator.titanium.util.TiColorHelper;
+import org.appcelerator.titanium.util.TiConvert;
+
 import ti.modules.titanium.ui.widget.TiSwipeRefreshLayout;
 
 @Kroll.proxy(creatableInModule = UIModule.class,
@@ -25,7 +28,8 @@ public class RefreshControlProxy extends KrollProxy
 {
 	/** The default Android log tag name to be used by this class. */
 	private static final String TAG = "RefreshControlProxy";
-
+	private static int offsetStart = -1;
+	private static int offsetEnd = -1;
 	/**
 	 * Android's default progress indicator color used by the SwipeRefreshLayout class.
 	 * This is defined in Google's "MaterialProgressDrawable.java", which is an internal class.
@@ -85,9 +89,18 @@ public void handleCreationDict(KrollDict properties)
 		super.handleCreationDict(properties);
 
 		// Fetch "tintColor" property, if provided.
-		value = properties.get(TiC.PROPERTY_TINT_COLOR);
-		if (value != null) {
-			onTintColorChanged(value);
+		if (properties.containsKeyAndNotNull(TiC.PROPERTY_TINT_COLOR)) {
+			value = properties.get(TiC.PROPERTY_TINT_COLOR);
+			if (value != null) {
+				onTintColorChanged(value);
+			}
+		}
+		if (properties.containsKeyAndNotNull("offset")) {
+			KrollDict offset = properties.getKrollDict("offset");
+			offsetStart = new TiDimension(TiConvert.toInt(offset.get("start"), 0), TiDimension.TYPE_TOP)
+				.getAsPixels(this.swipeRefreshLayout);
+			offsetEnd = new TiDimension(TiConvert.toInt(offset.get("end"), 80), TiDimension.TYPE_BOTTOM)
+				.getAsPixels(this.swipeRefreshLayout);
 		}
 	}
 
@@ -221,6 +234,9 @@ public void assignTo(TiSwipeRefreshLayout view)
 
 		// Set up the given view for pull-down refresh support.
 		view.setColorSchemeColors(this.tintColor);
+		if (offsetStart != -1 && offsetEnd != -1) {
+			view.setProgressViewOffset(false, offsetStart, offsetEnd);
+		}
 		view.setSwipeRefreshEnabled(true);
 		view.setOnRefreshListener(new TiSwipeRefreshLayout.OnRefreshListener() {
 			@Override

apidoc/Titanium/UI/RefreshControl.yml

@@ -55,6 +55,13 @@ properties:
     platforms: [android, iphone, ipad, macos]
     since: { android: "6.2.0", iphone: "3.2.0", ipad: "3.2.0" }
 
+  - name: offset
+    summary: Offset of the refresh control view.
+    type: RefreshControlOffset
+    platforms: [android]
+    since: { android: "12.4.0" }
+    availability: creation
+
   - name: backgroundColor
     summary: The background color for the refresh control, as a color name or hex triplet.
     description: |
@@ -146,3 +153,13 @@ examples:
 
         $.index.open();
         ```
+---
+name: RefreshControlOffset
+summary: Offset of the refresh control view.
+properties:
+  - name: start
+    summary: The offset from the top of this view at which the progress spinner should appear.
+    type: Number
+  - name: end
+    summary: The offset from the top of this view at which the progress spinner should come to rest after a successful swipe gesture.
+    type: Number