每天,我們都在和各種文件打交道,PRD、技術方案、個人筆記等等等。
其實文件排版有很多學問,就像我,對排版有強迫症,見不得英文與中文之間不加空格。
所以,最近在做這麼一個谷歌擴充套件外掛 chrome-extension-text-formatting,透過谷歌擴充套件,快速將選中文字,格式化為符合 中文文案排版指北 的文字。
emmm,什麼是排版指南?簡單來說它的目的在於統一中文文案、排版的相關用法,降低團隊成員之間的溝通成本,增強網站氣質。
舉個例子:
中英文之間需要增加空格
正確:
在 LeanCloud 上,資料儲存是圍繞
AVObject
進行的。
錯誤:
在LeanCloud上,資料儲存是圍繞
AVObject
進行的。在 LeanCloud上,資料儲存是圍繞
AVObject
進行的。
完整的正確用法:
在 LeanCloud 上,資料儲存是圍繞
AVObject
進行的。每個AVObject
都包含了與 JSON 相容的 key-value 對應的資料。資料是 schema-free 的,你不需要在每個AVObject
上提前指定存在哪些鍵,只要直接設定對應的 key-value 即可。
例外:「豆瓣FM」等產品名詞,按照官方所定義的格式書寫。
中文與數字之間需要增加空格
正確:
今天出去買菜花了 5000 元。
錯誤:
今天出去買菜花了 5000元。
今天出去買菜花了5000元。
當然,整個排版規範不僅僅侷限於此,上面只是簡單列出部分規範內容。而且,這玩意屬於建議,很難強迫推廣開來。所以,我就想著實現這麼一個谷歌外掛擴充套件,一鍵實現選中文字的格式化。
看個示意圖:
適用於各種文字編輯框,當然 Excel 也可以:
當然,這都不是本文的重點。
相容語雀文件遇到的異常場景
因為各個文件平臺存在一定的差異性,所以在擴充套件的製作過程,需要去相容不同的文件平臺(當然,更多的是我自己比較常用的一些文件平臺,譬如谷歌文件、語雀、有道雲、Github 等等)。
整體來說,整個擴充套件的功能非常簡單,一個極簡流程如下:
需要注意的是,上面的操作,大部分都是基於插入到頁面的 JavaScript 指令碼檔案進行執行。
在相容語雀文件的時候,遇到了這麼個有趣的場景。
在上面的第 4 步執行完畢後,在我們對替換後的文字進行任意操作時,譬如重新獲焦、重新編輯等,被修改的文字都會被進行替換復原,復原成修改前的狀態!
什麼意思呢?看看下面這張實際的截圖:
總結一下,語雀這裡這個操作是什麼意思呢?
在指令碼手動替換掉原選取檔案後,當再次獲焦文字,修改的內容再會被複原。
在一番測試後,我理清了語雀文件的邏輯:
- 如果是使用者正常輸入內容,透過鍵盤敲入內容,或者正常的複製貼上,文件可以被正常修改,被儲存;
- 如果文件內容的修改是透過指令碼插入、替換,或者文件內容的修改是透過控制檯手動修改 DOM,文件的內容都將會被複原;
- 利用指令碼對內容進行任意修改後,即便不做任何操作,直接點選儲存按鈕,文件仍然會被複原為操作前的版本;
Oh,這個功能確實是非常的有意思。它的強悍之處在於,它能夠識別出內容的修改是常規正常操作,還是指令碼、控制檯修改等非常規操作。並且在非常規操作之後,回退到最近一次的正常操作版本。
那麼,語雀它是如何做到這一點的呢?
由於線上編譯混淆後的程式碼比較難以斷點除錯,所以我們大膽的猜測一下,如果我們需要去實現一個類似的功能,可能從什麼方向入手。
MutationObserver 實現文件內容堆疊儲存
首先,我們肯定需要用到 MutationObserver。
MutationObserver 是一個 JavaScript API,用於監視 DOM 的變化。它提供了一種非同步觀察 DOM 樹的能力,並在發生變化時觸發回撥函式。
我們來構建一個線上文件的最小化場景:
<div id="g-container" contenteditable>
這是 Web 雲文件的一段內容,如果直接編輯,可以編輯成功。如果使用控制檯修改,資料將會被恢復。
</div>
#g-container {
width: 400px;
padding: 20px;
line-height: 2;
border: 2px dashed #999;
}
這裡,我們利用 HTML 的 contenteditable 屬性,實現了一個可編輯的 DIV 框:
接下來,我們就可以利用 MutationObserver,實現對這個 DOM 元素的監聽,實現每當此元素的內容發生改變,就觸發 MutationObserver 的事件回撥,並且透過一個陣列,記錄下每一次元素改動的結果。
其大致程式碼如下:
const targetElement = document.getElementById("g-container");
// 記錄初始資料
let cacheInitData = '';
function observeElementChanges(element) {
const changes = []; // 儲存變化的陣列
const targetElementCache = element.innerText;
// 快取每次的初始資料
cacheInitData = targetElementCache;
// 建立 MutationObserver 例項
const observer = new MutationObserver((mutationsList, observer) => {
// 檢查當前是否存在焦點
mutationsList.forEach((mutation) => {
console.log('observer', observer);
const { type, target, addedNodes, removedNodes } = mutation;
let realtimeText = "";
const change = {
type,
target,
addedNodes: [...addedNodes],
removedNodes: [...removedNodes],
realtimeText,
};
changes.push(change);
});
console.log("changes", changes);
});
// 配置 MutationObserver
const config = { childList: true, subtree: true, characterData: true };
// 開始觀察元素的變化
observer.observe(element, config);
}
observeElementChanges(targetElement);
上面的程式碼,閱讀起來需要一點點時間。但是其本質是非常好理解的,我大致將其核心步驟列舉一下:
-
建立一個 MutationObserver 例項來觀察指定 DOM 元素的變化
-
定義一個配置物件
config
,用於指定觀察的選項。在這個例子中,配置物件中設定了childList: true
表示觀察子節點的變化subtree: true
表示觀察所有後代節點的變化characterData: true
表示觀察節點文字內容的變化
-
將變化的資訊儲存在
changes
陣列中 -
changes
陣列中的每個元素記錄了一次 DOM 變化的資訊。每個變化物件包含以下屬性:type
:表示變化的型別,可以是"attributes"
(屬性變化)、"characterData"
(文字內容變化)或"childList"
(子節點變化)。target
:表示發生變化的目標元素。addedNodes
:一個包含新增節點的陣列,表示在變化中新增的節點。removedNodes
:一個包含移除節點的陣列,表示在變化中移除的節點。realtimeText
:實時文字內容,可以根據具體需求進行設定。
如此一來,我們嘗試編輯 DOM 元素,開啟控制檯,看看每次 changes 輸出了什麼內容:
可以發現,每一次當 DIV 內的內容被更新,都會觸發一次 MutationObserver 的回撥。
我們詳細展開陣列中的兩處進行說明:
其中 type 表示這次觸發的是 MutationObserver 配置的 config 中的哪一類變化,命中了 characterData,也就是上面提到的文字內容的變化。而 addedNodes
和 removeDNodes
都為空,說明沒有結構上的變化。
兩組資料唯一的變化在於 realtimeText
我們利用了這個值記錄了可編輯 DOM 元素內文字值內容。
- 第一次刪除了一個句號
。
,所以realtimeText
文字相比初始文字少了個句號 - 二次操作刪除了一個
復
字,所以realtimeText
文字相比初始文字少了復。
後面的資料依次類推。可以看到,有了這個資訊,其實我們相當於能夠實現整個 DOM 結構的操作堆疊!
在此基礎上,我們可以在整個監聽之前,在 changes
陣列中首先壓入最開始未經過任何操作的資料。這也就意味著我們有能力將資料恢復到使用者的操作過程中的任意一步。
利用特徵狀態,識別使用者是否是手動輸入
有了上面的changes
陣列,我們相當於有了使用者操作的每一步的堆疊資訊。
接下的核心就在於我們應該如何去運用它們。
在語雀這個例子中,它的核心點在於:
它能夠識別出內容的修改是常規正常操作,還是指令碼、控制檯修改等非常規操作。並且在非常規操作之後,回退到最近一次的正常操作版本。
因此,我們接下來探索的問題就變成了如何識別一個可輸入編輯框,它的內容修改是正常輸入修改,還是非正常輸入修改。
譬如,思考一下,當使用者正常輸入或者複製貼上內容到編輯框,應該會有什麼特徵資訊:
- 可以透過
document.activeElement
拿到當前頁面獲焦的元素,因此可以在每次觸發 Mutation 變化的時,多儲存一份當前的獲焦元素資訊,對比內容被修改時的頁面獲焦元素是否是當前輸入框 - 嘗試判斷輸入框的獲焦狀態,可以透過監聽
foucs
、blur
獲焦及失焦等事件進行判斷 - 使用者當文字內容改變時,是否有經過觸發過鍵盤事件,譬如
keydown
事件 - 使用者當文字內容改變時,是否有經過觸發過鍵盤事件的貼上
paste
事件 - 對於直接修改控制檯,則可能是除了文字內容外,有 DOM 子樹的其他變化,也就是會觸發 Mutation 的
childList
變化事件
有了上面的思路,下面我們嘗試一下,為了儘可能讓 DEMO 好理解,我們稍微簡化需求,實現:
- 一個輸入框,使用者正常輸入可以改變內容
- 當輸入框內容透過控制檯進行修改,則當元素再次獲焦時,恢復到最近一次的手動修改記錄
- 如果(2)找不到最近一次的手動修改記錄,將資料恢復到初始狀態
基於此,下面我給出大致的虛擬碼:
<div id="g-container" contenteditable>這是 Web 雲文件的一段內容,如果直接編輯,可以編輯成功。如果使用控制檯修改,資料將會被恢復。</div>
const targetElement = document.getElementById("g-container");
// 記錄初始資料
let cacheInitData = '';
// 資料復位標誌位
let data_fixed_flag = false;
// 復位快取物件
let cacheObservingObject = null;
let cacheContainer = null;
let cacheData = '';
function eventBind() {
targetElement.addEventListener('focus', (e) => {
if (data_fixed_flag) {
cacheContainer.innerText = cacheData;
cacheObservingObject.disconnect();
observeElementChanges(targetElement);
data_fixed_flag = false;
}
});
}
function observeElementChanges(element) {
const changes = []; // 儲存變化的陣列
const targetElementCache = element.innerText;
// 快取每次的初始資料
cacheInitData = targetElementCache;
// 建立 MutationObserver 例項
const observer = new MutationObserver((mutationsList, observer) => {
mutationsList.forEach((mutation) => {
// console.log('observer', observer);
const { type, target, addedNodes, removedNodes } = mutation;
let realtimeText = "";
if (type === "characterData") {
realtimeText = target.data;
}
const change = {
type,
target,
addedNodes: [...addedNodes],
removedNodes: [...removedNodes],
realtimeText,
activeElement: document.activeElement
};
changes.push(change);
});
let isFixed = false;
let container = null;
for (let i = changes.length - 1; i >= 0; i--) {
const item = changes[i];
// console.log('i', i);
if (item.activeElement === element) {
if (isFixed) {
cacheData = item.realtimeText;
}
break;
} else {
if (!isFixed) {
isFixed = true;
container = item.target.nodeType === 3 ? item.target.parentElement : item.target;
cacheContainer = container;
data_fixed_flag = true;
}
}
}
if (data_fixed_flag && cacheData === '') {
cacheData = cacheInitData;
}
cacheObservingObject = observer;
});
// 配置 MutationObserver
const config = { childList: true, subtree: true, characterData: true };
// 開始觀察元素的變化
observer.observe(element, config);
eventBind();
// 返回停止觀察並返回變化陣列的函式
return () => {
observer.disconnect();
return changes;
};
}
observeElementChanges(targetElement);
簡單解釋一下,大致流程如下
-
observeElementChanges 上文已經出現過,核心在於記錄每一次 DOM 元素的變化,將變化內容記錄在
changes
陣列中- 多記錄了一個
activeElement
,表示每次 DOM 元素髮生變化時,頁面的焦點元素
- 多記錄了一個
-
每次
changes
更新後,倒序遍歷一次changes
陣列- 如果當前頁面獲焦元素與當前發生變化的 DOM 元素不是同一個元素,則認為是一次非法修改,記錄兩個標誌位
isFixed
和data_fixed_flag
,此時繼續向前尋找最近一次正常修改記錄 isFixed
用於向前尋找最近一次正常修改記錄後,將最近一次修改的堆疊資訊進行儲存
- 如果當前頁面獲焦元素與當前發生變化的 DOM 元素不是同一個元素,則認為是一次非法修改,記錄兩個標誌位
-
data_fixed_flag
標誌位用於當元素被再次獲焦時(觸發 focus 事件),根據標誌位判斷是否需要回滾恢復資料
OK,此時,我們來看看整體效果:
這樣,我們就成功的實現了識別非正常操作,並且恢復到上一次正常資料。
當然,實際場景肯定比這個複雜,並且需要考慮更多的細節,這裡為了整體的可理解性,簡化了整個 DEMO 的表達。
完整的 DEMO 效果,你可以戳這裡體驗:[CodePen Demo -- Editable Text Fixed]
一些思考
至於這個功能有什麼用?這個就見仁見智了,至少對於開發擴充套件外掛的我而言,是一個非常棘手的問題,當然從語雀的角度而言,更多也許是從安全方面進行考量的。
當然,我們不應該侷限於這個場景,思考一下,這個方案其實可以應用在非常多其它場景,舉個例子:
- 前端頁面水印,實現當水印 DOM 的樣式、結構、或者內容被篡改時,立即進行水印恢復
當然,破解起來也有一些方式,對於擴充套件外掛而言,我可以透過更早的向頁面注入我的 content script
,在頁面載入渲染前,對全域性的 MutationObserver 物件進行劫持。
總而言之,可以透過本文提供的思路,嘗試進行更多有意思的前端互動限制。
最後
好了,本文到此結束,希望對你有幫助 ?
想 Get 到最有意思的 CSS 資訊,千萬不要錯過我的公眾號 -- iCSS前端趣聞 ?
更多精彩 CSS 技術文章彙總在我的 Github -- iCSS ,持續更新,歡迎點個 star 訂閱收藏。
如果還有什麼疑問或者建議,可以多多交流,原創文章,文筆有限,才疏學淺,文中若有不正之處,萬望告知。