feat: 增加 saveScrollPositionIgnoreNodeIds 属性以支持忽略特定元素的滚动位置缓存

README.md

@@ -373,6 +373,12 @@ If your components share screen scroll container, `document.body` or `document.d
 <KeepAlive saveScrollPosition="screen" />
 ```
 
+If you need to ignore scroll position caching for specific elements, you can use the `saveScrollPositionIgnoreNodeIds` prop to specify a list of element IDs to ignore
+
+```javascript
+<KeepAlive saveScrollPositionIgnoreNodeIds={['header', 'sidebar']} />
+```
+
 ---
 
 ## Principle

README_CN.md

@@ -373,6 +373,12 @@ class App extends Component {
 <KeepAlive saveScrollPosition="screen" />
 ```
 
+如果你需要忽略某些特定元素的滚动位置缓存，可以通过 `saveScrollPositionIgnoreNodeIds` 属性指定要忽略的元素 ID 列表
+
+```javascript
+<KeepAlive saveScrollPositionIgnoreNodeIds={['header', 'sidebar']} />
+```
+
 ---
 
 ## 原理概述

index.d.ts

@@ -20,6 +20,7 @@ export interface KeepAliveProps {
   autoFreeze?: boolean
   wrapperProps?: DivProps
   contentProps?: DivProps
+  saveScrollPositionIgnoreNodeIds?: string[]
   [key: string]: any
 }
 

src/core/KeepAlive.js

@@ -106,7 +106,7 @@ class KeepAlive extends Component {
 
   // DOM 操作将实际内容移出占位元素
   eject = (willUnactivate = true) => {
-    const { id, _helpers } = this.props
+    const { id, _helpers, saveScrollPositionIgnoreNodeIds } = this.props
     const cache = _helpers.getCache(id)
     const nodesNeedToSaveScrollPosition = flatten(
       flatten([this.props.saveScrollPosition]).map((flag) => {
@@ -127,7 +127,10 @@ class KeepAlive extends Component {
       if (willUnactivate && nodesNeedToSaveScrollPosition.length > 0) {
         // 保存该节点下各可滚动元素的滚动位置
         cache.revertScrollPos = saveScrollPosition(
-          nodesNeedToSaveScrollPosition
+          nodesNeedToSaveScrollPosition,
+          {
+            ignoreNodeIds: saveScrollPositionIgnoreNodeIds,
+          }
         )
       }
 

src/helpers/saveScrollPosition.js

@@ -28,8 +28,12 @@ function getScrollableNodes(from) {
   )
 }
 
-export default function saveScrollPosition(from) {
-  const nodes = [...new Set([...flatten(from.map(getScrollableNodes))])]
+export default function saveScrollPosition(from, options = {}) {
+  const { ignoreNodeIds = [] } = options
+
+  const nodes = [...new Set([...flatten(from.map(getScrollableNodes))])].filter(
+    (node) => !ignoreNodeIds.includes(node.id)
+  )
 
   const saver = nodes.map((node) => [
     node,