@tarojs/components-react 4.1.12-beta.5 → 4.1.12-beta.51

package/dist/original/components/picker/picker-group.js

@@ -3,6 +3,32 @@ import Taro from '@tarojs/taro';
 import * as React from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
+function requestAccessibilityFocusOnView(node) {
+  if (node == null) return;
+  const fn = Taro.setAccessibilityFocus;
+  if (typeof fn !== 'function') return;
+  fn({
+    viewRef: {
+      current: node
+    }
+  });
+}
+/** 部分端同 id 连续 scrollIntoView 不生效：先清空再在下一宏任务设回目标 id */
+function usePickerItemScrollIntoView() {
+  const [scrollIntoView, setScrollIntoView] = React.useState('');
+  const pulseRef = React.useRef(0);
+  const scrollToItemId = React.useCallback(itemId => {
+    pulseRef.current += 1;
+    const token = pulseRef.current;
+    setScrollIntoView('');
+    setTimeout(() => {
+      if (pulseRef.current !== token) return;
+      setScrollIntoView(itemId);
+    }, 0);
+  }, []);
+  return [scrollIntoView, scrollToItemId];
+}
+// 定义常量
 const PICKER_LINE_HEIGHT = 34; // px
 const PICKER_VISIBLE_ITEMS = 7; // 可见行数
 const PICKER_BLANK_ITEMS = 3; // 空白行数
@@ -12,6 +38,25 @@ const getIndicatorStyle = lineColor => {
     borderBottomColor: lineColor
   };
 };
+// 大屏方案版本要求
+const MIN_DESIGN_APP_VERSION = 16;
+// 判断是否启用测量值缩放适配（true=启用, false=使用系统侧缩放）
+const resolveUseMeasuredScale = res => {
+  // H5/weapp 不参与大屏系数
+  if (process.env.TARO_ENV === 'h5' || process.env.TARO_ENV === 'weapp') {
+    return false;
+  }
+  const designAppVersionRaw = res.designAppVersion;
+  const designAppVersionMajor = designAppVersionRaw != null ? parseInt(String(designAppVersionRaw).trim(), 10) : Number.NaN;
+  if (!Number.isFinite(designAppVersionMajor) || designAppVersionMajor < MIN_DESIGN_APP_VERSION) {
+    return false;
+  }
+  const platform = String(res.platform || '').toLowerCase();
+  if (platform === 'harmony' || platform === 'android' || platform === 'ios') {
+    return true;
+  }
+  return false;
+};
 // 辅助函数：计算 lengthScaleRatio
 const calculateLengthScaleRatio = res => {
   let lengthScaleRatio = res === null || res === void 0 ? void 0 : res.lengthScaleRatio;
@@ -50,6 +95,29 @@ const setTargetScrollTopWithScale = function (setTargetScrollTop, baseValue, ran
     setTargetScrollTop(finalValue);
   }
 };
