feat(Picker): add wheel-config prop (#825)

* feat(Picker): add wheel-config prop

* docs(Picker): 移除 wheelConfig 属性文档

* docs(Picker): 添加 wheelConfig 属性文档

---------

Co-authored-by: liweijie <674416404@qq.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: 3 people

db/TDesign.db

@@ -18,6 +18,7 @@ swipeDuration | String / Number | 300 | The duration of inertial scrolling durin
 title | String | '' | \- | N
 value | Array | - | `v-model` and `v-model:value` is supported。Typescript: `Array<PickerValue>` `type PickerValue = string \| number`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
 defaultValue | Array | - | uncontrolled property。Typescript: `Array<PickerValue>` `type PickerValue = string \| number`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
+wheelConfig | Object | - | Typescript: `PickerWheelConfig ` `interface PickerWheelConfig { inertiaDuration?: number; bounceDuration?: number; transitionDuration?: number; inertiaTimeThreshold?: number; inertiaDistanceThreshold?: number; boundOffset?: number; clickDistanceThreshold?: number; clickTimeThreshold?: number;}`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
 onCancel | Function |  | Typescript: `(context: { e: MouseEvent }) => void`<br/> | N
 onChange | Function |  | Typescript: `(value: Array<PickerValue>, context: { columns: Array<PickerContext>, e: MouseEvent })  => void`<br/>[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts)。<br/>`interface PickerContext{ column: number,index: number }`<br/> | N
 onConfirm | Function |  | Typescript: `(value: Array<PickerValue>, context: { index: number[], e: MouseEvent, label: string[] }) => void`<br/> | N

packages/products/tdesign-mobile-vue/src/picker/picker.en-US.md

@@ -14,10 +14,11 @@ header | Slot / Function | - | 自定义头部内容。TS 类型：`TNode`。[
 keys | Object | - | 用来定义 value / label / disabled 在 `columns ` 中对应的字段别名。TS 类型：`KeysType`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
 option | Slot / Function | - | 自定义选项内容。参数为 `option: PickerColumnItem, index: number`。TS 类型：`(option: PickerColumnItem, index: number) => string \| Record<string, string \| boolean>` | N
 renderLabel | Function | - | 自定义label。TS 类型：`(item: PickerColumnItem, index: number) => string` | N
-swipeDuration | String / Number | 300 | 快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动。TS 类型：`string \| number` | N
+swipeDuration | String / Number | 300 | ⚠️ 即将废弃，请使用 `wheelConfig.inertiaDuration` 代替。快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动。TS 类型：`string \| number` | N
 title | String | '' | 标题 | N
 value | Array | - | 选中值。支持语法糖 `v-model` 或 `v-model:value`。TS 类型：`Array<PickerValue>` `type PickerValue = string \| number`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
 defaultValue | Array | - | 选中值。非受控属性。TS 类型：`Array<PickerValue>` `type PickerValue = string \| number`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
+wheelConfig | Object | - | 【实验】滚轮滑动相关配置，用于自定义滚轮的动画和交互行为。`inertiaDuration` 表示惯性滚动的持续时长；`bounceDuration` 表示边界归位动画时长；`transitionDuration` 表示切换选项时的过渡动画时长； `inertiaTimeThreshold` 表示惯性触发的时间阈值； `inertiaDistanceThreshold` 表示惯性触发的距离阈值； `boundOffset` 表示边界偏移量；`clickDistanceThreshold` 表示点击操作的距离阈值；`clickTimeThreshold` 表示点击操作的时间阈值。TS 类型：`PickerWheelConfig ` `interface PickerWheelConfig { inertiaDuration?: number; bounceDuration?: number; transitionDuration?: number; inertiaTimeThreshold?: number; inertiaDistanceThreshold?: number; boundOffset?: number; clickDistanceThreshold?: number; clickTimeThreshold?: number;}`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts) | N
 onCancel | Function |  | TS 类型：`(context: { e: MouseEvent }) => void`<br/>点击取消按钮时触发 | N
 onChange | Function |  | TS 类型：`(value: Array<PickerValue>, context: { columns: Array<PickerContext>, e: MouseEvent })  => void`<br/>选中变化时候触发。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/picker/type.ts)。<br/>`interface PickerContext{ column: number,index: number }`<br/> | N
 onConfirm | Function |  | TS 类型：`(value: Array<PickerValue>, context: { index: number[], e: MouseEvent, label: string[] }) => void`<br/>点击确认按钮时触发 | N

packages/products/tdesign-mobile-vue/src/picker/picker.md

