亚洲乱码中文字幕综合,中国熟女仑乱hd,亚洲精品乱拍国产一区二区三区,一本大道卡一卡二卡三乱码全集资源,又粗又黄又硬又爽的免费视频

基于 Immutable.js 實現(xiàn)撤銷重做功能的實例代碼

 更新時間:2018年03月01日 10:09:48   投稿:mrr  
這篇文章主要介紹了基于 Immutable.js 實現(xiàn)撤銷重做功能及一些需要注意的地方,需要的朋友可以參考下

瀏覽器的功能越來越強大,許多原來由其他客戶端提供的功能漸漸轉移到了前端,前端應用也越來越復雜。許多前端應用,尤其是一些在線編輯軟件,運行時需要不斷處理用戶的交互,提供了撤消重做功能來保證交互的流暢性。不過為一個應用實現(xiàn)撤銷重做功能并不是一件容易的事情。 Redux官方文檔中 介紹了如何在 redux 應用中實現(xiàn)撤銷重做功能?;?redux 的撤銷功能是一個自頂向下的方案:引入 redux-undo 之后所有的操作都變?yōu)榱恕缚沙蜂N的」,然后我們不斷修改其配置使得撤銷功能變得越來越好用(這也是 redux-undo 有那么多配置項 的原因)。

本文將采用自底向上的思路,以一個簡易的在線畫圖工具為例子,使用TypeScript 、 Immutable.js 實現(xiàn)一個實用的「撤消重做」功能。大致效果如下圖所示:

第一步:確定哪些狀態(tài)需要歷史記錄,創(chuàng)建自定義的 State 類

并非所有的狀態(tài)都需要歷史記錄。許多狀態(tài)是非常瑣碎的,尤其是一些與鼠標或者鍵盤交互相關的狀態(tài),例如在畫圖工具中拖拽一個圖形時我們需要設置一個「正在進行拖拽」的標記,頁面會根據(jù)該標記顯示對應的拖拽提示,顯然該拖拽標記不應該出現(xiàn)在歷史記錄中;而另一些狀態(tài)無法被撤銷或是不需要被撤銷,例如網(wǎng)頁窗口大小,向后臺發(fā)送過的請求列表等。

排除那些不需要歷史記錄的狀態(tài),我們將剩下的狀態(tài)用 Immutable Record 封裝起來,并定義 State 類:

// State.ts
import { Record, List, Set } from 'immutable'
const StateRecord = Record({
 items: List<Item>
 transform: d3.ZoomTransform
 selection: number
})
// 用類封裝,便于書寫 TypeScript,注意這里最好使用Immutable 4.0 以上的版本
export default class State extends StateRecord {}

這里我們的例子是一個簡易的在線畫圖工具,所以上面的 State 類中包含了三個字段,items 用來記錄已經(jīng)繪制的圖形,transform 用來記錄畫板的平移和縮放狀態(tài),selection 則表示目前選中的圖形的 ID。而畫圖工具中的其他狀態(tài),例如圖形繪制預覽,自動對齊配置,操作提示文本等,則沒有放在 State 類中。

第二步:定義 Action 基類,并為每種不同的操作創(chuàng)建對應的 Action 子類

與 redux-undo 不同的是,我們仍然采用 命令模式 :定義基類 Action,所有對 State 的操作都被封裝為一個 Action 的實例;定義若干 Action 的子類,對應于不同類型的操作。

在 TypeScript 中,Action 基類用 Abstract Class 來定義比較方便。

// actions/index.ts
export default abstract class Action {
 abstract next(state: State): State
 abstract prev(state: State): State
 prepare(appHistory: AppHistory): AppHistory { return appHistory }
 getMessage() { return this.constructor.name }
}

Action 對象的 next 方法用來計算「下一個狀態(tài)」,prev 方法用來計算「上一個狀態(tài)」。getMessage 方法用來獲取 Action 對象的簡短描述。通過 getMessage 方法,我們可以將用戶的操作記錄顯示在頁面上,讓用戶更方便地了解最近發(fā)生了什么。prepare 方法用來在 Action 第一次被應用之前,使其「準備好」,AppHistory 的定義在本文后面會給出。

Action 子類舉例

下面的 AddItemAction 是一個典型的 Action 子類,用于表達「添加一個新的圖形」。