+// 根据 scrollTop 计算选中索引
+// 系统侧缩放模式：scrollHeight 已被系统缩放，直接相除即可
+// 自行缩放模式：需要除以 ratio 换算（harmony 特殊处理，ratio 已内嵌在 itemHeight 中）
+const getSelectedIndex = function (scrollTop, itemHeight) {
+  let lengthScaleRatio = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+  let useMeasuredScale = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+  if (!useMeasuredScale || process.env.TARO_PLATFORM === 'harmony') {
+    return Math.round(scrollTop / itemHeight);
+  }
+  return Math.round(scrollTop / lengthScaleRatio / itemHeight);
+};
+// 计算单项高度（返回设计稿值）
+const calculateItemHeight = function (scrollView, lengthScaleRatio) {
+  let useMeasuredScale = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+  if (process.env.TARO_PLATFORM === 'harmony') {
+    return useMeasuredScale ? PICKER_LINE_HEIGHT * lengthScaleRatio : PICKER_LINE_HEIGHT;
+  }
+  if (scrollView && (scrollView === null || scrollView === void 0 ? void 0 : scrollView.scrollHeight)) {
+    return useMeasuredScale ? scrollView.scrollHeight / lengthScaleRatio / scrollView.childNodes.length : scrollView.scrollHeight / scrollView.childNodes.length;
+  }
+  console.warn('Height measurement anomaly');
+  return PICKER_LINE_HEIGHT;
+};
 function PickerGroupBasic(props) {
   const {
     range = [],
@@ -59,69 +127,72 @@ function PickerGroupBasic(props) {
     onColumnChange,
     selectedIndex = 0,
     // 使用selectedIndex参数，默认为0
-    colors = {}
+    colors = {},
+    enableClickItemScroll = true
   } = props;
   const indicatorStyle = colors.lineColor ? getIndicatorStyle(colors.lineColor) : null;
   const [targetScrollTop, setTargetScrollTop] = React.useState(0);
+  const [scrollIntoView, scrollToItemId] = usePickerItemScrollIntoView();
   const scrollViewRef = React.useRef(null);
   const itemRefs = React.useRef([]);
+  const selectedIndexPropRef = React.useRef(selectedIndex);
+  selectedIndexPropRef.current = selectedIndex;
+  const syncScrollFromPropsRef = React.useRef(false);
+  const pendingScrollSettleFocusRef = React.useRef(false);
   // 使用selectedIndex初始化当前索引
   const [currentIndex, setCurrentIndex] = React.useState(selectedIndex);
   // 触摸状态用于优化用户体验
-  const [isTouching, setIsTouching] = React.useState(false);
+  const isTouchingRef = React.useRef(false);
   const lengthScaleRatioRef = React.useRef(1);
+  const useMeasuredScaleRef = React.useRef(false);
   const itemHeightRef = React.useRef(PICKER_LINE_HEIGHT);
-  // 初始化时计算 lengthScaleRatio
+  // 初始化时计算 lengthScaleRatio 并判定缩放模式
   React.useEffect(() => {
     Taro.getSystemInfo({
       success: res => {
         lengthScaleRatioRef.current = calculateLengthScaleRatio(res);
+        useMeasuredScaleRef.current = resolveUseMeasuredScale(res);
+        itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
       },
       fail: () => {
-        // 失败时使用默认值 1
         lengthScaleRatioRef.current = 1;
+        useMeasuredScaleRef.current = false;
       }
     });
   }, []);
   React.useEffect(() => {
-    var _a;
-    if (process.env.TARO_PLATFORM === 'harmony') {
-      itemHeightRef.current = PICKER_LINE_HEIGHT * lengthScaleRatioRef.current;
-    } else {
-      if (scrollViewRef.current && ((_a = scrollViewRef.current) === null || _a === void 0 ? void 0 : _a.scrollHeight)) {
-        itemHeightRef.current = scrollViewRef.current.scrollHeight / scrollViewRef.current.childNodes.length;
-      } else {
-        console.warn('Height measurement anomaly');
-      }
-    }
+    itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
   }, [range.length]); // 只在range长度变化时重新计算
-  // 获取选中的索引
-  const getSelectedIndex = scrollTop => {
-    return Math.round(scrollTop / itemHeightRef.current);
-  };
-  // 当selectedIndex变化时，调整滚动位置
+  // props 的 selectedIndex 变化：滚至对应项并短时标记程序化滚动（syncScrollFromPropsRef）
   React.useEffect(() => {
-    if (scrollViewRef.current && range.length > 0 && !isTouching) {
+    if (scrollViewRef.current && range.length > 0 && !isTouchingRef.current) {
+      syncScrollFromPropsRef.current = true;
       const baseValue = selectedIndex * itemHeightRef.current;
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, undefined, lengthScaleRatioRef.current);
       setCurrentIndex(selectedIndex);
+      const tid = setTimeout(() => {
+        syncScrollFromPropsRef.current = false;
+      }, 400);
+      return () => clearTimeout(tid);
     }
   }, [selectedIndex, range]);
   // 是否处于归中状态
   const isCenterTimerId = React.useRef(null);
-  // 简化为直接在滚动结束时通知父组件
+  // 滚动静止后归中并同步选中
   const handleScrollEnd = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
       clearTimeout(isCenterTimerId.current);
       isCenterTimerId.current = null;
     }
-    // 做一个0.1s延时  0.1s之内没有新的滑动 则把选项归到中间 然后更新选中项
+    // 100ms 内无新滚动则归中并提交索引
     isCenterTimerId.current = setTimeout(() => {
       if (!scrollViewRef.current) return;
       const scrollTop = scrollViewRef.current.scrollTop;
-      const newIndex = getSelectedIndex(scrollTop);
-      setIsTouching(false);
+      const newIndex = getSelectedIndex(scrollTop, itemHeightRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+      const allowA11yFocus = !syncScrollFromPropsRef.current;
+      const shouldFocusOnScrollSettle = pendingScrollSettleFocusRef.current;
+      isTouchingRef.current = false;
       const baseValue = newIndex * itemHeightRef.current;
       const randomOffset = Math.random() * 0.001; // 随机数为了在一个项内滚动时强制刷新
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, randomOffset, lengthScaleRatioRef.current);
@@ -130,10 +201,15 @@ function PickerGroupBasic(props) {
         columnId,
         index: newIndex
       });
+      pendingScrollSettleFocusRef.current = false;
+      if (allowA11yFocus && shouldFocusOnScrollSettle) {
+        requestAccessibilityFocusOnView(itemRefs.current[newIndex]);
+      }
+      syncScrollFromPropsRef.current = false;
       isCenterTimerId.current = null;
     }, 100);
   };
-  // 滚动处理 - 在滚动时计算索引然后更新选中项样式
+  // 滚动中：按 scrollTop 更新高亮索引
   const handleScroll = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
@@ -141,7 +217,17 @@ function PickerGroupBasic(props) {
       isCenterTimerId.current = null;
     }
     const scrollTop = scrollViewRef.current.scrollTop;