@@ -44,7 +44,7 @@ export default {
   renderLabel: {
     type: Function as PropType<TdPickerProps['renderLabel']>,
   },
-  /** 快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动 */
+  /** ⚠️ 即将废弃，请使用 `wheelConfig.inertiaDuration` 代替。快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动 */
   swipeDuration: {
     type: [String, Number] as PropType<TdPickerProps['swipeDuration']>,
     default: 300 as TdPickerProps['swipeDuration'],
@@ -67,6 +67,10 @@ export default {
   defaultValue: {
     type: Array as PropType<TdPickerProps['defaultValue']>,
   },
+  /** 【实验】滚轮滑动相关配置，用于自定义滚轮的动画和交互行为。`inertiaDuration` 表示惯性滚动的持续时长；`bounceDuration` 表示边界归位动画时长；`transitionDuration` 表示切换选项时的过渡动画时长； `inertiaTimeThreshold` 表示惯性触发的时间阈值； `inertiaDistanceThreshold` 表示惯性触发的距离阈值； `boundOffset` 表示边界偏移量；`clickDistanceThreshold` 表示点击操作的距离阈值；`clickTimeThreshold` 表示点击操作的时间阈值 */
+  wheelConfig: {
+    type: Object as PropType<TdPickerProps['wheelConfig']>,
+  },
   /** 点击取消按钮时触发 */
   onCancel: Function as PropType<TdPickerProps['onCancel']>,
   /** 选中变化时候触发 */

packages/products/tdesign-mobile-vue/src/picker/props.ts

@@ -43,7 +43,7 @@ export interface TdPickerProps {
    */
   renderLabel?: (item: PickerColumnItem, index: number) => string;
   /**
-   * 快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动
+   * ⚠️ 即将废弃，请使用 `wheelConfig.inertiaDuration` 代替。快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动
    * @default 300
    */
   swipeDuration?: string | number;
@@ -64,6 +64,10 @@ export interface TdPickerProps {
    * 选中值
    */
   modelValue?: Array<PickerValue>;
+  /**
+   * 【实验】滚轮滑动相关配置，用于自定义滚轮的动画和交互行为。`inertiaDuration` 表示惯性滚动的持续时长；`bounceDuration` 表示边界归位动画时长；`transitionDuration` 表示切换选项时的过渡动画时长； `inertiaTimeThreshold` 表示惯性触发的时间阈值； `inertiaDistanceThreshold` 表示惯性触发的距离阈值； `boundOffset` 表示边界偏移量；`clickDistanceThreshold` 表示点击操作的距离阈值；`clickTimeThreshold` 表示点击操作的时间阈值
+   */
+  wheelConfig?: PickerWheelConfig;
   /**
    * 点击取消按钮时触发
    * @default ''
@@ -96,6 +100,17 @@ export interface PickerColumnItem {
 
 export type PickerValue = string | number;
 
+export interface PickerWheelConfig {
+  inertiaDuration?: number;
+  bounceDuration?: number;
+  transitionDuration?: number;
+  inertiaTimeThreshold?: number;
+  inertiaDistanceThreshold?: number;
+  boundOffset?: number;
+  clickDistanceThreshold?: number;
+  clickTimeThreshold?: number;
+}
+
 export interface PickerContext {
   column: number;
   index: number;

packages/products/tdesign-mobile-vue/src/picker/type.ts

@@ -92790,7 +92790,7 @@
       ],
       "field_default_value": "300",
       "field_enum": "",
-      "field_desc_zh": "快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动",
+      "field_desc_zh": "⚠️ 即将废弃，请使用 `wheelConfig.inertiaDuration` 代替。快速滑动时惯性滚动的时长，单位 ms，为 0 时表示取消惯性滚动",
       "field_desc_en": "The duration of inertial scrolling during fast swiping, in milliseconds (ms). When set to 0, it disables inertial scrolling.",
       "field_required": 0,
       "event_input": "",
@@ -93095,6 +93095,43 @@
         "Number"
       ]
     },
+    {
+      "id": 1773297544,
+      "platform_framework": [
+        "8"
+      ],
+      "component": "Picker",
+      "field_category": 1,
+      "field_name": "wheelConfig",
+      "field_type": [
+        "8"
+      ],
+      "field_default_value": "",
+      "field_enum": "",
+      "field_desc_zh": "【实验】滚轮滑动相关配置，用于自定义滚轮的动画和交互行为。`inertiaDuration` 表示惯性滚动的持续时长；`bounceDuration` 表示边界归位动画时长；`transitionDuration` 表示切换选项时的过渡动画时长； `inertiaTimeThreshold` 表示惯性触发的时间阈值； `inertiaDistanceThreshold` 表示惯性触发的距离阈值； `boundOffset` 表示边界偏移量；`clickDistanceThreshold` 表示点击操作的距离阈值；`clickTimeThreshold` 表示点击操作的时间阈值",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2026-03-12 06:39:04",
+      "update_time": "2026-03-12 06:39:04",
+      "event_output": null,
+      "custom_field_type": "PickerWheelConfig 【interface PickerWheelConfig { inertiaDuration?: number; bounceDuration?: number; transitionDuration?: number; inertiaTimeThreshold?: number; inertiaDistanceThreshold?: number; boundOffset?: number; clickDistanceThreshold?: number; clickTimeThreshold?: number;}】",
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\n\"Mobile(Vue)\":\"1.13.1\" \n}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Props",
+      "platform_framework_text": [
+        "Vue(Mobile)"
+      ],
+      "field_type_text": [
+        "Object"
+      ]
+    },
     {
       "id": 1475,
       "platform_framework": [