tencent.jquery.pix.component 1.0.88-beta3 → 1.0.90

package/components/banner/banner.js

@@ -18,6 +18,7 @@ let $ = null;
  * @param {function} [options.click] 点击轮播图时触发，第一个参数为触发元素的jq，第二个参数为 options.list 中对应的项，第三个参数为当前页码
  * @param {function} [options.pageChanged] 翻页时触发，第一个参数为新生效页面元素的jq，第二个参数为 options.list 中对应的项，第三个参数为当前页码
  * @param {function} [options.renderCallback] 自定义渲染回调，第一个参数为 options.list 中对应的项，第二个参数为当前页码，返回值为渲染后的元素
+ * @param {boolean} [options.singNoSwitch=false] 当只有单张图片时是否禁用切换功能（隐藏分页和切换），默认为 false 即单图也展示分页和切换
  */
 export function Banner(options = {}) {
     $ = getEnv().$;
@@ -27,6 +28,7 @@ export function Banner(options = {}) {
     this.options.autoResize ??= true;
     this.options.durationMs = Number(options.durationMs || 0) || 0;
     this.options.dragThreshold = Number(options.dragThreshold || 0.2) || 0.2;
+    this.options.singNoSwitch ??= false;
     this.index = Number(options.index || 0) || 0;
     // 用于保存 options.list 中每一项对应的 imgObj（按 list 索引存储），避免依赖 jQuery 的 data 功能
     this.imgObjMap = {};
@@ -57,6 +59,9 @@ Banner.prototype.fitWidth = function () {
  * 跳转到上一页
  */
 Banner.prototype.prevPage = async function () {
+    if (this.options.singNoSwitch && this.options.list.length <= 1) {
+        return;
+    }
     this.pauseAutoPlay();
     await this.gotoPageUnchecked(this.index - 1);
     this.startAutoPlay();
@@ -66,6 +71,9 @@ Banner.prototype.prevPage = async function () {
  * 跳转到下一页
  */
 Banner.prototype.nextPage = async function () {
+    if (this.options.singNoSwitch && this.options.list.length <= 1) {
+        return;
+    }
     this.pauseAutoPlay();
     await this.gotoPageUnchecked(this.index + 1);
     this.startAutoPlay();
@@ -149,6 +157,10 @@ Banner.prototype.init = function () {
 }
 
 Banner.prototype.startAutoPlay = function () {
+    // 单图且 singNoSwitch 为 true 时，不启动自动播放
+    if (this.options.singNoSwitch && this.options.list.length === 1) {
+        return;
+    }
     if (this.options.durationMs > 0 && this.timer == null) {
         this.timer = setInterval(() => {
             this.nextPage()
@@ -173,9 +185,12 @@ Banner.prototype.createHtml = function () {
     $t.empty();
     const signWidth = this.signWidth = $t.width()
 
-    const allWidth = this.allWidth = signWidth * (len + 2)
+    // 单图且 singNoSwitch 为 true 时，不创建循环占位，直接展示单张图片
+    const isSingleNoSwitch = this.options.singNoSwitch && len === 1;
+
+    const allWidth = this.allWidth = isSingleNoSwitch ? signWidth : signWidth * (len + 2)
     const $inner = this.$inner = $(`<div class="banner-inner-transform"></div>`)
-    this.currentTranslate = -signWidth * (this.index + 1)
+    this.currentTranslate = isSingleNoSwitch ? 0 : -signWidth * (this.index + 1)
     $inner.width(allWidth).css('transform', `translateX(${this.currentTranslate}px)`)
 
     // 重置 imgObj 映射表，按 list 的索引保存 imgObj 引用
@@ -186,10 +201,12 @@ Banner.prototype.createHtml = function () {
         }
     }
 
-    // 加第0个位置
-    $inner.append(`<div class="banner-inner-li" data-background-url="${this.options.list[len - 1].url}" style="width:${this.signWidth}px;">
-            </div>
-        `)
+    if (!isSingleNoSwitch) {
+        // 加第0个位置
+        $inner.append(`<div class="banner-inner-li" data-background-url="${this.options.list[len - 1].url}" style="width:${this.signWidth}px;">
+                </div>
+            `)
+    }
     for (let i = 0; i < len; i++) {
         const item = this.options.list[i]
         const $li = $(`<div class="banner-inner-li" data-background-url="${item.url}" style="width:${this.signWidth}px;">
@@ -197,19 +214,23 @@ Banner.prototype.createHtml = function () {
         `)
         $inner.append($li)
     }
-    // 加第N+1
-    $inner.append(`<div class="banner-inner-li" data-background-url="${this.options.list[0].url}" style="width:${this.signWidth}px;">
-            </div>
-        `)
+    if (!isSingleNoSwitch) {
+        // 加第N+1
+        $inner.append(`<div class="banner-inner-li" data-background-url="${this.options.list[0].url}" style="width:${this.signWidth}px;">
+                </div>
+            `)
+    }
 
     const preloadIdx = this.index;
     this.loadBackground(preloadIdx);
-    this.loadBackground((preloadIdx + 1) % len); // prev
-    this.loadBackground((preloadIdx - 1 + len) % len); // next
+    if (!isSingleNoSwitch) {
+        this.loadBackground((preloadIdx + 1) % len); // prev
+        this.loadBackground((preloadIdx - 1 + len) % len); // next
+    }
 
     $t.append($inner)
 
-    if (this.options.isTitleEnabled) {
+    if (this.options.isTitleEnabled && !isSingleNoSwitch) {
         // 创建 titlebox
         const $titleBox = $(`<div class="banner-title-box">${this.options.list[this.index].title}</div>`)
 
@@ -246,24 +267,31 @@ Banner.prototype.createCustomHtml = function () {
     $t.empty();
     const signWidth = this.signWidth = $t.width()
 
-    const allWidth = this.allWidth = signWidth * (len + 2)
+    // 单图且 singNoSwitch 为 true 时，不创建循环占位
+    const isSingleNoSwitch = this.options.singNoSwitch && len === 1;
+
+    const allWidth = this.allWidth = isSingleNoSwitch ? signWidth : signWidth * (len + 2)
     const $inner = this.$inner = $(`<div class="banner-inner-transform"></div>`)
-    this.currentTranslate = -signWidth * (this.index + 1)
+    this.currentTranslate = isSingleNoSwitch ? 0 : -signWidth * (this.index + 1)
     $inner.width(allWidth).css('transform', `translateX(${this.currentTranslate}px)`)
 
-    let $li = $(this.options.renderCallback(this.options.list[len - 1], len - 1));
-    $li.width(signWidth);
-    $inner.append($li);
+    if (!isSingleNoSwitch) {
+        let $li = $(this.options.renderCallback(this.options.list[len - 1], len - 1));
+        $li.width(signWidth);
+        $inner.append($li);
+    }
 
     for (let i = 0; i < len; i++) {
-        $li = $(this.options.renderCallback(this.options.list[i], i));
+        let $li = $(this.options.renderCallback(this.options.list[i], i));
         $li.width(signWidth);
         $inner.append($li);
     }
 
-    $li = $(this.options.renderCallback(this.options.list[0], 0));
-    $li.width(signWidth);
-    $inner.append($li);
+    if (!isSingleNoSwitch) {
+        let $li = $(this.options.renderCallback(this.options.list[0], 0));
+        $li.width(signWidth);
+        $inner.append($li);
+    }
 
     $t.append($inner);
 }
@@ -273,6 +301,19 @@ Banner.prototype.bindEvent = function () {
     const len = this.options.list.length;
     const $inner = this.$inner;
 
+    // 单图且 singNoSwitch 为 true 时，不绑定拖拽和切换事件
+    if (this.options.singNoSwitch && len === 1) {
+        // 仅绑定点击事件
+        $inner.on('click', function (e) {
+            if (!self.options.click) {
+                return
+            }
+            const $t = self.$inner.children().eq(0);
+            self.options.click($t, self.options.list[0], 0);
+        });
+        return;
+    }
+
     // pStart 时的 clientX
     let originalX = 0;
 
@@ -467,8 +508,9 @@ function childIdxToListIdx(childIdx, len) {
 Banner.prototype.loadAllBackgrounds = function () {
     const len = this.options.list.length;
     const imgObjMap = this.imgObjMap || {};
+    const isSingleNoSwitch = this.options.singNoSwitch && len === 1;
     this.$inner.children().each(function (childIdx) {
-        const listIdx = childIdxToListIdx(childIdx, len);
+        const listIdx = isSingleNoSwitch ? childIdx : childIdxToListIdx(childIdx, len);
         applyBackgroundImage($(this), imgObjMap[listIdx]);
     });
     // console.log('banner images loaded');
@@ -481,7 +523,8 @@ Banner.prototype.loadAllBackgrounds = function () {
 Banner.prototype.loadBackground = function (pos) {
     console.log('loadBackground pos === ', pos);
     const imgObjMap = this.imgObjMap || {};
-    let $item = this.$inner.children().eq(pos + 1);
+    const isSingleNoSwitch = this.options.singNoSwitch && this.options.list.length === 1;
+    let $item = this.$inner.children().eq(isSingleNoSwitch ? pos : pos + 1);
     applyBackgroundImage($item, imgObjMap[pos]);
 
     // 加载滚动占位的图片

package/components/waterfallv2/waterfallv2.js

@@ -48,6 +48,7 @@ const DEFAULTS = {
     showLoading: null,  // 展示loading的回调函数 params:$node
     hideLoading: null,  // 隐藏loading的回调函数 
     createLoading: null,  // 创建loading的回调函数
+    useDropDown: false,   // 是否启用下拉刷新功能（会在 touch 设备上启用下拉手势，触发 dropDownCall 回调）
     createDropDown: null, // 创建下拉时展现出来的元素的回调函数 params:$node
     dropDownCall: null,   // 当下拉位置超过50%时触发的有效下拉回调函数
 };
@@ -178,7 +179,6 @@ Waterfallv2.prototype.init = function (optionsMain = null) {
 
 
     // 如果有定义loading函数  那么创建一个loading节点元素
-    console.log('options.createLoading', options.createLoading)
     if (options.createLoading) {
         this.$loadingNode = $(
             `<div class="waterfallv2-loading" style="position:absolute;top:0;left:0;width:100%;transform: translate(0px, -99999px)"></div>`
@@ -201,222 +201,223 @@ Waterfallv2.prototype.init = function (optionsMain = null) {
         }
     });
 
-    const $child = $container.children();
-    // 给child容器绑定一个下拉事件
-    // 仅当 $scrollDom.scrollTop() === 0 时，才会跟随手指下拉产生 translateY 位移
-    // 松手后以过渡动画自然恢复到 translateY(0)
-    let pullStartY = 0;         // 触摸起始位置
-    let pullCurrentY = 0;       // 当前位移
-    let isPulling = false;      // 是否处于下拉中
-    let pullReachThreshold = false; // 本次下拉是否已达到有效阈值（超过50%）
-    const PULL_DAMPING = 0.7;   // 下拉阻尼系数（手指滑动距离 * 系数 = 实际位移），产生橡皮筋效果
-    const PULL_DEFAULT_HEIGHT = 200; // 下拉元素默认高度（当 $dropDownNode 不存在或高度为 0 时的兜底值）
-    const PULL_RESET_DURATION = 300; // 松手回弹动画时长（ms）
-    // 以下 3 个变量会在每次 touchstart 时基于 $dropDownNode 的实际高度动态计算：
-    let pullMax = PULL_DEFAULT_HEIGHT * 1.5;          // 下拉最大位移（px）
-    let pullThreshold = PULL_DEFAULT_HEIGHT;        // 有效下拉阈值（超过此距离则视为一次有效下拉）
-    let pullHoldOffset = PULL_DEFAULT_HEIGHT;       // 触发有效下拉后，松手悬停保持的位移量（保持下拉元素可见）
-
-    // 下拉保持状态标志（挂在实例上，方便 hideDropDown 等原型方法访问）
-    this.isPullHolding = false;
+    if(options.useDropDown) {
+        const $child = $container.children();
+        // 给child容器绑定一个下拉事件
+        // 仅当 $scrollDom.scrollTop() === 0 时，才会跟随手指下拉产生 translateY 位移
+        // 松手后以过渡动画自然恢复到 translateY(0)
+        let pullStartY = 0;         // 触摸起始位置
+        let pullCurrentY = 0;       // 当前位移
+        let isPulling = false;      // 是否处于下拉中
+        let pullReachThreshold = false; // 本次下拉是否已达到有效阈值（超过50%）
+        const PULL_DAMPING = 0.7;   // 下拉阻尼系数（手指滑动距离 * 系数 = 实际位移），产生橡皮筋效果
+        const PULL_DEFAULT_HEIGHT = 200; // 下拉元素默认高度（当 $dropDownNode 不存在或高度为 0 时的兜底值）
+        const PULL_RESET_DURATION = 300; // 松手回弹动画时长（ms）
+        // 以下 3 个变量会在每次 touchstart 时基于 $dropDownNode 的实际高度动态计算：
+        let pullMax = PULL_DEFAULT_HEIGHT * 1.5;          // 下拉最大位移（px）
+        let pullThreshold = PULL_DEFAULT_HEIGHT;        // 有效下拉阈值（超过此距离则视为一次有效下拉）
+        let pullHoldOffset = PULL_DEFAULT_HEIGHT;       // 触发有效下拉后，松手悬停保持的位移量（保持下拉元素可见）
+
+        // 下拉保持状态标志（挂在实例上，方便 hideDropDown 等原型方法访问）
+        this.isPullHolding = false;
 
-    // 根据 $dropDownNode 的实际高度动态计算下拉相关的 3 个关键位移值
-    // 每次触摸开始时调用，保证拿到最新高度（适应运行时 $dropDownNode 内容变化）
-    const recalcPullMetrics = function () {
-        let dropH = 0;
-        if (self.$dropDownNode && self.$dropDownNode.length) {
-            dropH = self.$dropDownNode.height() || 0;
-        }
-        if (dropH <= 0) {
-            dropH = PULL_DEFAULT_HEIGHT;
-        }
-        pullThreshold = dropH;          // 下拉超过 dropDown 完整高度即视为有效
-        pullHoldOffset = dropH;         // 保持位置刚好让 dropDown 完全可见
-        pullMax = dropH * 1.5;            // 下拉最大位移为 1.5 倍高度，提供橡皮筋余量
-    };
-
-    const pullDomNode = $child.get(0);
-    console.log('pullDomNode',pullDomNode);
-
-    // 通用的 clientY 提取函数：同时兼容触摸事件和鼠标事件
-    // - 触摸事件：从 e.touches[0] 或 e.originalEvent.touches[0] 读取
-    // - 鼠标事件：直接从 e.clientY 读取
-    const getClientY = function (e) {
-        if (e.touches && e.touches.length) return e.touches[0].clientY;
-        if (e.originalEvent && e.originalEvent.touches && e.originalEvent.touches.length) {
-            return e.originalEvent.touches[0].clientY;
+        // 根据 $dropDownNode 的实际高度动态计算下拉相关的 3 个关键位移值
+        // 每次触摸开始时调用，保证拿到最新高度（适应运行时 $dropDownNode 内容变化）
+        const recalcPullMetrics = function () {
+            let dropH = 0;
+            if (self.$dropDownNode && self.$dropDownNode.length) {
+                dropH = self.$dropDownNode.height() || 0;
+            }
+            if (dropH <= 0) {
+                dropH = PULL_DEFAULT_HEIGHT;
+            }
+            pullThreshold = dropH;          // 下拉超过 dropDown 完整高度即视为有效
+            pullHoldOffset = dropH;         // 保持位置刚好让 dropDown 完全可见
+            pullMax = dropH * 1.5;            // 下拉最大位移为 1.5 倍高度，提供橡皮筋余量
+        };
+
+        const pullDomNode = $child.get(0);
+
+        // 通用的 clientY 提取函数：同时兼容触摸事件和鼠标事件
+        // - 触摸事件：从 e.touches[0] 或 e.originalEvent.touches[0] 读取
+        // - 鼠标事件：直接从 e.clientY 读取
+        const getClientY = function (e) {
+            if (e.touches && e.touches.length) return e.touches[0].clientY;
+            if (e.originalEvent && e.originalEvent.touches && e.originalEvent.touches.length) {
+                return e.originalEvent.touches[0].clientY;
+            }
+            if (typeof e.clientY === 'number') return e.clientY;
+            return null;
+        };
+
+        // 创建下拉时展现出来的元素（类似 loading 节点的机制）
+        // 节点放置在 $child 内部最顶部，通过 top: -Hpx 自身负偏移隐藏在列表可视区之上；
+        // 当 $child 执行 translateY(offset) 向下位移时，该元素会跟随一起下移并自然露出。
+        this.$dropDownNode = null;
+        if (options.createDropDown && options.createDropDown.constructor === Function) {
+            this.$dropDownNode = $(
+                `<div class="waterfallv2-dropdown" style="position:absolute;left:0;right:0;bottom:100%;width:100%;"></div>`
+            );
+            // 插入到 $child 的最前面，使其定位参考 $child（$child 为定位上下文时最佳；
+            // 若 $child 不是定位元素，也可使用 bottom:100% 让其处于 $child 上方）
+            $child.css('position', $child.css('position') === 'static' ? 'relative' : $child.css('position'));
+            $child.prepend(this.$dropDownNode);
+            options.createDropDown(this.$dropDownNode);
         }
-        if (typeof e.clientY === 'number') return e.clientY;
-        return null;
-    };
-
-    // 创建下拉时展现出来的元素（类似 loading 节点的机制）
-    // 节点放置在 $child 内部最顶部，通过 top: -Hpx 自身负偏移隐藏在列表可视区之上；
-    // 当 $child 执行 translateY(offset) 向下位移时，该元素会跟随一起下移并自然露出。
-    this.$dropDownNode = null;
-    if (options.createDropDown && options.createDropDown.constructor === Function) {
-        this.$dropDownNode = $(
-            `<div class="waterfallv2-dropdown" style="position:absolute;left:0;right:0;bottom:100%;width:100%;"></div>`
-        );
-        // 插入到 $child 的最前面，使其定位参考 $child（$child 为定位上下文时最佳；
-        // 若 $child 不是定位元素，也可使用 bottom:100% 让其处于 $child 上方）
-        $child.css('position', $child.css('position') === 'static' ? 'relative' : $child.css('position'));
-        $child.prepend(this.$dropDownNode);
-        options.createDropDown(this.$dropDownNode);
-    }
 
-    const onTouchStart = function (e) {
-        // 若处于下拉保持状态（等待开发者手动收回），则忽略新的下拉手势
-        if (self.isPullHolding) {
-            isPulling = false;
-            return;
-        }
-        // 仅当滚动容器已在顶部时才进入下拉模式
-        if ($scrollDom.scrollTop() !== 0) {
-            isPulling = false;
-            return;
-        }
-        const clientY = getClientY(e);
-        if (clientY === null) return;
-        // 在每次下拉开始时动态获取 $dropDownNode 的实际高度，重新计算下拉关键位移值
-        recalcPullMetrics();
-        pullStartY = clientY;
-        pullCurrentY = 0;
-        isPulling = true;
-        // 移除过渡，确保跟手
-        $child.css('transition', 'none');
-    };
-
-    const onTouchMove = function (e) {
-        if (!isPulling) return;
-        const clientY = getClientY(e);
-        if (clientY === null) return;
-
-        const dy = clientY - pullStartY;
-   
-        // 仅响应下拉方向
-        if (dy <= 0) {
+        const onTouchStart = function (e) {
+            // 若处于下拉保持状态（等待开发者手动收回），则忽略新的下拉手势
+            if (self.isPullHolding) {
+                isPulling = false;
+                return;
+            }
+            // 仅当滚动容器已在顶部时才进入下拉模式
+            if ($scrollDom.scrollTop() !== 0) {
+                isPulling = false;
+                return;
+            }
+            const clientY = getClientY(e);
+            if (clientY === null) return;
+            // 在每次下拉开始时动态获取 $dropDownNode 的实际高度，重新计算下拉关键位移值
+            recalcPullMetrics();
+            pullStartY = clientY;
             pullCurrentY = 0;
-            $child.css('transform', 'translateY(0px)');
-            return;
-        }
+            isPulling = true;
+            // 移除过渡，确保跟手
+            $child.css('transition', 'none');
+        };
 
-        // 若在下拉过程中滚动位置不为 0（例如系统反弹），则中断下拉
-        if ($scrollDom.scrollTop() > 0) {
-            return;
-        }
+        const onTouchMove = function (e) {
+            if (!isPulling) return;
+            const clientY = getClientY(e);
+            if (clientY === null) return;
 
-        // 阻尼衰减 + 最大位移限制
-        let offset = dy * PULL_DAMPING;
+            const dy = clientY - pullStartY;
     
-        if (offset > pullMax) offset = pullMax;
-        pullCurrentY = offset;
+            // 仅响应下拉方向
+            if (dy <= 0) {
+                pullCurrentY = 0;
+                $child.css('transform', 'translateY(0px)');
+                return;
+            }
 
-        // 判断是否达到有效下拉阈值（只要过程中曾经超过阈值即视为达到）
+            // 若在下拉过程中滚动位置不为 0（例如系统反弹），则中断下拉
+            if ($scrollDom.scrollTop() > 0) {
+                return;
+            }
 
-        if (offset >= pullThreshold) {
+            // 阻尼衰减 + 最大位移限制
+            let offset = dy * PULL_DAMPING;
         
-            pullReachThreshold = true;
-        }
+            if (offset > pullMax) offset = pullMax;
+            pullCurrentY = offset;
 
-        // 在模拟器下 下拉元素还有个默认下滑，这里相对再减去一点值
-        $child.css('transform', 'translateY(' + offset * 0.8 + 'px)');
+            // 判断是否达到有效下拉阈值（只要过程中曾经超过阈值即视为达到）
 
-        // 处于下拉偏移过程中，阻止原生滚动与橡皮筋效果
-        if (e.cancelable) {
-            if(e.preventDefault) e.preventDefault();
-        }
-    };
+            if (offset >= pullThreshold) {
+            
+                pullReachThreshold = true;
+            }
 
-    const onTouchEnd = function () {
-        if (!isPulling) return;
-        isPulling = false;
+            // 在模拟器下 下拉元素还有个默认下滑，这里相对再减去一点值
+            $child.css('transform', 'translateY(' + offset * 0.8 + 'px)');
 
-        // 本次是否达到有效阈值
-        const reached = pullReachThreshold;
-        pullReachThreshold = false;
+            // 处于下拉偏移过程中，阻止原生滚动与橡皮筋效果
+            if (e.cancelable) {
+                if(e.preventDefault) e.preventDefault();
+            }
+        };
 
-        if (reached) {
-            // === 有效下拉：悬停保持，等待开发者手动调用 hideDropDown() 收回 ===
-            // 悬停保持位移：使用 touchstart 时动态计算出的 pullHoldOffset（基于 $dropDownNode 实际高度）
-            const holdOffset = pullHoldOffset;
+        const onTouchEnd = function () {
+            if (!isPulling) return;
+            isPulling = false;
 
-            // 标记进入保持状态
-            self.isPullHolding = true;
+            // 本次是否达到有效阈值
+            const reached = pullReachThreshold;
+            pullReachThreshold = false;
+
+            if (reached) {
+                // === 有效下拉：悬停保持，等待开发者手动调用 hideDropDown() 收回 ===
+                // 悬停保持位移：使用 touchstart 时动态计算出的 pullHoldOffset（基于 $dropDownNode 实际高度）
+                const holdOffset = pullHoldOffset;
+
+                // 标记进入保持状态
+                self.isPullHolding = true;
+
+                // 以过渡动画平滑过渡到保持位置
+                $child.css('transition', 'transform ' + PULL_RESET_DURATION + 'ms ease-out');
+                $child.css('transform', 'translateY(' + holdOffset + 'px)');
+
+                // 动画结束后清理 transition
+                setTimeout(function () {
+                    $child.css('transition', '');
+                    pullCurrentY = holdOffset;
+                }, PULL_RESET_DURATION);
+
+                // 触发 dropDownCall 回调（在进入保持状态后回调，便于开发者在回调内部发起请求，
+                // 完成后调用 self.hideDropDown() 收回下拉）
+                if (options.dropDownCall && options.dropDownCall.constructor === Function) {
+                    try {
+                        options.dropDownCall(self.$dropDownNode);
+                    } catch (err) {
+                        console.error('Waterfallv2: dropDownCall error', err);
+                    }
+                }
+                return;
+            }
 
-            // 以过渡动画平滑过渡到保持位置
+            // === 未达到阈值：按原逻辑自然回弹到 0 ===
             $child.css('transition', 'transform ' + PULL_RESET_DURATION + 'ms ease-out');
-            $child.css('transform', 'translateY(' + holdOffset + 'px)');
+            $child.css('transform', 'translateY(0px)');
 
-            // 动画结束后清理 transition
+            // 动画结束后清理 transition，避免影响后续其他 transform 修改
             setTimeout(function () {
                 $child.css('transition', '');
-                pullCurrentY = holdOffset;
+                pullCurrentY = 0;
             }, PULL_RESET_DURATION);
-
-            // 触发 dropDownCall 回调（在进入保持状态后回调，便于开发者在回调内部发起请求，
-            // 完成后调用 self.hideDropDown() 收回下拉）
-            if (options.dropDownCall && options.dropDownCall.constructor === Function) {
-                try {
-                    options.dropDownCall(self.$dropDownNode);
-                } catch (err) {
-                    console.error('Waterfallv2: dropDownCall error', err);
-                }
-            }
-            return;
-        }
-
-        // === 未达到阈值：按原逻辑自然回弹到 0 ===
-        $child.css('transition', 'transform ' + PULL_RESET_DURATION + 'ms ease-out');
-        $child.css('transform', 'translateY(0px)');
-
-        // 动画结束后清理 transition，避免影响后续其他 transform 修改
-        setTimeout(function () {
-            $child.css('transition', '');
-            pullCurrentY = 0;
-        }, PULL_RESET_DURATION);
-    };
-
-    // 桌面端鼠标事件支持：按照触摸事件的同样规律实现鼠标拖拽下拉
-    // mousedown / mousemove / mouseup 均绑定在 pullDomNode 上
-    // 由于鼠标可能拖出 pullDomNode 边界，额外绑定 mouseleave 作为兼底中断（视同松手）
-    const onMouseMove = function (e) {
-        onTouchMove(e);
-    };
-    const onMouseUp = function (e) {
-        onTouchEnd(e);
-    };
-    const onMouseLeave = function (e) {
-        // 拖拽过程中移出 pullDomNode 时视为松手，触发回弹或保持逻辑
-        if (isPulling) {
+        };
+
+        // 桌面端鼠标事件支持：按照触摸事件的同样规律实现鼠标拖拽下拉
+        // mousedown / mousemove / mouseup 均绑定在 pullDomNode 上
+        // 由于鼠标可能拖出 pullDomNode 边界，额外绑定 mouseleave 作为兼底中断（视同松手）
+        const onMouseMove = function (e) {
+            onTouchMove(e);
+        };
+        const onMouseUp = function (e) {
             onTouchEnd(e);
+        };
+        const onMouseLeave = function (e) {
+            // 拖拽过程中移出 pullDomNode 时视为松手，触发回弹或保持逻辑
+            if (isPulling) {
+                onTouchEnd(e);
+            }
+        };
+        const onMouseDown = function (e) {
+            onTouchStart(e);
+        };
+        // 小应用环境只支持mousedown的鼠标点击类型事件,不支持touch事件
+        if (pullDomNode) {
+            pullDomNode.addEventListener('mousedown', onMouseDown);
+            pullDomNode.addEventListener('mousemove', onMouseMove);
+            pullDomNode.addEventListener('mouseup', onMouseUp);
+            pullDomNode.addEventListener('mouseleave', onMouseLeave);
         }
-    };
-    const onMouseDown = function (e) {
-        onTouchStart(e);
-    };
-    // 小应用环境只支持mousedown的鼠标点击类型事件,不支持touch事件
-    if (pullDomNode) {
-        pullDomNode.addEventListener('mousedown', onMouseDown);
-        pullDomNode.addEventListener('mousemove', onMouseMove);
-        pullDomNode.addEventListener('mouseup', onMouseUp);
-        pullDomNode.addEventListener('mouseleave', onMouseLeave);
-    }
-
-    // 保存引用，便于 destroy 时解绑；同时供 hideDropDown 原型方法使用
-    this._pullHandlers = {
-        $child: $child,
-        node: pullDomNode,
-        onTouchStart: onTouchStart,
-        onTouchMove: onTouchMove,
-        onTouchEnd: onTouchEnd,
-        onMouseDown: onMouseDown,
-        onMouseMove: onMouseMove,
-        onMouseUp: onMouseUp,
-        onMouseLeave: onMouseLeave,
-        resetDuration: PULL_RESET_DURATION,
-    };
 
+        // 保存引用，便于 destroy 时解绑；同时供 hideDropDown 原型方法使用
+        this._pullHandlers = {
+            $child: $child,
+            node: pullDomNode,
+            onTouchStart: onTouchStart,
+            onTouchMove: onTouchMove,
+            onTouchEnd: onTouchEnd,
+            onMouseDown: onMouseDown,
+            onMouseMove: onMouseMove,
+            onMouseUp: onMouseUp,
+            onMouseLeave: onMouseLeave,
+            resetDuration: PULL_RESET_DURATION,
+        };
+    }
+    
     this.scrollTop = $scrollDom.scrollTop();  // 当前滚动位置
 
     // 首次渲染

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencent.jquery.pix.component",
-  "version": "1.0.88-beta3",
+  "version": "1.0.90",
   "description": "",
   "main": "index.js",
   "files": [