feat: 新增 useDirtyTracker Hook — 脏状态追踪

支持数组/表单'修改后才显示保存按钮'模式:
- isDirty(key, currentItem): 判断指定key是否相对上次保存有变更
- markClean(key, item): 标记为已保存,隐藏保存按钮
- removeItem(key): 清理已删除项的追踪记录
This commit is contained in:
aiyimickey 2026-07-13 16:41:10 +08:00
parent 7ac52a8790
commit 47661c31f1
2 changed files with 47 additions and 0 deletions

1
ui/hooks/index.ts Normal file
View File

@ -0,0 +1 @@
export { useDirtyTracker } from './useDirtyTracker'

View File

@ -0,0 +1,46 @@
'use client'
import { useState, useRef } from 'react'
/**
* Hook "修改后才显示保存按钮"
*
* @example
* const { isDirty, markClean, removeItem } = useDirtyTracker()
* {items.map(item => (
* <div key={item.id}>
* <input onChange={...} />
* {isDirty(item.id, item) && <button onClick={save}></button>}
* </div>
* ))}
* // 保存成功后: markClean(id, savedItem)
* // 删除时: removeItem(id)
*/
export function useDirtyTracker() {
const savedMap = useRef<Map<string, string>>(new Map())
/**
* key markClean
* markClean key dirty
*/
const isDirty = (key: string, current: unknown): boolean => {
const saved = savedMap.current.get(key)
if (saved === undefined) return true // 从未保存过 → dirty
return saved !== JSON.stringify(current)
}
/**
* key "已保存" dirty
*/
const markClean = (key: string, item: unknown): void => {
savedMap.current.set(key, JSON.stringify(item))
}
/**
* key
*/
const removeItem = (key: string): void => {
savedMap.current.delete(key)
}
return { isDirty, markClean, removeItem }
}