Plate Slate v2restore-dom 家族閉包矩陣與刪除遺留 DOM 恢復(fù)邏輯的判定方法【免費(fèi)下載鏈接】plateRich-text editor with AI and shadcn/ui項(xiàng)目地址: https://gitcode.com/GitHub_Trending/pl/plate本文圍繞 Slate v2 遷移中對(duì)已刪除的restore-dom家族的收尾工作展開完整繼承 restore-dom 家族閉包矩陣 的核心內(nèi)容將一段被刪除的遺留代碼拆解為可逐行判定可證明、可裁斷、或被工具鏈阻塞的行為行并給出每一行的分類結(jié)論與當(dāng)前責(zé)任人。讀完后你能掌握一套可復(fù)用的方法當(dāng)一個(gè)遺留守護(hù)邏輯guard family在新運(yùn)行時(shí)架構(gòu)中失去存在前提時(shí)如何依據(jù)行為證據(jù)矩陣而非慣性將其“關(guān)閉”close而不是讓它長(zhǎng)期以模糊的幽靈狀態(tài)懸而未決。背景restore-dom 是什么以及它為什么曾經(jīng)存在在舊版v1 時(shí)代Slate React 運(yùn)行時(shí)中瀏覽器編輯輸入會(huì)產(chǎn)生一類尷尬的時(shí)序問題瀏覽器在用戶輸入期間直接修改 DOM插入文本節(jié)點(diǎn)、拆分/合并行內(nèi)節(jié)點(diǎn)等React 的重渲染rerender可能與這些瀏覽器側(cè)的 DOM 變更發(fā)生競(jìng)爭(zhēng)如果不干預(yù)React 在下一次 commit 時(shí)可能把瀏覽器剛寫入的內(nèi)容“抹掉”或造成節(jié)點(diǎn)漂移。為此舊運(yùn)行時(shí)專門設(shè)置了restore-dom家族其職責(zé)是在 React commit 落地之前把被 React 移除/新增錯(cuò)位的 DOM 節(jié)點(diǎn)恢復(fù)回去形成一個(gè) commit 前的 DOM 修復(fù)mutation replay步驟。原始實(shí)現(xiàn)位于上游 Slate 倉(cāng)庫的以下兩個(gè)文件注意這兩個(gè)路徑屬于上游 legacy slate 倉(cāng)庫不在當(dāng)前 Plate 倉(cāng)庫內(nèi)此處僅作為來源說明packages/slate-react/src/components/restore-dom/restore-dom.tsxpackages/slate-react/src/components/restore-dom/restore-dom-manager.ts該家族的行為特征可以歸納為四件相互耦合的事用戶輸入期間的變更緩沖只在真正的用戶輸入期間緩沖瀏覽器對(duì) DOM 的修改其門控變量為receivedUserInputcommit 前恢復(fù)通過 mutation observer 配合getSnapshotBeforeUpdate生命周期在 React commit 前恢復(fù)被移除/新增的 DOM 節(jié)點(diǎn)組合輸入IME敏感跳過在 IME 組合輸入composition期間顯式跳過characterData類變更的恢復(fù)避免干擾正在進(jìn)行的拼音/假名等組合過程Android 專屬激活整個(gè) restore-dom 包裝器僅在 Android 上激活I(lǐng)S_ANDROID守衛(wèi)。這正是矩陣分析要處理的對(duì)象這個(gè)家族不是“一個(gè)功能”而是三種性質(zhì)不同的防護(hù)機(jī)制的混合體。任務(wù)定義把“被刪除的家族”拆成可證明的行為行原始文檔定義的目的一句話說清把被刪除的遺留restore-dom家族拆分成一行行可以被證明proved、被裁斷cut、或被顯式標(biāo)記為工具鏈阻塞tooling-blocked的行為行behavior rows。文檔中標(biāo)記的“當(dāng)前責(zé)任人”current owners文件為packages/slate-react/src/components/editable.tsxpackages/slate-react/src/plugin/react-editor.tspackages/slate-dom/src/bridge.tspackages/slate-react/test/surface-contract.tsx需要如實(shí)說明證據(jù)邊界從當(dāng)前倉(cāng)庫結(jié)構(gòu)看上述slate-react/slate-dom組件文件并不包含在當(dāng)前 checkout 中當(dāng)前倉(cāng)庫核心源碼位于 packages/slate/src原文檔中的這些位置記錄的是 v2 工作區(qū)的文件路徑本文只將其作為該閉包矩陣的責(zé)任劃分記錄轉(zhuǎn)述不作為本倉(cāng)庫中可點(diǎn)擊的源碼引用。本倉(cāng)庫內(nèi)可以驗(yàn)證的錨點(diǎn)是平臺(tái)檢測(cè)工具含IS_ANDROID仍以純工具形式從 slate-dom 工具橋接層 導(dǎo)出——也就是說Android 檢測(cè)從“一個(gè)守護(hù)包裝器的激活開關(guān)”退化成了“一個(gè)普通的運(yùn)行時(shí)判斷工具”。文檔同時(shí)聲明其歷史批注性質(zhì)historical batch note意味著實(shí)時(shí)的閉包讀數(shù)現(xiàn)在已折疊進(jìn) release-file-review-ledger.md。在該臺(tái)賬中restore-dom.tsx的行確實(shí)留有記錄標(biāo)記為adapted說明為 React 19 落地了 null-aware 的 ref 類型而不改變 restore 時(shí)序這與矩陣文檔的“歷史批注”定位相互印證。行為矩陣五條行為行及其分類結(jié)論這是原文檔的核心表格完整繼承如下“Current read / 當(dāng)前讀數(shù)”與“owner / gap”列按原文語義整理遺留行為遺留機(jī)制當(dāng)前運(yùn)行時(shí)讀數(shù)分類當(dāng)前責(zé)任人 / 缺口只在真正用戶輸入期間緩沖瀏覽器 DOM 變更receivedUserInput門控當(dāng)前運(yùn)行時(shí)不再使用同一套 commit 前 DOM 重放生命周期justified-omission有依據(jù)的省略非當(dāng)前生命周期的守護(hù)見 restore-dom 是重渲染時(shí)代的守護(hù)而非 v2 當(dāng)前運(yùn)行時(shí)需求在 React commit 前恢復(fù)被移除/新增的 DOM 節(jié)點(diǎn)mutation observer getSnapshotBeforeUpdate當(dāng)前運(yùn)行時(shí)改為在input/compositionend上直接做 root 持有的 DOM commit而非 commit 前 DOM 重放可見行為行在當(dāng)前接縫上均為綠通過justified-omission被“當(dāng)前 root 持有 DOM commit 直接行為行”所取代在組合輸入期間忽略characterData變更恢復(fù)restore manager 中的顯式跳過主要 IME 行為行在當(dāng)前承載行為的表面上為綠且不依賴該家族covered-by-current-proof已被當(dāng)前證明覆蓋當(dāng)前 IME 證明軌道proof lanes擁有此用戶可見行為restore-dom 包裝器僅 Android 激活I(lǐng)S_ANDROID守衛(wèi)當(dāng)前 Android 行為行在 placeholder、無 FEFF placeholder、行內(nèi)邊緣、void 邊緣、split/join 場(chǎng)景下均為綠且不需要該包裝器covered-by-current-proofAndroid 證明的寬度窄于完整的遺留矩陣但該守衛(wèi)已不再作為獨(dú)立未決家族存在更新前恢復(fù)、更新后清除、然后恢復(fù)觀察class 生命周期契約當(dāng)前運(yùn)行時(shí)不再依賴這套重渲染時(shí)代的生命周期來維持編輯器可見行為的正確性justified-omission舊的生命周期形狀不是當(dāng)前架構(gòu)契約對(duì)這張矩陣有三個(gè)讀法要點(diǎn)分類詞匯只有兩類且都有明確語義。justified-omission表示“該機(jī)制所服務(wù)的生命周期在新架構(gòu)中已經(jīng)不存在刪除它有明確依據(jù)”covered-by-current-proof表示“該機(jī)制守護(hù)的用戶可見行為仍然重要但已有當(dāng)前運(yùn)行時(shí)上的直接行為測(cè)試行覆蓋它因此舊機(jī)制可以關(guān)閉而行為責(zé)任不丟失”。矩陣?yán)餂]有一行落入“未決/阻塞”狀態(tài)這正是該批注可以宣告收尾的前提。每一行都必須能指認(rèn)“誰現(xiàn)在擁有這個(gè)行為”。即使分類是justified-omission表格也要求寫明行為去哪了例如“被當(dāng)前 root 持有 DOM commit 取代”避免“刪了代碼但行為責(zé)任懸空”。證據(jù)行behavior rows是判定單位而不是文件。整個(gè)矩陣的組織原則就是不以“restore-dom.tsx 這個(gè)文件刪沒刪”為單位而以“某一條用戶可見行為有沒有證明或替代”為單位。硬讀數(shù)被刪除的家族不是一個(gè)東西原文檔的 “Current Hard Read” 小節(jié)給出了整個(gè)收尾推理的支點(diǎn)被刪除的家族不是“一個(gè)東西”而是混合了三類機(jī)制——僅 Android 的運(yùn)行時(shí)防護(hù)圍繞 React commit 時(shí)機(jī)的 mutation 重放對(duì)組合輸入敏感的護(hù)欄如果把它當(dāng)作“一個(gè)功能”來討論就會(huì)陷入無意義的爭(zhēng)論要/不要一個(gè)整體。拆成行為行之后每一行都能獨(dú)立給出上表中的分類。同一小節(jié)還給出了當(dāng)前證明棧proof stack已經(jīng)說明的事實(shí)主要 IME 行在不依賴restore-dom的情況下是綠的瞬態(tài) DOM 點(diǎn)焦點(diǎn)失敗transient DOM-point focus failure已經(jīng) fail-closed失敗即收斂到安全行為而不是靜默漂移。由此得出的新讀數(shù)restore-dom曾經(jīng)守護(hù)的那些承載行為的行要么在當(dāng)前表面上直接為綠要么已不再是當(dāng)前運(yùn)行時(shí)生命周期所必需。配合 restore-dom 是重渲染時(shí)代守護(hù)的解法文檔當(dāng)前證明的具體范圍可以進(jìn)一步展開為五條直接證據(jù)行當(dāng)前直接證明行覆蓋的舊守護(hù)場(chǎng)景主要 IME 表面組合輸入敏感的characterData恢復(fù)跳過焦點(diǎn)恢復(fù) 瞬態(tài) DOM 點(diǎn)缺口 fail-closed焦點(diǎn)/DOM 點(diǎn)漂移期間的恢復(fù)行為Firefox 卸載后拖放清理瀏覽器側(cè)結(jié)構(gòu)性 DOM 變更清理Firefox 表格多區(qū)間選擇保持選擇狀態(tài)在 DOM 變更下的保持Chromium 與 Android 上結(jié)構(gòu)化 Enter/Backspace 的 split-join churn結(jié)構(gòu)性瀏覽器 DOM 變更現(xiàn)由編輯器自持的 keydown 路徑覆蓋該解法文檔明確這些行正是“若新運(yùn)行時(shí)仍依賴 mutation-replay 模型restore-dom的缺失會(huì)顯形為可見損壞”的地方——它們?nèi)G說明依賴已經(jīng)真的不存在了。當(dāng)前運(yùn)行時(shí)契約Root 持有的 DOM Commit 取代 Commit 前重放理解矩陣結(jié)論的關(guān)鍵是理解 v2 的瀏覽器側(cè)模型與舊模型的本質(zhì)差異。對(duì)照原文檔與其解法文檔的描述舊模型restore-dom 存在的前提瀏覽器修改 DOM → React 重渲染與之競(jìng)爭(zhēng) → 需要一個(gè) commit 前的修復(fù)步驟把 DOM“放回去”等 React 落地。整套receivedUserInput門控、getSnapshotBeforeUpdate快照、class 生命周期更新前恢復(fù)、更新后清除、恢復(fù)觀察都服務(wù)于這條鏈路。當(dāng)前 v2 模型編輯器 root 直接持有以下職責(zé)掛載mount選擇同步selection sync在原生input事件上把 DOM commit 回編輯器快照在compositionend事件上把 DOM commit 回編輯器快照。也就是說DOM 變化不再需要“在 React commit 前被修復(fù)”——編輯根節(jié)點(diǎn)自己就是 DOM→模型提交的所有者。這是矩陣中兩條justified-omission緩沖門控、class 生命周期契約成立的根本原因守護(hù)它們所針對(duì)的那條生命周期在 v2 里已經(jīng)不存在。對(duì)解法文檔給出的行為歸口可以總結(jié)為一個(gè)誠(chéng)實(shí)的分割honest split焦點(diǎn)期瞬態(tài) DOM 點(diǎn)缺口由當(dāng)前 fail-closed 證明覆蓋組合輸入敏感的主要 IME 行為由當(dāng)前直接 IME 行覆蓋Enter/Backspace 的結(jié)構(gòu)性瀏覽器變更現(xiàn)由編輯器自持的 keydown 路徑覆蓋在 React commit 前重放任意瀏覽器/外部 DOM 變更不再默認(rèn)為當(dāng)前運(yùn)行時(shí)的頭等契約。閉包讀數(shù)兩種關(guān)閉方式原文檔的 “Closure Read” 給出該家族的最終收尾形態(tài)它實(shí)際上給出了關(guān)閉一個(gè)遺留家族僅有的兩種合法方式行為行在當(dāng)前證明表面上已被覆蓋covered-by-current-proof——對(duì)應(yīng) IME 行為行與 Android 行為行重渲染時(shí)代的 mutation 重放生命周期被顯式標(biāo)記為“非當(dāng)前”justified-omission——對(duì)應(yīng)receivedUserInput緩沖門控與 class 生命周期契約。注意第二種方式的關(guān)鍵詞是“顯式”explicitly不證明它“錯(cuò)了”而是證明它服務(wù)的生命周期不再是當(dāng)前架構(gòu)契約。這避免了兩種常見的壞收尾要么永遠(yuǎn)留著一個(gè)沒人敢刪的幽靈家族要么在沒有任何分類記錄的情況下悄悄刪掉。可復(fù)用規(guī)則判定遺留守護(hù)是否該關(guān)閉該閉包矩陣配套沉淀了一條可復(fù)用規(guī)則引自 解法文檔適用于任何“舊守護(hù)修復(fù)瀏覽器 DOM 漂移 vs 新運(yùn)行時(shí)”的裁斷當(dāng)一個(gè)遺留守護(hù)legacy guard存在的目的是在 React commit 前修復(fù)瀏覽器 DOM 漂移時(shí)先問新運(yùn)行時(shí)是否還有同樣的生命周期如果新運(yùn)行時(shí)直接把 DOM commit 回模型且承載行為的可見行為行為行為行為行為行都是綠的就不要因?yàn)閼T性而把舊守護(hù)家族一直開著。正確動(dòng)作是直接關(guān)閉承載行為的行為行并把舊的、生命周期特定的修復(fù)機(jī)器標(biāo)記為“非當(dāng)前守護(hù)”non-current guard而不是把它當(dāng)成不朽的阻塞項(xiàng)immortal blocker。用一句話概括其方法論內(nèi)核守護(hù)的存廢由“它服務(wù)的生命周期是否還存在”決定行為的存廢由“當(dāng)前證明行是否綠”決定——兩者都要顯式記錄缺一不可。相關(guān)文檔索引restore-dom 家族閉包矩陣本文主體源文檔restore-dom 是重渲染時(shí)代守護(hù)而非 v2 當(dāng)前運(yùn)行時(shí)需求配套解法記錄release-file-review-ledger.md當(dāng)前實(shí)時(shí)的閉包讀數(shù)已折疊至此刪除閉包協(xié)議 rollout閉包分類術(shù)語的使用語境slate-dom 工具導(dǎo)出含 IS_ANDROID 等平臺(tái)檢測(cè)的當(dāng)前倉(cāng)庫錨點(diǎn)適用前提說明本文所述的“行為行為行綠/通過”均為源文檔在其記錄時(shí)點(diǎn)對(duì)證明棧的讀數(shù)轉(zhuǎn)述屬于該團(tuán)隊(duì)維護(hù)的文檔事實(shí)不代表對(duì)任意檢出版本的實(shí)時(shí)斷言原文檔中的 legacy 源碼路徑指向上游 Slate 倉(cāng)庫current owners文件路徑指向 v2 工作區(qū)二者均不在本倉(cāng)庫可點(diǎn)擊范圍內(nèi)引用時(shí)請(qǐng)以其在源文檔中的原始定位為準(zhǔn)。【免費(fèi)下載鏈接】plateRich-text editor with AI and shadcn/ui項(xiàng)目地址: https://gitcode.com/GitHub_Trending/pl/plate創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考