@tuya-miniapp/smart-ui 2.13.4 → 2.13.5-beta-0

package/README-zh_CN.md

@@ -1,3 +1,10 @@
+<!--
+ * @Author: mjh
+ * @Date: 2026-04-01 14:55:38
+ * @LastEditors: mjh
+ * @LastEditTime: 2026-08-24 11:44:37
+ * @Description: 
+-->
 [English](./README.md) | 简体中文
 
 # @tuya-miniapp/smart-ui
@@ -78,6 +85,7 @@ yarn dev
 
 > 本项目遵从 [Angular Style Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153)
 
+
 [官网更新日志](https://developer.tuya.com/material/smartui?comId=help-changelog&appType=miniapp)  
 
 ## 开源协议

package/dist/picker/index.js

@@ -1,5 +1,10 @@
 import { SmartComponent } from '../common/component';
 import { pickerProps } from './shared';
+// 超过该数量且非 loop 的列启用「窗口化」：只把当前位置附近的一段数据交给子 picker-column，
+// 其余保存在逻辑层实例属性中，滚动停稳后再回中，避免把超长数组整份 setData 到渲染层 / 子组件。
+const WINDOW_THRESHOLD = 2000;
+const WINDOW_SIZE = 1000;
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
 SmartComponent({
     classes: ['hairline-class', 'active-class', 'toolbar-class', 'column-class'],
     props: Object.assign(Object.assign({}, pickerProps), { valueKey: {
@@ -16,6 +21,12 @@ SmartComponent({
             value: 0,
         }, activeIndex: {
             type: null,
+            observer() {
+                // 受控模式下 activeIndex（全局）变化时，若存在窗口化列需以新位置重建窗口
+                if (this._hasWindow) {
+                    this.buildRenderColumns();
+                }
+            },
         }, unit: {
             type: String,
             value: '',
@@ -24,6 +35,7 @@ SmartComponent({
             value: [],
             observer(columns = []) {
                 this.simple = columns.length && !columns[0].values;
+                this.buildRenderColumns();
                 if (Array.isArray(this.children) && this.children.length) {
                     this.setColumns().catch(() => { });
                 }
@@ -31,8 +43,14 @@ SmartComponent({
         } }),
     data: {
         animating: false,
+        // 交给渲染层 / 子组件的列数据（窗口化列在此仅为切片，非窗口化列为完整数据）
+        renderColumns: [],
     },
     beforeCreate() {
+        // 每列的窗口状态：{ windowed, start, size, full }，保存在逻辑层，不进入 data
+        this._windows = [];
+        this._hasWindow = false;
+        this._repositioning = false;
         Object.defineProperty(this, 'children', {
             get: () => this.selectAllComponents('.smart-picker__column') || [],
         });
@@ -44,10 +62,103 @@ SmartComponent({
     },
     methods: {
         noop() { },
+        // 归一化列数据：simple 模式（columns 为一维数组）包一层
+        normalizedColumns() {
+            const { columns } = this.data;
+            if (this.simple) {
+                return [{ values: columns }];
+            }
+            return Array.isArray(columns) ? columns : [];
+        },
+        // 解析某列的初始全局下标（优先 activeIndex，其次 defaultIndex）
+        resolveInitialIndex(column) {
+            const { defaultIndex, activeIndex } = this.data;
+            const columnActive = column.activeIndex === null || column.activeIndex === undefined
+                ? activeIndex
+                : column.activeIndex;
+            let index;
+            if (columnActive !== null && columnActive !== undefined) {
+                index = columnActive;
+            }
+            else if (column.defaultIndex !== undefined) {
+                index = column.defaultIndex;
+            }
+            else {
+                index = defaultIndex;
+            }
+            const { length } = column.values || [];
+            return clamp(index || 0, 0, Math.max(0, length - 1));
+        },
+        // 判断某列是否需要窗口化
+        shouldWindow(column) {
+            return (!this.data.loop &&
+                !column.loop &&
+                Array.isArray(column.values) &&
+                column.values.length > WINDOW_THRESHOLD);
+        },
+        // 基于当前 columns 计算 renderColumns 与每列窗口状态
+        buildRenderColumns() {
+            const columns = this.normalizedColumns();
+            const windows = [];
+            let hasWindow = false;
+            const renderColumns = columns.map((column) => {
+                const values = column.values || [];
+                if (!this.shouldWindow(column)) {
+                    windows.push({ windowed: false, start: 0, size: values.length, full: values });
+                    return column;
+                }
+                hasWindow = true;
+                const globalIndex = this.resolveInitialIndex(column);
+                const size = WINDOW_SIZE;
+                const start = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, values.length - size));
+                const localIndex = globalIndex - start;
+                windows.push({ windowed: true, start, size, full: values });
+                return Object.assign(Object.assign({}, column), { values: values.slice(start, start + size), defaultIndex: localIndex, activeIndex: localIndex, _windowed: true });
+            });
+            this._windows = windows;
+            this._hasWindow = hasWindow;
+            this.setData({ renderColumns });
+        },
+        // 将窗口化列停稳后回中：使当前项回到窗口中心，纯坐标平移，静止态无感
+        recenterColumn(columnIndex) {
+            const win = this._windows[columnIndex];
+            if (!win || !win.windowed || this._repositioning)
+                return;
+            const column = this.getColumn(columnIndex);
+            if (!column)
+                return;
+            const localIndex = column.data.currentIndex;
+            const globalIndex = win.start + localIndex;
+            const { size } = win;
+            const newStart = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, win.full.length - size));
+            if (newStart === win.start)
+                return;
+            this._repositioning = true;
+            win.start = newStart;
+            const newLocal = globalIndex - newStart;
+            // 同一次 setData 内同时更新切片与 active-index（局部），子组件原子接收，
+            // 配合 wxs 对大跳变强制 transition:none，实现无动画的静默回中
+            this.setData({
+                [`renderColumns[${columnIndex}].values`]: win.full.slice(newStart, newStart + size),
+                [`renderColumns[${columnIndex}].activeIndex`]: newLocal,
+            }, () => {
+                this._repositioning = false;
+            });
+        },
+        // 局部下标 -> 全局下标
+        toGlobalIndex(columnIndex, localIndex) {
+            const win = this._windows[columnIndex];
+            return win && win.windowed ? win.start + localIndex : localIndex;
+        },
         setColumns() {
-            const { data } = this;
-            const columns = this.simple ? [{ values: data.columns }] : data.columns;
-            const stack = columns.map((column, index) => this.setColumnValues(index, column.values));
+            const columns = this.normalizedColumns();
+            const stack = columns.map((column, index) => {
+                // 窗口化列由 renderColumns（wxml）响应式驱动，不走命令式全量下发
+                if (this._windows[index] && this._windows[index].windowed) {
+                    return Promise.resolve();
+                }
+                return this.setColumnValues(index, column.values);
+            });
             return Promise.all(stack);
         },
         emit(event) {
@@ -66,6 +177,7 @@ SmartComponent({
             }
         },
         onChange(event) {
+            const columnIndex = this.simple ? 0 : event.currentTarget.dataset.index;
             if (this.simple) {
                 this.$emit('change', {
                     picker: this,
@@ -80,6 +192,8 @@ SmartComponent({
                     index: event.currentTarget.dataset.index,
                 });
             }
+            // 停稳后再回中，保证切换发生在静止态
+            this.recenterColumn(columnIndex);
         },
         // get column instance by index
         getColumn(index) {
@@ -92,6 +206,19 @@ SmartComponent({
         },
         // set column value by index
         setColumnValue(index, value) {
+            const win = this._windows[index];
+            if (win && win.windowed) {
+                // 窗口化列：在完整数据中按 valueKey 查找全局下标后跳转
+                const { valueKey } = this.data;
+                for (let i = 0; i < win.full.length; i++) {
+                    const option = win.full[i];
+                    const text = option && typeof option === 'object' && valueKey in option ? option[valueKey] : option;
+                    if (text === value) {
+                        return this.setColumnIndex(index, i);
+                    }
+                }
+                return Promise.resolve();
+            }
             const column = this.getColumn(index);
             if (column == null) {
                 return Promise.reject(new Error('setColumnValue: The corresponding column does not exist'));
@@ -100,10 +227,27 @@ SmartComponent({
         },
         // get column option index by column index
         getColumnIndex(columnIndex) {
-            return (this.getColumn(columnIndex) || {}).data.currentIndex;
+            var _a, _b;
+            const local = (_b = (_a = (this.getColumn(columnIndex) || {}).data) === null || _a === void 0 ? void 0 : _a.currentIndex) !== null && _b !== void 0 ? _b : 0;
+            return this.toGlobalIndex(columnIndex, local);
         },
         // set column option index by column index
         setColumnIndex(columnIndex, optionIndex) {
+            const win = this._windows[columnIndex];
+            if (win && win.windowed) {
+                // 以目标全局下标为中心重建窗口，子组件通过 active-index 定位
+                const { size } = win;
+                const globalIndex = clamp(optionIndex, 0, Math.max(0, win.full.length - 1));
+                const newStart = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, win.full.length - size));
+                win.start = newStart;
+                this._repositioning = true;
+                return this.set({
+                    [`renderColumns[${columnIndex}].values`]: win.full.slice(newStart, newStart + size),
+                    [`renderColumns[${columnIndex}].activeIndex`]: globalIndex - newStart,
+                }).then(() => {
+                    this._repositioning = false;
+                });
+            }
             const column = this.getColumn(columnIndex);
             if (column == null) {
                 return Promise.reject(new Error('setColumnIndex: The corresponding column does not exist'));
@@ -112,15 +256,37 @@ SmartComponent({
         },
         // get options of column by index
         getColumnValues(index) {
+            const win = this._windows[index];
+            if (win && win.windowed) {
+                return win.full;
+            }
             return (this.children[index] || {}).data.options;
         },
         // set options of column by index
         setColumnValues(index, options, needReset = true) {
+            const win = this._windows[index];
+            if (win && win.windowed) {
+                // 替换完整数据并以头部为中心重建窗口
+                win.full = options || [];
+                const { size } = win;
+                const start = needReset ? 0 : clamp(win.start, 0, Math.max(0, win.full.length - size));
+                win.start = start;
+                this._repositioning = true;
+                return this.set({
+                    [`renderColumns[${index}].values`]: win.full.slice(start, start + size),
+                    [`renderColumns[${index}].activeIndex`]: 0,
+                }).then(() => {
+                    this._repositioning = false;
+                });
+            }
             const column = this.children[index];
             if (column == null) {
                 return Promise.reject(new Error('setColumnValues: The corresponding column does not exist'));
             }
-            const isSame = JSON.stringify(column.data.options) === JSON.stringify(options);
+            const prevOptions = column.data.options || [];
+            // 先比长度（O(1)）短路：长度不同必然不同，避免对超长数组做两次 JSON.stringify
+            const isSame = prevOptions.length === options.length &&
+                JSON.stringify(prevOptions) === JSON.stringify(options);
             if (isSame) {
                 return Promise.resolve();
             }
@@ -141,7 +307,7 @@ SmartComponent({
         },
         // get indexes of all columns
         getIndexes() {
-            return this.children.map(child => child.data.currentIndex);
+            return this.children.map((child, index) => this.toGlobalIndex(index, child.data.currentIndex));
         },
         // set indexes of all columns
         setIndexes(indexes) {

package/dist/picker/index.wxml

@@ -14,7 +14,7 @@
   >
     <picker-column
       class="smart-picker__column"
-      wx:for="{{ computed.columns(columns) }}"
+      wx:for="{{ renderColumns }}"
       wx:key="index"
       data-index="{{ index }}"
       animation-time="{{ animationTime }}"
@@ -24,6 +24,7 @@
       active-style="{{ activeStyle }}"
       font-style="{{fontStyle ? fontStyle + ';' + computed.style(item.fontStyle): computed.style(item.fontStyle)}}"
       options="{{ item.values }}"
+      windowed="{{ item._windowed || false }}"
       disabled="{{ item.disabled || false }}"
       unit="{{ item.unit || unit }}"
       unit-gap="{{ item.unitGap }}"

package/dist/picker-column/index.js

@@ -16,6 +16,11 @@ SmartComponent({
         className: String,
         itemHeight: Number,
         disabled: Boolean,
+        // 是否为父级窗口化列：为 true 时对大幅度的 active-index 跳变强制关闭过渡（用于停稳回中的静默重定位）
+        windowed: {
+            type: Boolean,
+            value: false,
+        },
         visibleItemCount: Number,
         activeStyle: {
             type: String,
@@ -28,7 +33,12 @@ SmartComponent({
                 if (!this.data.isInit)
                     return;
                 this.updateUint(value);
-                this.updateCurrentIndex(this.data.currentIndex);
+                // 窗口化列：切片与 activeIndex（局部）在同一批 setData 到达，
+                // 此处直接采用新的 activeIndex，使「新切片 + 新下标」原子落地，避免差一帧的错位闪烁
+                const nextIndex = this.data.windowed && this.data.activeIndex !== null && this.data.activeIndex !== undefined
+                    ? this.data.activeIndex
+                    : this.data.currentIndex;
+                this.updateCurrentIndex(nextIndex);
                 this.updateVisibleOptions();
             },
         },

package/dist/picker-column/index.wxml

@@ -8,15 +8,15 @@
   id="{{instanceId}}"
   data-isdestroy="{{isDestroy}}"
   data-changeanimation="{{changeAnimation}}"
-  data-options="{{options}}"
   data-valuekey="{{valueKey}}"
   data-itemheight="{{itemHeight}}"
   data-visibleitemcount="{{visibleItemCount}}"
   data-activeindex="{{currentIndex}}"
   data-loop="{{loop && options.length > 1}}"
   data-animationtime="{{animationTime}}"
+  data-windowed="{{windowed}}"
   isdestroy="{{isDestroy}}"
-  options="{{options}}" 
+  options="{{options}}"
   activeindex="{{currentIndex}}"
   changeanimation="{{changeAnimation}}"
   loop="{{loop && options.length > 1}}"
@@ -24,15 +24,17 @@
   itemheight="{{itemHeight}}"
   visibleitemcount="{{visibleItemCount}}"
   animationtime="{{animationTime}}"
+  windowed="{{windowed}}"
   change:isdestroy="{{computed.updateValue(instanceId, 'isDestroy')}}"
-  change:options="{{computed.updateValue(instanceId, 'options')}}" 
-  change:valuekey="{{computed.updateValue(instanceId,'valueKey')}}" 
-  change:itemheight="{{computed.updateValue(instanceId,'itemHeight')}}" 
-  change:visibleitemcount="{{computed.updateValue(instanceId, 'visibleItemCount')}}" 
-  change:activeindex="{{computed.updateValue(instanceId,'activeIndex')}}" 
-  change:loop="{{computed.updateValue(instanceId,'loop')}}" 
-  change:animationtime="{{computed.updateValue(instanceId,'animationTime')}}" 
-  change:instanceid="{{computed.updateValue(instanceId,'instanceId')}}" 
+  change:options="{{computed.updateValue(instanceId, 'options')}}"
+  change:valuekey="{{computed.updateValue(instanceId,'valueKey')}}"
+  change:itemheight="{{computed.updateValue(instanceId,'itemHeight')}}"
+  change:visibleitemcount="{{computed.updateValue(instanceId, 'visibleItemCount')}}"
+  change:activeindex="{{computed.updateValue(instanceId,'activeIndex')}}"
+  change:loop="{{computed.updateValue(instanceId,'loop')}}"
+  change:animationtime="{{computed.updateValue(instanceId,'animationTime')}}"
+  change:windowed="{{computed.updateValue(instanceId,'windowed')}}"
+  change:instanceid="{{computed.updateValue(instanceId,'instanceId')}}"
   bind:touchstart="{{computed.touchStart(instanceId)}}"
   catch:touchmove="{{computed.touchMove(instanceId)}}"
   bind:touchend="{{computed.touchEnd(instanceId)}}"

package/dist/picker-column/index.wxs

@@ -226,7 +226,8 @@ function getDomState(ownerInstance) {
 
 function initDomState(instanceId, ownerInstance) {
   var state = getDomState(ownerInstance);
-  updateState(instanceId, 'options', state.options)
+  // options 不再通过 data-options 传入（避免把全量数组塞进 dataset / getDataset），
+  // 由 change:options -> updateValue('options', ...) 单独维护 state.options
   updateState(instanceId, 'valueKey', state.valuekey)
   updateState(instanceId, 'itemHeight', state.itemheight)
   updateState(instanceId, 'visibleItemCount', state.visibleitemcount)
@@ -234,6 +235,7 @@ function initDomState(instanceId, ownerInstance) {
   updateState(instanceId, 'loop', state.loop)
   updateState(instanceId, 'animationTime', state.animationtime)
   updateState(instanceId, 'changeAnimation', state.changeanimation)
+  updateState(instanceId, 'windowed', state.windowed)
 }
 
 
@@ -262,10 +264,14 @@ function updateListView(instanceId, ownerInstance) {
   var animationIndex = state.animationIndex || 0;
   var newAnimationIndex = getNewAnimationIndex(animationIndex, activeIndex, length, state.loop);
   var isSame = newAnimationIndex === animationIndex;
+  // 窗口化列的「停稳回中/重定位」会产生大幅度的 activeIndex 跳变，此时强制关闭过渡：
+  // 因为切片内容与位置是同步平移的，直接吸附即像素级一致，避免整轮旋转动画造成抖动。
+  var vOptionLength = state.visibleItemCount * 4 - 2;
+  var isWindowReposition = state.windowed && Math.abs(newAnimationIndex - animationIndex) > vOptionLength;
   updateState(instanceId, 'animationIndex', newAnimationIndex)
   updateVisibleOptions(state.animationIndex, instanceId);
   updateWrapperStyle(instanceId, ownerInstance, {
-    transition: (!state.changeAnimation || isSame) ? 'none' : 'transform ' + state.animationTime + 'ms cubic-bezier(0.2, 0.9, 0.25, 1)'
+    transition: (!state.changeAnimation || isSame || isWindowReposition) ? 'none' : 'transform ' + state.animationTime + 'ms cubic-bezier(0.2, 0.9, 0.25, 1)'
   });
 }
 
@@ -373,7 +379,8 @@ function touchEnd(instanceId) {
 
     // 惯性滚动参数配置
     var minVelocity = 0.1; // 最小速度阈值，低于此值停止滚动
-    var maxInertiaDistance = state.itemHeight * Math.max(Math.floor(state.options.length/4), 6); // 最大惯性滚动距离
+    // 最大惯性滚动距离：下限 6 项，上限 100 项，避免超长列表单次快滑滚动上万项
+    var maxInertiaDistance = state.itemHeight * Math.min(Math.max(Math.floor(state.options.length/4), 6), 100);
     // 计算惯性滚动距离
     var inertiaDistance = 0;
     if (recentVelocity > minVelocity) {

package/lib/picker/index.js

@@ -13,6 +13,11 @@ var __assign = (this && this.__assign) || function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 var component_1 = require("../common/component");
 var shared_1 = require("./shared");
+// 超过该数量且非 loop 的列启用「窗口化」：只把当前位置附近的一段数据交给子 picker-column，
+// 其余保存在逻辑层实例属性中，滚动停稳后再回中，避免把超长数组整份 setData 到渲染层 / 子组件。
+var WINDOW_THRESHOLD = 2000;
+var WINDOW_SIZE = 1000;
+var clamp = function (value, min, max) { return Math.min(Math.max(value, min), max); };
 (0, component_1.SmartComponent)({
     classes: ['hairline-class', 'active-class', 'toolbar-class', 'column-class'],
     props: __assign(__assign({}, shared_1.pickerProps), { valueKey: {
@@ -29,6 +34,12 @@ var shared_1 = require("./shared");
             value: 0,
         }, activeIndex: {
             type: null,
+            observer: function () {
+                // 受控模式下 activeIndex（全局）变化时，若存在窗口化列需以新位置重建窗口
+                if (this._hasWindow) {
+                    this.buildRenderColumns();
+                }
+            },
         }, unit: {
             type: String,
             value: '',
@@ -38,6 +49,7 @@ var shared_1 = require("./shared");
             observer: function (columns) {
                 if (columns === void 0) { columns = []; }
                 this.simple = columns.length && !columns[0].values;
+                this.buildRenderColumns();
                 if (Array.isArray(this.children) && this.children.length) {
                     this.setColumns().catch(function () { });
                 }
@@ -45,9 +57,15 @@ var shared_1 = require("./shared");
         } }),
     data: {
         animating: false,
+        // 交给渲染层 / 子组件的列数据（窗口化列在此仅为切片，非窗口化列为完整数据）
+        renderColumns: [],
     },
     beforeCreate: function () {
         var _this = this;
+        // 每列的窗口状态：{ windowed, start, size, full }，保存在逻辑层，不进入 data
+        this._windows = [];
+        this._hasWindow = false;
+        this._repositioning = false;
         Object.defineProperty(this, 'children', {
             get: function () { return _this.selectAllComponents('.smart-picker__column') || []; },
         });
@@ -59,11 +77,105 @@ var shared_1 = require("./shared");
     },
     methods: {
         noop: function () { },
+        // 归一化列数据：simple 模式（columns 为一维数组）包一层
+        normalizedColumns: function () {
+            var columns = this.data.columns;
+            if (this.simple) {
+                return [{ values: columns }];
+            }
+            return Array.isArray(columns) ? columns : [];
+        },
+        // 解析某列的初始全局下标（优先 activeIndex，其次 defaultIndex）
+        resolveInitialIndex: function (column) {
+            var _a = this.data, defaultIndex = _a.defaultIndex, activeIndex = _a.activeIndex;
+            var columnActive = column.activeIndex === null || column.activeIndex === undefined
+                ? activeIndex
+                : column.activeIndex;
+            var index;
+            if (columnActive !== null && columnActive !== undefined) {
+                index = columnActive;
+            }
+            else if (column.defaultIndex !== undefined) {
+                index = column.defaultIndex;
+            }
+            else {
+                index = defaultIndex;
+            }
+            var length = (column.values || []).length;
+            return clamp(index || 0, 0, Math.max(0, length - 1));
+        },
+        // 判断某列是否需要窗口化
+        shouldWindow: function (column) {
+            return (!this.data.loop &&
+                !column.loop &&
+                Array.isArray(column.values) &&
+                column.values.length > WINDOW_THRESHOLD);
+        },
+        // 基于当前 columns 计算 renderColumns 与每列窗口状态
+        buildRenderColumns: function () {
+            var _this = this;
+            var columns = this.normalizedColumns();
+            var windows = [];
+            var hasWindow = false;
+            var renderColumns = columns.map(function (column) {
+                var values = column.values || [];
+                if (!_this.shouldWindow(column)) {
+                    windows.push({ windowed: false, start: 0, size: values.length, full: values });
+                    return column;
+                }
+                hasWindow = true;
+                var globalIndex = _this.resolveInitialIndex(column);
+                var size = WINDOW_SIZE;
+                var start = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, values.length - size));
+                var localIndex = globalIndex - start;
+                windows.push({ windowed: true, start: start, size: size, full: values });
+                return __assign(__assign({}, column), { values: values.slice(start, start + size), defaultIndex: localIndex, activeIndex: localIndex, _windowed: true });
+            });
+            this._windows = windows;
+            this._hasWindow = hasWindow;
+            this.setData({ renderColumns: renderColumns });
+        },
+        // 将窗口化列停稳后回中：使当前项回到窗口中心，纯坐标平移，静止态无感
+        recenterColumn: function (columnIndex) {
+            var _a;
+            var _this = this;
+            var win = this._windows[columnIndex];
+            if (!win || !win.windowed || this._repositioning)
+                return;
+            var column = this.getColumn(columnIndex);
+            if (!column)
+                return;
+            var localIndex = column.data.currentIndex;
+            var globalIndex = win.start + localIndex;
+            var size = win.size;
+            var newStart = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, win.full.length - size));
+            if (newStart === win.start)
+                return;
+            this._repositioning = true;
+            win.start = newStart;
+            var newLocal = globalIndex - newStart;
+            // 同一次 setData 内同时更新切片与 active-index（局部），子组件原子接收，
+            // 配合 wxs 对大跳变强制 transition:none，实现无动画的静默回中
+            this.setData((_a = {},
+                _a["renderColumns[".concat(columnIndex, "].values")] = win.full.slice(newStart, newStart + size),
+                _a["renderColumns[".concat(columnIndex, "].activeIndex")] = newLocal,
+                _a), function () {
+                _this._repositioning = false;
+            });
+        },
+        // 局部下标 -> 全局下标
+        toGlobalIndex: function (columnIndex, localIndex) {
+            var win = this._windows[columnIndex];
+            return win && win.windowed ? win.start + localIndex : localIndex;
+        },
         setColumns: function () {
             var _this = this;
-            var data = this.data;
-            var columns = this.simple ? [{ values: data.columns }] : data.columns;
+            var columns = this.normalizedColumns();
             var stack = columns.map(function (column, index) {
+                // 窗口化列由 renderColumns（wxml）响应式驱动，不走命令式全量下发
+                if (_this._windows[index] && _this._windows[index].windowed) {
+                    return Promise.resolve();
+                }
                 return _this.setColumnValues(index, column.values);
             });
             return Promise.all(stack);
@@ -84,6 +196,7 @@ var shared_1 = require("./shared");
             }
         },
         onChange: function (event) {
+            var columnIndex = this.simple ? 0 : event.currentTarget.dataset.index;
             if (this.simple) {
                 this.$emit('change', {
                     picker: this,
@@ -98,6 +211,8 @@ var shared_1 = require("./shared");
                     index: event.currentTarget.dataset.index,
                 });
             }
+            // 停稳后再回中，保证切换发生在静止态
+            this.recenterColumn(columnIndex);
         },
         // get column instance by index
         getColumn: function (index) {
@@ -110,6 +225,19 @@ var shared_1 = require("./shared");
         },
         // set column value by index
         setColumnValue: function (index, value) {
+            var win = this._windows[index];
+            if (win && win.windowed) {
+                // 窗口化列：在完整数据中按 valueKey 查找全局下标后跳转
+                var valueKey = this.data.valueKey;
+                for (var i = 0; i < win.full.length; i++) {
+                    var option = win.full[i];
+                    var text = option && typeof option === 'object' && valueKey in option ? option[valueKey] : option;
+                    if (text === value) {
+                        return this.setColumnIndex(index, i);
+                    }
+                }
+                return Promise.resolve();
+            }
             var column = this.getColumn(index);
             if (column == null) {
                 return Promise.reject(new Error('setColumnValue: The corresponding column does not exist'));
@@ -118,10 +246,29 @@ var shared_1 = require("./shared");
         },
         // get column option index by column index
         getColumnIndex: function (columnIndex) {
-            return (this.getColumn(columnIndex) || {}).data.currentIndex;
+            var _a, _b;
+            var local = (_b = (_a = (this.getColumn(columnIndex) || {}).data) === null || _a === void 0 ? void 0 : _a.currentIndex) !== null && _b !== void 0 ? _b : 0;
+            return this.toGlobalIndex(columnIndex, local);
         },
         // set column option index by column index
         setColumnIndex: function (columnIndex, optionIndex) {
+            var _a;
+            var _this = this;
+            var win = this._windows[columnIndex];
+            if (win && win.windowed) {
+                // 以目标全局下标为中心重建窗口，子组件通过 active-index 定位
+                var size = win.size;
+                var globalIndex = clamp(optionIndex, 0, Math.max(0, win.full.length - 1));
+                var newStart = clamp(globalIndex - Math.floor(size / 2), 0, Math.max(0, win.full.length - size));
+                win.start = newStart;
+                this._repositioning = true;
+                return this.set((_a = {},
+                    _a["renderColumns[".concat(columnIndex, "].values")] = win.full.slice(newStart, newStart + size),
+                    _a["renderColumns[".concat(columnIndex, "].activeIndex")] = globalIndex - newStart,
+                    _a)).then(function () {
+                    _this._repositioning = false;
+                });
+            }
             var column = this.getColumn(columnIndex);
             if (column == null) {
                 return Promise.reject(new Error('setColumnIndex: The corresponding column does not exist'));
@@ -130,16 +277,40 @@ var shared_1 = require("./shared");
         },
         // get options of column by index
         getColumnValues: function (index) {
+            var win = this._windows[index];
+            if (win && win.windowed) {
+                return win.full;
+            }
             return (this.children[index] || {}).data.options;
         },
         // set options of column by index
         setColumnValues: function (index, options, needReset) {
+            var _a;
+            var _this = this;
             if (needReset === void 0) { needReset = true; }
+            var win = this._windows[index];
+            if (win && win.windowed) {
+                // 替换完整数据并以头部为中心重建窗口
+                win.full = options || [];
+                var size = win.size;
+                var start = needReset ? 0 : clamp(win.start, 0, Math.max(0, win.full.length - size));
+                win.start = start;
+                this._repositioning = true;
+                return this.set((_a = {},
+                    _a["renderColumns[".concat(index, "].values")] = win.full.slice(start, start + size),
+                    _a["renderColumns[".concat(index, "].activeIndex")] = 0,
+                    _a)).then(function () {
+                    _this._repositioning = false;
+                });
+            }
             var column = this.children[index];
             if (column == null) {
                 return Promise.reject(new Error('setColumnValues: The corresponding column does not exist'));
             }
-            var isSame = JSON.stringify(column.data.options) === JSON.stringify(options);
+            var prevOptions = column.data.options || [];
+            // 先比长度（O(1)）短路：长度不同必然不同，避免对超长数组做两次 JSON.stringify
+            var isSame = prevOptions.length === options.length &&
+                JSON.stringify(prevOptions) === JSON.stringify(options);
             if (isSame) {
                 return Promise.resolve();
             }
@@ -161,7 +332,10 @@ var shared_1 = require("./shared");
         },
         // get indexes of all columns
         getIndexes: function () {
-            return this.children.map(function (child) { return child.data.currentIndex; });
+            var _this = this;
+            return this.children.map(function (child, index) {
+                return _this.toGlobalIndex(index, child.data.currentIndex);
+            });
         },
         // set indexes of all columns
         setIndexes: function (indexes) {

package/lib/picker/index.wxml

@@ -14,7 +14,7 @@
   >
     <picker-column
       class="smart-picker__column"
-      wx:for="{{ computed.columns(columns) }}"
+      wx:for="{{ renderColumns }}"
       wx:key="index"
       data-index="{{ index }}"
       animation-time="{{ animationTime }}"
@@ -24,6 +24,7 @@
       active-style="{{ activeStyle }}"
       font-style="{{fontStyle ? fontStyle + ';' + computed.style(item.fontStyle): computed.style(item.fontStyle)}}"
       options="{{ item.values }}"
+      windowed="{{ item._windowed || false }}"
       disabled="{{ item.disabled || false }}"
       unit="{{ item.unit || unit }}"
       unit-gap="{{ item.unitGap }}"

package/lib/picker-column/index.js

@@ -21,6 +21,11 @@ var getId = function () {
         className: String,
         itemHeight: Number,
         disabled: Boolean,
+        // 是否为父级窗口化列：为 true 时对大幅度的 active-index 跳变强制关闭过渡（用于停稳回中的静默重定位）
+        windowed: {
+            type: Boolean,
+            value: false,
+        },
         visibleItemCount: Number,
         activeStyle: {
             type: String,
@@ -33,7 +38,12 @@ var getId = function () {
                 if (!this.data.isInit)
                     return;
                 this.updateUint(value);
-                this.updateCurrentIndex(this.data.currentIndex);
+                // 窗口化列：切片与 activeIndex（局部）在同一批 setData 到达，
+                // 此处直接采用新的 activeIndex，使「新切片 + 新下标」原子落地，避免差一帧的错位闪烁
+                var nextIndex = this.data.windowed && this.data.activeIndex !== null && this.data.activeIndex !== undefined
+                    ? this.data.activeIndex
+                    : this.data.currentIndex;
+                this.updateCurrentIndex(nextIndex);
                 this.updateVisibleOptions();
             },
         },

package/lib/picker-column/index.wxml

@@ -8,15 +8,15 @@
   id="{{instanceId}}"
   data-isdestroy="{{isDestroy}}"
   data-changeanimation="{{changeAnimation}}"
-  data-options="{{options}}"
   data-valuekey="{{valueKey}}"
   data-itemheight="{{itemHeight}}"
   data-visibleitemcount="{{visibleItemCount}}"
   data-activeindex="{{currentIndex}}"
   data-loop="{{loop && options.length > 1}}"
   data-animationtime="{{animationTime}}"
+  data-windowed="{{windowed}}"
   isdestroy="{{isDestroy}}"
-  options="{{options}}" 
+  options="{{options}}"
   activeindex="{{currentIndex}}"
   changeanimation="{{changeAnimation}}"
   loop="{{loop && options.length > 1}}"
@@ -24,15 +24,17 @@
   itemheight="{{itemHeight}}"
   visibleitemcount="{{visibleItemCount}}"
   animationtime="{{animationTime}}"
+  windowed="{{windowed}}"
   change:isdestroy="{{computed.updateValue(instanceId, 'isDestroy')}}"
-  change:options="{{computed.updateValue(instanceId, 'options')}}" 
-  change:valuekey="{{computed.updateValue(instanceId,'valueKey')}}" 
-  change:itemheight="{{computed.updateValue(instanceId,'itemHeight')}}" 
-  change:visibleitemcount="{{computed.updateValue(instanceId, 'visibleItemCount')}}" 
-  change:activeindex="{{computed.updateValue(instanceId,'activeIndex')}}" 
-  change:loop="{{computed.updateValue(instanceId,'loop')}}" 
-  change:animationtime="{{computed.updateValue(instanceId,'animationTime')}}" 
-  change:instanceid="{{computed.updateValue(instanceId,'instanceId')}}" 
+  change:options="{{computed.updateValue(instanceId, 'options')}}"
+  change:valuekey="{{computed.updateValue(instanceId,'valueKey')}}"
+  change:itemheight="{{computed.updateValue(instanceId,'itemHeight')}}"
+  change:visibleitemcount="{{computed.updateValue(instanceId, 'visibleItemCount')}}"
+  change:activeindex="{{computed.updateValue(instanceId,'activeIndex')}}"
+  change:loop="{{computed.updateValue(instanceId,'loop')}}"
+  change:animationtime="{{computed.updateValue(instanceId,'animationTime')}}"
+  change:windowed="{{computed.updateValue(instanceId,'windowed')}}"
+  change:instanceid="{{computed.updateValue(instanceId,'instanceId')}}"
   bind:touchstart="{{computed.touchStart(instanceId)}}"
   catch:touchmove="{{computed.touchMove(instanceId)}}"
   bind:touchend="{{computed.touchEnd(instanceId)}}"

package/lib/picker-column/index.wxs

@@ -226,7 +226,8 @@ function getDomState(ownerInstance) {
 
 function initDomState(instanceId, ownerInstance) {
   var state = getDomState(ownerInstance);
-  updateState(instanceId, 'options', state.options)
+  // options 不再通过 data-options 传入（避免把全量数组塞进 dataset / getDataset），
+  // 由 change:options -> updateValue('options', ...) 单独维护 state.options
   updateState(instanceId, 'valueKey', state.valuekey)
   updateState(instanceId, 'itemHeight', state.itemheight)
   updateState(instanceId, 'visibleItemCount', state.visibleitemcount)
@@ -234,6 +235,7 @@ function initDomState(instanceId, ownerInstance) {
   updateState(instanceId, 'loop', state.loop)
   updateState(instanceId, 'animationTime', state.animationtime)
   updateState(instanceId, 'changeAnimation', state.changeanimation)
+  updateState(instanceId, 'windowed', state.windowed)
 }
 
 
@@ -262,10 +264,14 @@ function updateListView(instanceId, ownerInstance) {
   var animationIndex = state.animationIndex || 0;
   var newAnimationIndex = getNewAnimationIndex(animationIndex, activeIndex, length, state.loop);
   var isSame = newAnimationIndex === animationIndex;
+  // 窗口化列的「停稳回中/重定位」会产生大幅度的 activeIndex 跳变，此时强制关闭过渡：
+  // 因为切片内容与位置是同步平移的，直接吸附即像素级一致，避免整轮旋转动画造成抖动。
+  var vOptionLength = state.visibleItemCount * 4 - 2;
+  var isWindowReposition = state.windowed && Math.abs(newAnimationIndex - animationIndex) > vOptionLength;
   updateState(instanceId, 'animationIndex', newAnimationIndex)
   updateVisibleOptions(state.animationIndex, instanceId);
   updateWrapperStyle(instanceId, ownerInstance, {
-    transition: (!state.changeAnimation || isSame) ? 'none' : 'transform ' + state.animationTime + 'ms cubic-bezier(0.2, 0.9, 0.25, 1)'
+    transition: (!state.changeAnimation || isSame || isWindowReposition) ? 'none' : 'transform ' + state.animationTime + 'ms cubic-bezier(0.2, 0.9, 0.25, 1)'
   });
 }
 
@@ -373,7 +379,8 @@ function touchEnd(instanceId) {
 
     // 惯性滚动参数配置
     var minVelocity = 0.1; // 最小速度阈值，低于此值停止滚动
-    var maxInertiaDistance = state.itemHeight * Math.max(Math.floor(state.options.length/4), 6); // 最大惯性滚动距离
+    // 最大惯性滚动距离：下限 6 项，上限 100 项，避免超长列表单次快滑滚动上万项
+    var maxInertiaDistance = state.itemHeight * Math.min(Math.max(Math.floor(state.options.length/4), 6), 100);
     // 计算惯性滚动距离
     var inertiaDistance = 0;
     if (recentVelocity > minVelocity) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuya-miniapp/smart-ui",
-  "version": "2.13.4",
+  "version": "2.13.5-beta-0",
   "author": "MiniApp Team",
   "license": "MIT",
   "miniprogram": "lib",