-    const newIndex = getSelectedIndex(scrollTop);
+    const ih = itemHeightRef.current;
+    const newIndex = getSelectedIndex(scrollTop, ih, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+    const spi = selectedIndexPropRef.current;
+    if (newIndex !== spi) {
+      if (!syncScrollFromPropsRef.current || isTouchingRef.current) {
+        pendingScrollSettleFocusRef.current = true;
+      }
+      if (isTouchingRef.current) {
+        syncScrollFromPropsRef.current = false;
+      }
+    }
     if (newIndex !== currentIndex) {
       setCurrentIndex(newIndex);
     }
@@ -153,6 +239,9 @@ function PickerGroupBasic(props) {
       id: `picker-item-${columnId}-${index}`,
       ref: el => itemRefs.current[index] = el,
       className: `taro-picker__item${index === currentIndex ? ' taro-picker__item--selected' : ''}`,
+      ...(enableClickItemScroll ? {
+        onClick: () => scrollToItemId(`picker-item-${columnId}-${index}`)
+      } : {}),
       style: {
         height: PICKER_LINE_HEIGHT,
         color: index === currentIndex ? colors.itemSelectedColor || undefined : colors.itemDefaultColor || undefined
@@ -171,6 +260,10 @@ function PickerGroupBasic(props) {
       height: PICKER_LINE_HEIGHT
     }
   }, `blank-bottom-${idx}`))];