// actions/AddItemAction.ts
export default class AddItemAction extends Action {
 newItem: Item
 prevSelection: number
 constructor(newItem: Item) {
 super()
 this.newItem = newItem
 }
 prepare(history: AppHistory) {
 // 創(chuàng)建新的圖形后會自動選中該圖形,為了使得撤銷該操作時 state.selection 變?yōu)樵瓉淼闹?
 // prepare 方法中讀取了「添加圖形之前 selection 的值」并保存到 this.prevSelection
 this.prevSelection = history.state.selection
 return history
 }
 next(state: State) {
 return state
  .setIn(['items', this.newItem.id], this.newItem)
  .set('selection', this.newItemId)
 }
 prev(state: State) {
 return state
  .deleteIn(['items', this.newItem.id])
  .set('selection', this.prevSelection)
 }
 getMessage() { return `Add item ${this.newItem.id}` }
}

運行時行為

應用運行時,用戶交互產(chǎn)生一個 Action 流,每次產(chǎn)生 Action 對象時,我們調用該對象的 next 方法來計算后一個狀態(tài),然后將該 action 保存到一個列表中以備后用;用戶進行撤銷操作時,我們從 action 列表中取出最近一個 Action 并調用其 prev 方法。應用運行時,next/prev 方法被調用的情況大致如下:

// initState 是一開始就給定的應用初始狀態(tài)
// 某一時刻,用戶交互產(chǎn)生了 action1 ...
state1 = action1.next(initState)
// 又一個時刻,用戶交互產(chǎn)生了 action2 ...
state2 = action2.next(state1)
// 同樣的,action3也出現(xiàn)了 ...
state3 = action3.next(state2)
// 用戶進行撤銷,此時我們需要調用最近一個action的prev方法
state4 = action3.prev(state3)
// 如果再次進行撤銷,我們從action列表中取出對應的action,調用其prev方法
state5 = action2.prev(state4)
// 重做的時候,取出最近一個被撤銷的action,調用其next方法
state6 = action2.next(state5)
Applied-Action

為了方便后面的說明,我們對 Applied-Action 進行一個簡單的定義:Applied-Action 是指那些操作結果已經(jīng)反映在當前應用狀態(tài)中的 action;當 action 的 next 方法執(zhí)行時,該 action 變?yōu)?applied;當 prev 方法被執(zhí)行時,該 action 變?yōu)?unapplied。

第三步:創(chuàng)建歷史記錄容器 AppHistory

前面的 State 類用于表示某個時刻應用的狀態(tài),接下來我們定義 AppHistory 類用來表示應用的歷史記錄。同樣的,我們仍然使用 Immutable Record 來定義歷史記錄。其中 state 字段用來表達當前的應用狀態(tài),list 字段用來存放所有的 action,而 index 字段用來記錄最近的 applied-action 的下標。應用的歷史狀態(tài)可以通過 undo/redo 方法計算得到。apply 方法用來向 AppHistory 中添加并執(zhí)行具體的 Action。具體代碼如下:

// AppHistory.ts
const emptyAction = Symbol('empty-action')
export const undo = Symbol('undo')
export type undo = typeof undo // TypeScript2.7之后對symbol的支持大大增強
export const redo = Symbol('redo')
export type redo = typeof redo
const AppHistoryRecord = Record({
 // 當前應用狀態(tài)
 state: new State(),
 // action 列表
 list: List<Action>(),
 // index 表示最后一個applied-action在list中的下標。-1 表示沒有任何applied-action
 index: -1,
})
export default class AppHistory extends AppHistoryRecord {
 pop() { // 移除最后一項操作記錄
 return this
  .update('list', list => list.splice(this.index, 1))
  .update('index', x => x - 1)
 }
 getLastAction() { return this.index === -1 ? emptyAction : this.list.get(this.index) }
 getNextAction() { return this.list.get(this.index + 1, emptyAction) }
 apply(action: Action) {
 if (action === emptyAction) return this
 return this.merge({
  list: this.list.setSize(this.index + 1).push(action),
  index: this.index + 1,
  state: action.next(this.state),
 })
 }
 redo() {
 const action = this.getNextAction()
 if (action === emptyAction) return this
 return this.merge({
  list: this.list,
  index: this.index + 1,
  state: action.next(this.state),
 })
 }
 undo() {
 const action = this.getLastAction()
 if (action === emptyAction) return this
 return this.merge({
  list: this.list,
  index: this.index - 1,
  state: action.prev(this.state),
 })
 }
}

第四步:添加「撤銷重做」功能

