js: declare scroll to item with top offset api

doric-js/bundle/doric-lib.es5.js

@@ -1132,6 +1132,7 @@ var Panel = /** @class */ (function () {
         this.headviews = new Map;
         this.onRenderFinishedCallback = [];
         this.__rendering__ = false;
+        this.callingRenderFinishedCallback = false;
         this.snapshotEnabled = false;
         this.renderSnapshots = [];
     }
@@ -1370,12 +1371,17 @@ var Panel = /** @class */ (function () {
         return diryData;
     };
     Panel.prototype.onRenderFinished = function () {
+        this.callingRenderFinishedCallback = false;
         this.onRenderFinishedCallback.forEach(function (e) {
             e();
         });
         this.onRenderFinishedCallback.length = 0;
+        this.callingRenderFinishedCallback = true;
     };
     Panel.prototype.addOnRenderFinishedCallback = function (cb) {
+        if (this.callingRenderFinishedCallback) {
+            loge("Do not call addOnRenderFinishedCallback recursively");
+        }
         this.onRenderFinishedCallback.push(cb);
     };
     __decorate$e([
@@ -2558,9 +2564,13 @@ var List = /** @class */ (function (_super) {
         }
         return ret;
     };
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
     List.prototype.scrollToItem = function (context, index, config) {
         var animated = config === null || config === void 0 ? void 0 : config.animated;
-        return this.nativeChannel(context, 'scrollToItem')({ index: index, animated: animated, });
+        var topOffset = config === null || config === void 0 ? void 0 : config.topOffset;
+        return this.nativeChannel(context, 'scrollToItem')({ index: index, animated: animated, topOffset: topOffset });
     };
     /**
      * @param context

doric-js/bundle/doric-lib.js

@@ -867,6 +867,7 @@ class Panel {
         this.headviews = new Map;
         this.onRenderFinishedCallback = [];
         this.__rendering__ = false;
+        this.callingRenderFinishedCallback = false;
         this.snapshotEnabled = false;
         this.renderSnapshots = [];
     }
@@ -1048,12 +1049,17 @@ class Panel {
         return diryData;
     }
     onRenderFinished() {
+        this.callingRenderFinishedCallback = false;
         this.onRenderFinishedCallback.forEach(e => {
             e();
         });
         this.onRenderFinishedCallback.length = 0;
+        this.callingRenderFinishedCallback = true;
     }
     addOnRenderFinishedCallback(cb) {
+        if (this.callingRenderFinishedCallback) {
+            loge("Do not call addOnRenderFinishedCallback recursively");
+        }
         this.onRenderFinishedCallback.push(cb);
     }
 }
@@ -1910,9 +1916,13 @@ class List extends Superview {
         }
         return ret;
     }
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
     scrollToItem(context, index, config) {
         const animated = config === null || config === void 0 ? void 0 : config.animated;
-        return this.nativeChannel(context, 'scrollToItem')({ index, animated, });
+        const topOffset = config === null || config === void 0 ? void 0 : config.topOffset;
+        return this.nativeChannel(context, 'scrollToItem')({ index, animated, topOffset });
     }
     /**
      * @param context

doric-js/bundle/doric-vm.js

@@ -2407,6 +2407,7 @@ class Panel {
         this.headviews = new Map;
         this.onRenderFinishedCallback = [];
         this.__rendering__ = false;
+        this.callingRenderFinishedCallback = false;
         this.snapshotEnabled = false;
         this.renderSnapshots = [];
     }
@@ -2588,12 +2589,17 @@ class Panel {
         return diryData;
     }
     onRenderFinished() {
+        this.callingRenderFinishedCallback = false;
         this.onRenderFinishedCallback.forEach(e => {
             e();
         });
         this.onRenderFinishedCallback.length = 0;
+        this.callingRenderFinishedCallback = true;
     }
     addOnRenderFinishedCallback(cb) {
+        if (this.callingRenderFinishedCallback) {
+            loge("Do not call addOnRenderFinishedCallback recursively");
+        }
         this.onRenderFinishedCallback.push(cb);
     }
 }
@@ -3450,9 +3456,13 @@ class List extends Superview {
         }
         return ret;
     }
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
     scrollToItem(context, index, config) {
         const animated = config === null || config === void 0 ? void 0 : config.animated;
-        return this.nativeChannel(context, 'scrollToItem')({ index, animated, });
+        const topOffset = config === null || config === void 0 ? void 0 : config.topOffset;
+        return this.nativeChannel(context, 'scrollToItem')({ index, animated, topOffset });
     }
     /**
      * @param context

doric-js/index.d.ts

@@ -718,6 +718,7 @@ declare module "doric" {
 		private headviews;
 		private onRenderFinishedCallback;
 		private __rendering__;
+		private callingRenderFinishedCallback;
 		addHeadView(type: string, v: View): void;
 		allHeadViews(): IterableIterator<Map<string, View>>;
 		removeHeadView(type: string, v: View | string): void;
@@ -1048,8 +1049,12 @@ declare module "doric" {
 		onDragging?: (from: number, to: number) => void;
 		onDragged?: (from: number, to: number) => void;
 		preloadItemCount?: number;
+		/**
+		 * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+		 */
 		scrollToItem(context: BridgeContext, index: number, config?: {
 			animated?: boolean;
+			topOffset?: number;
 		}): Promise<any>;
 		/**
 		 * @param context

doric-js/lib/src/ui/panel.d.ts

@@ -21,6 +21,7 @@ export declare abstract class Panel {
     private headviews;
     private onRenderFinishedCallback;
     private __rendering__;
+    private callingRenderFinishedCallback;
     addHeadView(type: string, v: View): void;
     allHeadViews(): IterableIterator<Map<string, View>>;
     removeHeadView(type: string, v: View | string): void;

doric-js/lib/src/ui/panel.js

@@ -40,6 +40,7 @@ export class Panel {
         this.headviews = new Map;
         this.onRenderFinishedCallback = [];
         this.__rendering__ = false;
+        this.callingRenderFinishedCallback = false;
         this.snapshotEnabled = false;
         this.renderSnapshots = [];
     }
@@ -221,12 +222,17 @@ export class Panel {
         return diryData;
     }
     onRenderFinished() {
+        this.callingRenderFinishedCallback = false;
         this.onRenderFinishedCallback.forEach(e => {
             e();
         });
         this.onRenderFinishedCallback.length = 0;
+        this.callingRenderFinishedCallback = true;
     }
     addOnRenderFinishedCallback(cb) {
+        if (this.callingRenderFinishedCallback) {
+            loge("Do not call addOnRenderFinishedCallback recursively");
+        }
         this.onRenderFinishedCallback.push(cb);
     }
 }

doric-js/lib/src/widget/list.d.ts

@@ -54,8 +54,12 @@ export declare class List extends Superview {
     onDragging?: (from: number, to: number) => void;
     onDragged?: (from: number, to: number) => void;
     preloadItemCount?: number;
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
     scrollToItem(context: BridgeContext, index: number, config?: {
         animated?: boolean;
+        topOffset?: number;
     }): Promise<any>;
     /**
      * @param context

doric-js/lib/src/widget/list.js

@@ -50,9 +50,13 @@ export class List extends Superview {
         }
         return ret;
     }
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
     scrollToItem(context, index, config) {
         const animated = config === null || config === void 0 ? void 0 : config.animated;
-        return this.nativeChannel(context, 'scrollToItem')({ index, animated, });
+        const topOffset = config === null || config === void 0 ? void 0 : config.topOffset;
+        return this.nativeChannel(context, 'scrollToItem')({ index, animated, topOffset });
     }
     /**
      * @param context

doric-js/src/widget/list.ts

@@ -114,9 +114,19 @@ export class List extends Superview {
     @Property
     preloadItemCount?: number
 
-    scrollToItem(context: BridgeContext, index: number, config?: { animated?: boolean, }) {
+    /**
+     * @param {number} config.topOffset - 目标位置cell的顶部偏移量
+     */
+    scrollToItem(context: BridgeContext,
+        index: number,
+        config?: {
+            animated?: boolean,
+            topOffset?: number
+        }) {
         const animated = config?.animated
-        return this.nativeChannel(context, 'scrollToItem')({ index, animated, }) as Promise<any>
+        const topOffset = config?.topOffset;
+
+        return this.nativeChannel(context, 'scrollToItem')({ index, animated, topOffset }) as Promise<any>
     }
     /**
      * @param context