+  const clickScrollViewProps = enableClickItemScroll ? {
+    scrollIntoView,
+    scrollIntoViewAlignment: 'center'
+  } : {};
   return /*#__PURE__*/jsxs(View, {
     className: "taro-picker__group",
     children: [/*#__PURE__*/jsx(View, {
@@ -189,8 +282,11 @@ function PickerGroupBasic(props) {
         height: PICKER_LINE_HEIGHT * PICKER_VISIBLE_ITEMS
       },
       scrollTop: targetScrollTop,
+      ...clickScrollViewProps,
       onScroll: handleScroll,
-      onTouchStart: () => setIsTouching(true),
+      onTouchStart: () => {
+        isTouchingRef.current = true;
+      },
       onScrollEnd: handleScrollEnd,
       scrollWithAnimation: true,
       children: realPickerItems
@@ -205,78 +301,189 @@ function PickerGroupTime(props) {
     columnId,
     updateIndex,
     selectedIndex = 0,
-    colors = {}
+    colors = {},
+    timeA11yLimitFocus,
+    onTimeA11yLimitFocusConsumed,
+    timeA11yLimitEventNonce,
+    enableClickItemScroll = true
   } = props;
   const indicatorStyle = colors.lineColor ? getIndicatorStyle(colors.lineColor) : null;
   const [targetScrollTop, setTargetScrollTop] = React.useState(0);
+  const [scrollIntoView, scrollToItemId] = usePickerItemScrollIntoView();
   const scrollViewRef = React.useRef(null);
   const itemRefs = React.useRef([]);
+  const selectedIndexPropRef = React.useRef(selectedIndex);
+  selectedIndexPropRef.current = selectedIndex;
+  const syncScrollFromPropsRef = React.useRef(false);
+  const prevLimitEventNonceRef = React.useRef(undefined);
+  const suppressScrollSettleFocusNonceRef = React.useRef(null);
+  const pendingScrollSettleFocusRef = React.useRef(false);
+  const pendingLimitFocusRef = React.useRef(null);
+  const limitFocusTimerRef = React.useRef(null);
   const [currentIndex, setCurrentIndex] = React.useState(selectedIndex);
-  const [isTouching, setIsTouching] = React.useState(false);
+  const isTouchingRef = React.useRef(false);
   const lengthScaleRatioRef = React.useRef(1);
+  const useMeasuredScaleRef = React.useRef(false);
   const itemHeightRef = React.useRef(PICKER_LINE_HEIGHT);
-  // 初始化时计算 lengthScaleRatio
+  const clearLimitFocusTimer = React.useCallback(() => {
+    if (limitFocusTimerRef.current) {
+      clearTimeout(limitFocusTimerRef.current);
+      limitFocusTimerRef.current = null;
+    }
+  }, []);
+  const tryFocusPendingLimit = React.useCallback(() => {
+    const pending = pendingLimitFocusRef.current;
+    const scrollView = scrollViewRef.current;
+    if (!pending || !scrollView) return;
+    const visualIndex = getSelectedIndex(scrollView.scrollTop, itemHeightRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+    const isStable = visualIndex === pending.index;
+    if (!isStable) {
+      if (pending.attempts >= 20) {
+        pendingLimitFocusRef.current = null;
+        if (suppressScrollSettleFocusNonceRef.current === pending.nonce) {
+          suppressScrollSettleFocusNonceRef.current = null;
+        }
+        onTimeA11yLimitFocusConsumed === null || onTimeA11yLimitFocusConsumed === void 0 ? void 0 : onTimeA11yLimitFocusConsumed();
+        return;
+      }
+      pending.attempts += 1;
+      clearLimitFocusTimer();
+      limitFocusTimerRef.current = setTimeout(() => {
+        tryFocusPendingLimit();
+      }, 50);
+      return;
+    }
+    const node = itemRefs.current[pending.index];
+    pendingLimitFocusRef.current = null;
+    if (suppressScrollSettleFocusNonceRef.current === pending.nonce) {
+      suppressScrollSettleFocusNonceRef.current = null;
+    }
+    clearLimitFocusTimer();
+    requestAccessibilityFocusOnView(node);
+    onTimeA11yLimitFocusConsumed === null || onTimeA11yLimitFocusConsumed === void 0 ? void 0 : onTimeA11yLimitFocusConsumed();
+  }, [clearLimitFocusTimer, onTimeA11yLimitFocusConsumed]);
+  const schedulePendingLimitFocus = React.useCallback(() => {
+    if (!pendingLimitFocusRef.current) return;
+    clearLimitFocusTimer();
+    limitFocusTimerRef.current = setTimeout(() => {
+      tryFocusPendingLimit();
+    }, 100);
+  }, [clearLimitFocusTimer, tryFocusPendingLimit]);
+  React.useEffect(() => clearLimitFocusTimer, [clearLimitFocusTimer]);
+  // 初始化时计算 lengthScaleRatio 并判定缩放模式
   React.useEffect(() => {
     Taro.getSystemInfo({
       success: res => {
         lengthScaleRatioRef.current = calculateLengthScaleRatio(res);
+        useMeasuredScaleRef.current = resolveUseMeasuredScale(res);
+        itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
       },
       fail: () => {
-        // 失败时使用默认值 1
         lengthScaleRatioRef.current = 1;
+        useMeasuredScaleRef.current = false;
       }
     });
   }, []);
   React.useEffect(() => {
-    var _a;
-    if (process.env.TARO_PLATFORM === 'harmony') {
-      itemHeightRef.current = PICKER_LINE_HEIGHT * lengthScaleRatioRef.current;
-    } else {
-      if (scrollViewRef.current && ((_a = scrollViewRef.current) === null || _a === void 0 ? void 0 : _a.scrollHeight)) {
-        itemHeightRef.current = scrollViewRef.current.scrollHeight / scrollViewRef.current.childNodes.length;
-      } else {
-        console.warn('Height measurement anomaly');
-      }
-    }
+    itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
   }, [range.length]); // 只在range长度变化时重新计算
-  const getSelectedIndex = scrollTop => {
-    return Math.round(scrollTop / itemHeightRef.current);
-  };
-  // 当selectedIndex变化时，调整滚动位置
+  // props 的 selectedIndex 变化：滚至对应项并短时标记程序化滚动（syncScrollFromPropsRef）
   React.useEffect(() => {
-    if (scrollViewRef.current && range.length > 0 && !isTouching) {
+    if (scrollViewRef.current && range.length > 0 && !isTouchingRef.current) {
+      syncScrollFromPropsRef.current = true;
       const baseValue = selectedIndex * itemHeightRef.current;
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, undefined, lengthScaleRatioRef.current);
       setCurrentIndex(selectedIndex);
+      const tid = setTimeout(() => {
+        syncScrollFromPropsRef.current = false;
+      }, 400);
+      return () => clearTimeout(tid);
     }
   }, [selectedIndex, range]);
+  // time 限位 nonce 变更：强制对齐 scrollTop（避免 remount 打断读屏焦点）
+  React.useEffect(() => {
+    if (!timeA11yLimitEventNonce) return;
+    if (!scrollViewRef.current || range.length === 0 || isTouchingRef.current) return;
+    syncScrollFromPropsRef.current = true;
+    const baseValue = selectedIndex * itemHeightRef.current;
+    setTargetScrollTopWithScale(setTargetScrollTop, baseValue, Math.random() * 0.001, lengthScaleRatioRef.current);
+    setCurrentIndex(selectedIndex);
+    const tid = setTimeout(() => {
+      syncScrollFromPropsRef.current = false;
+    }, 400);
+    return () => clearTimeout(tid);
+  }, [timeA11yLimitEventNonce]); // 仅依赖 nonce，其余用 ref
+  React.useLayoutEffect(() => {
+    if (timeA11yLimitEventNonce === undefined) return;
+    const prev = prevLimitEventNonceRef.current;
+    prevLimitEventNonceRef.current = timeA11yLimitEventNonce;
+    if (timeA11yLimitEventNonce > 0 && (prev === undefined || timeA11yLimitEventNonce > prev)) {
+      suppressScrollSettleFocusNonceRef.current = timeA11yLimitEventNonce;
+    }
+  }, [timeA11yLimitEventNonce]);
+  // 限位后登记本列待聚焦项，稳定后再 requestAccessibilityFocus
+  React.useEffect(() => {
+    const req = timeA11yLimitFocus;
+    if (!req || req.columnId !== columnId) return;
+    const idx = selectedIndex;
+    const nonce = req.nonce;
+    pendingScrollSettleFocusRef.current = false;
+    pendingLimitFocusRef.current = {
+      index: idx,
+      nonce,
+      attempts: 0
+    };
+    schedulePendingLimitFocus();
+  }, [timeA11yLimitFocus, columnId, selectedIndex, schedulePendingLimitFocus]);
   // 是否处于归中状态
   const isCenterTimerId = React.useRef(null);
-  // 简化为直接在滚动结束时通知父组件
+  // 滚动静止后归中并同步选中
   const handleScrollEnd = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
       clearTimeout(isCenterTimerId.current);
       isCenterTimerId.current = null;
     }
-    // 做一个0.1s延时  0.1s之内没有新的滑动 则把选项归到中间 然后更新选中项
+    // 100ms 内无新滚动则归中并提交索引
     isCenterTimerId.current = setTimeout(() => {
       if (!scrollViewRef.current) return;
       const scrollTop = scrollViewRef.current.scrollTop;
-      const newIndex = getSelectedIndex(scrollTop);
-      setIsTouching(false);
-      // 调用updateIndex执行限位逻辑，获取是否触发了限位
+      const newIndex = getSelectedIndex(scrollTop, itemHeightRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+      const allowA11yFocus = !syncScrollFromPropsRef.current;
+      const shouldFocusOnScrollSettle = pendingScrollSettleFocusRef.current;
+      isTouchingRef.current = false;
       const isLimited = Boolean(updateIndex(newIndex, columnId, true));
-      // 如果没有触发限位，才执行归中逻辑
+      const hasPendingLimitFocus = pendingLimitFocusRef.current != null;
+      if (isLimited) {
+        pendingScrollSettleFocusRef.current = false;
+      }
       if (!isLimited) {
         const baseValue = newIndex * itemHeightRef.current;
         const randomOffset = Math.random() * 0.001;
         setTargetScrollTopWithScale(setTargetScrollTop, baseValue, randomOffset, lengthScaleRatioRef.current);
       }
+      if (!isLimited && hasPendingLimitFocus) {
+        pendingScrollSettleFocusRef.current = false;
+        schedulePendingLimitFocus();
+        syncScrollFromPropsRef.current = false;
+        isCenterTimerId.current = null;
+        return;
+      }
+      if (!isLimited && pendingLimitFocusRef.current == null && suppressScrollSettleFocusNonceRef.current != null) {
+        suppressScrollSettleFocusNonceRef.current = null;
+      }
+      const suppressByLimitNonce = suppressScrollSettleFocusNonceRef.current != null;
+      if (!isLimited && allowA11yFocus && shouldFocusOnScrollSettle) {
+        pendingScrollSettleFocusRef.current = false;
+        if (!suppressByLimitNonce) {
+          requestAccessibilityFocusOnView(itemRefs.current[newIndex]);
+        }
+      }
+      syncScrollFromPropsRef.current = false;
       isCenterTimerId.current = null;
     }, 100);
   };
-  // 滚动处理
+  // 滚动中：按 scrollTop 更新高亮索引
   const handleScroll = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
@@ -284,10 +491,23 @@ function PickerGroupTime(props) {
       isCenterTimerId.current = null;
     }
     const scrollTop = scrollViewRef.current.scrollTop;
-    const newIndex = getSelectedIndex(scrollTop);
+    const ih = itemHeightRef.current;
+    const newIndex = getSelectedIndex(scrollTop, ih, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+    const spi = selectedIndexPropRef.current;
+    if (newIndex !== spi) {
+      if (!syncScrollFromPropsRef.current || isTouchingRef.current) {
+        pendingScrollSettleFocusRef.current = true;
+      }
+      if (isTouchingRef.current) {
+        syncScrollFromPropsRef.current = false;
+      }
+    }
     if (newIndex !== currentIndex) {
       setCurrentIndex(newIndex);
     }
+    if (pendingLimitFocusRef.current) {
+      schedulePendingLimitFocus();
+    }
   };
   // 渲染选项
   const pickerItem = range.map((item, index) => {
@@ -296,6 +516,9 @@ function PickerGroupTime(props) {
       id: `picker-item-${columnId}-${index}`,
       ref: el => itemRefs.current[index] = el,
       className: `taro-picker__item${index === currentIndex ? ' taro-picker__item--selected' : ''}`,
+      ...(enableClickItemScroll ? {
+        onClick: () => scrollToItemId(`picker-item-${columnId}-${index}`)
+      } : {}),
       style: {
         height: PICKER_LINE_HEIGHT,
         color: index === currentIndex ? colors.itemSelectedColor || undefined : colors.itemDefaultColor || undefined
@@ -314,6 +537,10 @@ function PickerGroupTime(props) {
       height: PICKER_LINE_HEIGHT
     }
   }, `blank-bottom-${idx}`))];
+  const clickScrollViewProps = enableClickItemScroll ? {
+    scrollIntoView,
+    scrollIntoViewAlignment: 'center'
+  } : {};
   return /*#__PURE__*/jsxs(View, {
     className: "taro-picker__group",
     children: [/*#__PURE__*/jsx(View, {
@@ -332,8 +559,11 @@ function PickerGroupTime(props) {
         height: PICKER_LINE_HEIGHT * PICKER_VISIBLE_ITEMS
       },
       scrollTop: targetScrollTop,
+      ...clickScrollViewProps,
       onScroll: handleScroll,
-      onTouchStart: () => setIsTouching(true),
+      onTouchStart: () => {
+        isTouchingRef.current = true;
+      },
       onScrollEnd: handleScrollEnd,
       scrollWithAnimation: true,
       children: realPickerItems
@@ -347,65 +577,70 @@ function PickerGroupDate(props) {
     columnId,
     updateDay,
     selectedIndex = 0,
-    colors = {}
+    colors = {},
+    enableClickItemScroll = true
   } = props;
   const indicatorStyle = colors.lineColor ? getIndicatorStyle(colors.lineColor) : null;
   const [targetScrollTop, setTargetScrollTop] = React.useState(0);
+  const [scrollIntoView, scrollToItemId] = usePickerItemScrollIntoView();
   const scrollViewRef = React.useRef(null);
+  const itemRefs = React.useRef([]);
+  const selectedIndexPropRef = React.useRef(selectedIndex);
+  selectedIndexPropRef.current = selectedIndex;
+  const syncScrollFromPropsRef = React.useRef(false);
+  const pendingScrollSettleFocusRef = React.useRef(false);
   const [currentIndex, setCurrentIndex] = React.useState(selectedIndex);
-  const [isTouching, setIsTouching] = React.useState(false);
+  const isTouchingRef = React.useRef(false);
   const lengthScaleRatioRef = React.useRef(1);
+  const useMeasuredScaleRef = React.useRef(false);
   const itemHeightRef = React.useRef(PICKER_LINE_HEIGHT);
-  // 初始化时计算 lengthScaleRatio
+  // 初始化时计算 lengthScaleRatio 并判定缩放模式
   React.useEffect(() => {
     Taro.getSystemInfo({
       success: res => {
         lengthScaleRatioRef.current = calculateLengthScaleRatio(res);
+        useMeasuredScaleRef.current = resolveUseMeasuredScale(res);
+        itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
       },
       fail: () => {
-        // 失败时使用默认值 1
         lengthScaleRatioRef.current = 1;
+        useMeasuredScaleRef.current = false;
       }
     });
   }, []);
   React.useEffect(() => {
-    var _a;
-    if (process.env.TARO_PLATFORM === 'harmony') {
-      itemHeightRef.current = PICKER_LINE_HEIGHT * lengthScaleRatioRef.current;
-    } else {
-      if (scrollViewRef.current && ((_a = scrollViewRef.current) === null || _a === void 0 ? void 0 : _a.scrollHeight)) {
-        itemHeightRef.current = scrollViewRef.current.scrollHeight / scrollViewRef.current.childNodes.length;
-      } else {
-        console.warn('Height measurement anomaly');
-      }
-    }
+    itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
   }, [range.length]); // 只在range长度变化时重新计算
-  const getSelectedIndex = scrollTop => {
-    return Math.round(scrollTop / itemHeightRef.current);
-  };
-  // 当selectedIndex变化时，调整滚动位置
+  // props 的 selectedIndex 变化：滚至对应项并短时标记程序化滚动（syncScrollFromPropsRef）
   React.useEffect(() => {
-    if (scrollViewRef.current && range.length > 0 && !isTouching) {
+    if (scrollViewRef.current && range.length > 0 && !isTouchingRef.current) {
+      syncScrollFromPropsRef.current = true;
       const baseValue = selectedIndex * itemHeightRef.current;
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, undefined, lengthScaleRatioRef.current);
       setCurrentIndex(selectedIndex);
+      const tid = setTimeout(() => {
+        syncScrollFromPropsRef.current = false;
+      }, 400);
+      return () => clearTimeout(tid);
     }
   }, [selectedIndex, range]);
   // 是否处于归中状态
   const isCenterTimerId = React.useRef(null);
-  // 简化为直接在滚动结束时通知父组件
+  // 滚动静止后归中并同步选中
   const handleScrollEnd = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
       clearTimeout(isCenterTimerId.current);
       isCenterTimerId.current = null;
     }
-    // 做一个0.1s延时  0.1s之内没有新的滑动 则把选项归到中间 然后更新选中项
+    // 100ms 内无新滚动则归中并提交索引
     isCenterTimerId.current = setTimeout(() => {
       if (!scrollViewRef.current) return;
       const scrollTop = scrollViewRef.current.scrollTop;
-      const newIndex = getSelectedIndex(scrollTop);
-      setIsTouching(false);
+      const newIndex = getSelectedIndex(scrollTop, itemHeightRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+      const allowA11yFocus = !syncScrollFromPropsRef.current;
+      const shouldFocusOnScrollSettle = pendingScrollSettleFocusRef.current;
+      isTouchingRef.current = false;
       const baseValue = newIndex * itemHeightRef.current;
       const randomOffset = Math.random() * 0.001; // 随机数为了在一个项内滚动时强制刷新
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, randomOffset, lengthScaleRatioRef.current);
@@ -416,10 +651,15 @@ function PickerGroupDate(props) {
         const numericValue = parseInt(valueText.replace(/[^0-9]/g, ''));
         updateDay(isNaN(numericValue) ? 0 : numericValue, parseInt(columnId));
       }
+      pendingScrollSettleFocusRef.current = false;
+      if (allowA11yFocus && shouldFocusOnScrollSettle) {
+        requestAccessibilityFocusOnView(itemRefs.current[newIndex]);
+      }
+      syncScrollFromPropsRef.current = false;
       isCenterTimerId.current = null;
     }, 100);
   };
-  // 滚动处理
+  // 滚动中：按 scrollTop 更新高亮索引
   const handleScroll = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
@@ -427,7 +667,17 @@ function PickerGroupDate(props) {
       isCenterTimerId.current = null;
     }
     const scrollTop = scrollViewRef.current.scrollTop;
-    const newIndex = getSelectedIndex(scrollTop);
+    const ih = itemHeightRef.current;
+    const newIndex = getSelectedIndex(scrollTop, ih, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+    const spi = selectedIndexPropRef.current;
+    if (newIndex !== spi) {
+      if (!syncScrollFromPropsRef.current || isTouchingRef.current) {
+        pendingScrollSettleFocusRef.current = true;
+      }
+      if (isTouchingRef.current) {
+        syncScrollFromPropsRef.current = false;
+      }
+    }
     if (newIndex !== currentIndex) {
       setCurrentIndex(newIndex);
     }
@@ -436,7 +686,11 @@ function PickerGroupDate(props) {
   const pickerItem = range.map((item, index) => {
     return /*#__PURE__*/jsx(View, {
       id: `picker-item-${columnId}-${index}`,
+      ref: el => itemRefs.current[index] = el,
       className: `taro-picker__item${index === currentIndex ? ' taro-picker__item--selected' : ''}`,
+      ...(enableClickItemScroll ? {
+        onClick: () => scrollToItemId(`picker-item-${columnId}-${index}`)
+      } : {}),
       style: {
         height: PICKER_LINE_HEIGHT,
         color: index === currentIndex ? colors.itemSelectedColor || undefined : colors.itemDefaultColor || undefined
@@ -455,6 +709,10 @@ function PickerGroupDate(props) {
       height: PICKER_LINE_HEIGHT
     }
   }, `blank-bottom-${idx}`))];
+  const clickScrollViewProps = enableClickItemScroll ? {
+    scrollIntoView,
+    scrollIntoViewAlignment: 'center'
+  } : {};
   return /*#__PURE__*/jsxs(View, {
     className: "taro-picker__group",
     children: [/*#__PURE__*/jsx(View, {
@@ -473,8 +731,11 @@ function PickerGroupDate(props) {
         height: PICKER_LINE_HEIGHT * PICKER_VISIBLE_ITEMS
       },
       scrollTop: targetScrollTop,
+      ...clickScrollViewProps,
       onScroll: handleScroll,
-      onTouchStart: () => setIsTouching(true),
+      onTouchStart: () => {
+        isTouchingRef.current = true;
+      },
       onScrollEnd: handleScrollEnd,
       scrollWithAnimation: true,
       children: realPickerItems
@@ -490,52 +751,54 @@ function PickerGroupRegion(props) {
     updateIndex,
     selectedIndex = 0,
     // 使用selectedIndex参数，默认为0
-    colors = {}
+    colors = {},
+    enableClickItemScroll = true
   } = props;
   const indicatorStyle = colors.lineColor ? getIndicatorStyle(colors.lineColor) : null;
   const scrollViewRef = React.useRef(null);
   const [targetScrollTop, setTargetScrollTop] = React.useState(0);
+  const [scrollIntoView, scrollToItemId] = usePickerItemScrollIntoView();
   const [currentIndex, setCurrentIndex] = React.useState(selectedIndex);
-  const [isTouching, setIsTouching] = React.useState(false);
+  const isTouchingRef = React.useRef(false);
   const lengthScaleRatioRef = React.useRef(1);
+  const useMeasuredScaleRef = React.useRef(false);
   const itemHeightRef = React.useRef(PICKER_LINE_HEIGHT);
-  const isUserBeginScrollRef = React.useRef(false);
-  // 初始化时计算 lengthScaleRatio
+  const itemRefs = React.useRef([]);
+  const selectedIndexPropRef = React.useRef(selectedIndex);
+  selectedIndexPropRef.current = selectedIndex;
+  const syncScrollFromPropsRef = React.useRef(false);
+  const pendingScrollSettleFocusRef = React.useRef(false);
+  // 初始化时计算 lengthScaleRatio 并判定缩放模式
   React.useEffect(() => {
     Taro.getSystemInfo({
       success: res => {
         lengthScaleRatioRef.current = calculateLengthScaleRatio(res);
+        useMeasuredScaleRef.current = resolveUseMeasuredScale(res);
+        itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
       },
       fail: () => {
-        // 失败时使用默认值 1
         lengthScaleRatioRef.current = 1;
+        useMeasuredScaleRef.current = false;
       }
     });
   }, []);
   React.useEffect(() => {
-    var _a;
-    if (process.env.TARO_PLATFORM === 'harmony') {
-      itemHeightRef.current = PICKER_LINE_HEIGHT * lengthScaleRatioRef.current;
-    } else {
-      if (scrollViewRef.current && ((_a = scrollViewRef.current) === null || _a === void 0 ? void 0 : _a.scrollHeight)) {
-        itemHeightRef.current = scrollViewRef.current.scrollHeight / scrollViewRef.current.childNodes.length;
-      } else {
-        console.warn('Height measurement anomaly');
-      }
-    }
+    itemHeightRef.current = calculateItemHeight(scrollViewRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
   }, [range.length]); // 只在range长度变化时重新计算
-  const getSelectedIndex = scrollTop => {
-    return Math.round(scrollTop / itemHeightRef.current);
-  };
-  // 当selectedIndex变化时，调整滚动位置
+  // props 的 selectedIndex 变化：滚至对应项并短时标记程序化滚动（syncScrollFromPropsRef）
   React.useEffect(() => {
-    if (scrollViewRef.current && range.length > 0 && !isTouching) {
+    if (scrollViewRef.current && range.length > 0 && !isTouchingRef.current) {
+      syncScrollFromPropsRef.current = true;
       const baseValue = selectedIndex * itemHeightRef.current;
-      setTargetScrollTopWithScale(setTargetScrollTop, baseValue);
+      setTargetScrollTopWithScale(setTargetScrollTop, baseValue, undefined, lengthScaleRatioRef.current);
       setCurrentIndex(selectedIndex);
+      const tid = setTimeout(() => {
+        syncScrollFromPropsRef.current = false;
+      }, 400);
+      return () => clearTimeout(tid);
     }
   }, [selectedIndex, range]);
-  // 滚动结束处理
+  // 滚动静止后归中（debounce）
   const isCenterTimerId = React.useRef(null);
   const handleScrollEnd = () => {
     if (!scrollViewRef.current) return;
@@ -543,19 +806,27 @@ function PickerGroupRegion(props) {
       clearTimeout(isCenterTimerId.current);
       isCenterTimerId.current = null;
     }
-    // 做一个0.1s延时  0.1s之内没有新的滑动 则把选项归到中间 然后更新选中项
+    // 100ms 内无新滚动则归中并提交索引
     isCenterTimerId.current = setTimeout(() => {
       if (!scrollViewRef.current) return;
       const scrollTop = scrollViewRef.current.scrollTop;
-      const newIndex = getSelectedIndex(scrollTop);
-      setIsTouching(false);
+      const newIndex = getSelectedIndex(scrollTop, itemHeightRef.current, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+      const allowA11yFocus = !syncScrollFromPropsRef.current;
+      const shouldFocusOnScrollSettle = pendingScrollSettleFocusRef.current;
+      isTouchingRef.current = false;
       const baseValue = newIndex * itemHeightRef.current;
       const randomOffset = Math.random() * 0.001; // 随机数为了在一个项内滚动时强制刷新
       setTargetScrollTopWithScale(setTargetScrollTop, baseValue, randomOffset, lengthScaleRatioRef.current);
-      updateIndex(newIndex, columnId, false, isUserBeginScrollRef.current);
+      updateIndex(newIndex, columnId, false, allowA11yFocus);
+      pendingScrollSettleFocusRef.current = false;
+      if (allowA11yFocus && shouldFocusOnScrollSettle) {
+        requestAccessibilityFocusOnView(itemRefs.current[newIndex]);
+      }
+      syncScrollFromPropsRef.current = false;
+      isCenterTimerId.current = null;
     }, 100);
   };
-  // 滚动处理 - 在滚动时计算索引
+  // 滚动中：按 scrollTop 更新高亮索引
   const handleScroll = () => {
     if (!scrollViewRef.current) return;
     if (isCenterTimerId.current) {
@@ -563,7 +834,17 @@ function PickerGroupRegion(props) {
       isCenterTimerId.current = null;
     }
     const scrollTop = scrollViewRef.current.scrollTop;
-    const newIndex = getSelectedIndex(scrollTop);
+    const ih = itemHeightRef.current;
+    const newIndex = getSelectedIndex(scrollTop, ih, lengthScaleRatioRef.current, useMeasuredScaleRef.current);
+    const spi = selectedIndexPropRef.current;
+    if (newIndex !== spi) {
+      if (!syncScrollFromPropsRef.current || isTouchingRef.current) {
+        pendingScrollSettleFocusRef.current = true;
+      }
+      if (isTouchingRef.current) {
+        syncScrollFromPropsRef.current = false;
+      }
+    }
     if (newIndex !== currentIndex) {
       setCurrentIndex(newIndex);
     }
@@ -573,7 +854,11 @@ function PickerGroupRegion(props) {
     const content = rangeKey && item && typeof item === 'object' ? item[rangeKey] : item;
     return /*#__PURE__*/jsx(View, {
       id: `picker-item-${columnId}-${index}`,
+      ref: el => itemRefs.current[index] = el,
       className: `taro-picker__item${index === currentIndex ? ' taro-picker__item--selected' : ''}`,
+      ...(enableClickItemScroll ? {
+        onClick: () => scrollToItemId(`picker-item-${columnId}-${index}`)
+      } : {}),
       style: {
         height: PICKER_LINE_HEIGHT,
         color: index === currentIndex ? colors.itemSelectedColor || undefined : colors.itemDefaultColor || undefined
@@ -592,6 +877,10 @@ function PickerGroupRegion(props) {
       height: PICKER_LINE_HEIGHT
     }
   }, `blank-bottom-${idx}`))];
+  const clickScrollViewProps = enableClickItemScroll ? {
+    scrollIntoView,
+    scrollIntoViewAlignment: 'center'
+  } : {};
   return /*#__PURE__*/jsxs(View, {
     className: "taro-picker__group",
     children: [/*#__PURE__*/jsx(View, {
@@ -610,10 +899,10 @@ function PickerGroupRegion(props) {
         height: PICKER_LINE_HEIGHT * PICKER_VISIBLE_ITEMS
       },
       scrollTop: targetScrollTop,
+      ...clickScrollViewProps,
       onScroll: handleScroll,
       onTouchStart: () => {
-        setIsTouching(true);
-        isUserBeginScrollRef.current = true;
+        isTouchingRef.current = true;
       },
       onScrollEnd: handleScrollEnd,
       scrollWithAnimation: true,