假設應用中的其他代碼已經(jīng)將網(wǎng)頁上的交互轉換為了一系列的 Action 對象,那么給應用添上「撤銷重做」功能的大致代碼如下:

type HybridAction = undo | redo | Action
// 如果用Redux來管理狀態(tài),那么使用下面的reudcer來管理那些「需要歷史記錄的狀態(tài)」
// 然后將該reducer放在應用狀態(tài)樹中合適的位置
function reducer(history: AppHistory, action: HybridAction): AppHistory {
 if (action === undo) {
 return history.undo()
 } else if (action === redo) {
 return history.redo()
 } else { // 常規(guī)的 Action
 // 注意這里需要調用prepare方法,好讓該action「準備好」
 return action.prepare(history).apply(action)
 }
}
// 如果是在 Stream/Observable 的環(huán)境下,那么像下面這樣使用 reducer
const action$: Stream<HybridAction> = generatedFromUserInteraction
const appHistory$: Stream<AppHistory> = action$.fold(reducer, new AppHistory())
const state$ = appHistory$.map(h => h.state)
// 如果是用回調函數(shù)的話,大概像這樣使用reducer
onActionHappen = function (action: HybridAction) {
 const nextHistory = reducer(getLastHistory(), action)
 updateAppHistory(nextHistory)
 updateState(nextHistory.state)
}

第五步:合并 Action,完善用戶交互體驗

通過上面這四個步驟,畫圖工具擁有了撤消重做功能,但是該功能用戶體驗并不好。在畫圖工具中拖動一個圖形時,MoveItemAction 的產(chǎn)生頻率和 mousemove 事件的發(fā)生頻率相同,如果我們不對該情況進行處理,MoveItemAction 馬上會污染整個歷史記錄。我們需要合并那些頻率過高的 action,使得每個被記錄下來的 action 有合理的撤銷粒度。

每個 Action 在被應用之前,其 prepare 方法都會被調用,我們可以在 prepare 方法中對歷史記錄進行修改。例如,對于 MoveItemAction,我們判斷上一個 action 是否和當前 action 屬于同一次移動操作,然后來決定在應用當前 action 之前是否移除上一個 action。代碼如下:

// actions/MoveItemAction.ts
export default class MoveItemAction extends Action {
 prevItem: Item
 // 一次圖形拖動操作可以由以下三個變量來進行描述:
 // 拖動開始時鼠標的位置(startPos),拖動過程中鼠標的位置(movingPos),以及拖動的圖形的 ID
 constructor(readonly startPos: Point, readonly movingPos: Point, readonly itemId: number) {
 // 上一行中 readonly startPos: Point 相當于下面兩步:
 // 1. 在MoveItemAction中定義startPos只讀字段
 // 2. 在構造函數(shù)中執(zhí)行 this.startPos = startPos
 super()
 }
 prepare(history: AppHistory) {
 const lastAction = history.getLastAction()
 if (lastAction instanceof MoveItemAction && lastAction.startPos == this.startPos) {
  // 如果上一個action也是MoveItemAction,且拖動操作的鼠標起點和當前action相同
  // 則我們認為這兩個action在同一次移動操作中
  this.prevItem = lastAction.prevItem
  return history.pop() // 調用pop方法來移除最近一個action
 } else {
  // 記錄圖形被移動之前的狀態(tài),用于撤銷
  this.prevItem = history.state.items.get(this.itemId)
  return history
 }
 }
 next(state: State): State {
 const dx = this.movingPos.x - this.startPos.x
 const dy = this.movingPos.y - this.startPos.y
 const moved = this.prevItem.move(dx, dy)
 return state.setIn(['items', this.itemId], moved)
 }
 prev(state: State) {
 // 撤銷的時候我們直接使用已經(jīng)保存的prevItem即可
 return state.setIn(['items', this.itemId], this.prevItem)
 }
 getMessage() { /* ... */ }
}

從上面的代碼中可以看到,prepare 方法除了使 action 自身準備好之外,它還可以讓歷史記錄準備好。不同的 Action 類型有不同的合并規(guī)則,為每種 Action 實現(xiàn)合理的 prepare 函數(shù)之后,撤消重做功能的用戶體驗能夠大大提升。

一些其他需要注意的地方

