feat(List): add scroller prop (#12154)

packages/vant/src/list/List.tsx

@@ -1,10 +1,12 @@
 import {
   ref,
   watch,
+  computed,
   nextTick,
   onUpdated,
   onMounted,
   defineComponent,
+  type PropType,
   type ExtractPropTypes,
 } from 'vue';
 
@@ -36,6 +38,7 @@ export const listProps = {
   loading: Boolean,
   disabled: Boolean,
   finished: Boolean,
+  scroller: Object as PropType<Element>,
   errorText: String,
   direction: makeStringProp<ListDirection>('down'),
   loadingText: String,
@@ -59,6 +62,7 @@ export default defineComponent({
     const placeholder = ref<HTMLElement>();
     const tabStatus = useTabStatus();
     const scrollParent = useScrollParent(root);
+    const scroller = computed(() => props.scroller || scrollParent.value);
 
     const check = () => {
       nextTick(() => {
@@ -75,7 +79,7 @@ export default defineComponent({
 
         const { direction } = props;
         const offset = +props.offset;
-        const scrollParentRect = useRect(scrollParent);
+        const scrollParentRect = useRect(scroller);
 
         if (!scrollParentRect.height || isHidden(root)) {
           return;
@@ -170,7 +174,7 @@ export default defineComponent({
     useExpose<ListExpose>({ check });
 
     useEventListener('scroll', check, {
-      target: scrollParent,
+      target: scroller,
       passive: true,
     });
 

packages/vant/src/list/README.md

@@ -177,6 +177,7 @@ export default {
 | immediate-check | Whether to check loading position immediately after mounted | _boolean_ | `true` |
 | disabled | Whether to disable the load event | _boolean_ | `false` |
 | direction | Scroll direction, can be set to `up` | _string_ | `down` |
+| scroller `v4.6.4` | Specifies the node that needs to listen for scroll events, defaults to the nearest parent scroll node | _Element_ | - |
 
 ### Events
 

packages/vant/src/list/README.zh-CN.md

@@ -192,6 +192,7 @@ export default {
 | immediate-check | 是否在初始化时立即执行滚动位置检查 | _boolean_ | `true` |
 | disabled | 是否禁用滚动加载 | _boolean_ | `false` |
 | direction | 滚动触发加载的方向，可选值为 `up` | _string_ | `down` |
+| scroller `v4.6.4` | 指定需要监听滚动事件的节点，默认为最近的父级滚动节点 | _Element_ | - |
 
 ### Events