撤銷重做功能是非常依賴于不可變性的,一個 Action 對象在放入 AppHistory.list 之后,其所引用的對象都應該是不可變的。如果 action 所引用的對象發(fā)生了變化,那么在后續(xù)撤銷時可能發(fā)生錯誤。本方案中,為了方便記錄操作發(fā)生時的一些必要信息,Action 對象的 prepare 方法中允許出現(xiàn)原地修改操作,但是 prepare 方法只會在 action 被放入歷史記錄之前調用一次,action 一旦進入紀錄列表就是不可變的了。

總結

以上就是實現(xiàn)一個實用的撤銷重做功能的所有步驟了。不同的前端項目有不同的需求和技術方案,有可能上面的代碼在你的項目中一行也用不上;不過撤銷重做的思路應該是相同的,希望本文能夠給你帶來一些啟發(fā)。

以上所述是小編給大家介紹的基于 Immutable.js 實現(xiàn)撤銷重做功能的實例代碼,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!

相關文章

  • JavaScript逆向案例之如何破解登錄密碼

    JavaScript逆向案例之如何破解登錄密碼

    這篇文章主要介紹了JavaScript逆向案例之如何破解登錄密碼,文章通過12306的登陸方法展開用戶登錄密碼的參數(shù)破解辦法,感興趣的小伙伴可以參考一下
    2022-06-06
  • Echarts折線圖如何根據(jù)容器寬度自適應展示

    Echarts折線圖如何根據(jù)容器寬度自適應展示

    我們使用vue做項目的時候,常常需要做到echarts圖表的自適應,一般是根據(jù)頁面的寬度做對應的適應,下面這篇文章主要給大家介紹了關于Echarts折線圖如何根據(jù)容器寬度自適應展示的相關資料,需要的朋友可以參考下
    2022-11-11
  • 微信小程序自定義tabBar在uni-app的適配詳解

    微信小程序自定義tabBar在uni-app的適配詳解

    這篇文章主要介紹了微信小程序自定義tabBar在uni-app的適配詳解,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
    2019-09-09
  • JS 中 reduce()方法使用小結

    JS 中 reduce()方法使用小結

    reduce是一個對數(shù)組累積操作的方法,使用時要加上 return 返回累積操作的數(shù)據(jù),這樣 prev 才能獲取上一次執(zhí)行的結果,否則是 undefined,這篇文章主要介紹了JS 中 reduce()方法及使用詳解,需要的朋友可以參考下
    2023-12-12
  • 淺談webpack打包生成的bundle.js文件過大的問題

    淺談webpack打包生成的bundle.js文件過大的問題

    下面小編就為大家分享一篇淺談webpack打包生成的bundle.js文件過大的問題,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2018-02-02
  • js判斷兩個字符串是否相等的兩種方法

    js判斷兩個字符串是否相等的兩種方法

    昨天用Ajax作驗證,在前臺JS中判斷返回的字符串的值與給定的值是否相等,索性給大家總結下,這篇文章主要給大家介紹了關于js判斷兩個字符串是否相等的兩種方法,需要的朋友可以參考下
    2023-05-05
  • textarea焦點的用法實現(xiàn)獲取焦點清空失去焦點提示效果

    textarea焦點的用法實現(xiàn)獲取焦點清空失去焦點提示效果

    這篇文章主要介紹了textarea焦點的用法實現(xiàn)獲取焦點清空失去焦點提示效果,需要的朋友可以參考下
    2014-05-05
  • Js callBack 返回前一頁的js方法

    Js callBack 返回前一頁的js方法

    通過 window.opener 實現(xiàn)。關于這個對象的用法請查閱相關資料。
    2008-11-11
  • 一起來看看JavaScript數(shù)據(jù)類型最詳解

    一起來看看JavaScript數(shù)據(jù)類型最詳解

    這篇文章主要為大家詳細介紹了JavaScript數(shù)據(jù)類型,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下,希望能夠給你帶來幫助
    2022-01-01
  • ionic在開發(fā)ios系統(tǒng)微信時鍵盤擋住輸入框的解決方法(鍵盤彈出問題)

    ionic在開發(fā)ios系統(tǒng)微信時鍵盤擋住輸入框的解決方法(鍵盤彈出問題)

    在使用ionic開發(fā)ios系統(tǒng)微信的時候遇到一個bug,在填寫表單的時候鍵盤會擋住輸入框。下面小編給大家?guī)砹薸onic在開發(fā)ios系統(tǒng)微信時鍵盤擋住輸入框的解決方法(鍵盤彈出問題),非常不錯,有需要的朋友參考下吧
    2016-09-09

最新評論