快捷導(dǎo)航

vuex實現(xiàn)歷史記錄的示例代碼

更新時間：2021年05月12日 08:36:05 作者：KwokRonny

這篇文章主要介紹了vuex實現(xiàn)歷史記錄的示例代碼，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

最近自研著一個可視化操作平臺，其中涉及到用戶操作后可撤銷或重做，在網(wǎng)上搜了一些解決思路，完善自己所設(shè)想的解決思路。

歷史記錄需求的要點

可存儲在 localStorage 中
可多次撤銷或多次重做
點擊列表中的一項，將歷史倒退或前進至指定位置

看似簡單的需求，在基礎(chǔ)建設(shè)設(shè)計上的錯誤，亦會在未來導(dǎo)致更多的工作量。所以結(jié)合上面兩點的要求，發(fā)現(xiàn) vuex 的基本思路非常適合完成這個需求，redux 同樣。

實現(xiàn)思路

此項目用了 typescript 來加強代碼的嚴謹性，方便日后維護，大家簡單看個思路。

1. 先定義歷史記錄的數(shù)據(jù)結(jié)構(gòu)

interface HistoryItem {
  timestrap: number; // 記錄時間戳
  name: string; // 記錄名稱
  redo: string; // 重做Mutation
  undo: string; // 撤銷Mutation
  redoParams: any[]; // 重做Mutation提交參數(shù)
  undoParams: any[]; // 撤銷Mutation提交參數(shù)
}

interface HistoryStatus {
  historys: HistoryItem[]; // 記錄history數(shù)組
  _currentHistory: number; // 當(dāng)前節(jié)點索引
}

2. 編寫 History 狀態(tài)模塊

編寫基礎(chǔ)操作history狀態(tài)的vuex module，創(chuàng)建記錄的Mutation，重做和撤銷的Action
一條記錄是包含對這個步驟的執(zhí)行redo操作與撤銷undo操作的。所以在用戶點擊列表其中一項時，應(yīng)該是循環(huán)回退到當(dāng)前項的前一項undo，或循環(huán)redo到當(dāng)前項

所以需要增加一條空記錄，方便用戶點擊空記錄撤銷最初的操作。

運用了vuex-module-decorators 裝飾器，寫更易維護的代碼

import { VuexModule, Module, Mutation, Action } from "vuex-module-decorators";

@Module({ namespaced: true })
export class HistoryModule extends VuexModule<HistoryStatus> implements HistoryStatus {
  /** 
   * 初始化一個空記錄的原因主要是方便列表操作時：
   * 當(dāng)用戶點擊最早的一條記錄時，可以正常撤銷用戶操作的第一步
  **/
  public historys: HistoryItem[] = [
    {
      name: `打開`,
      timestrap: Date.now(),
      redo: "",
      redoParams: [],
      undo: "",
      undoParams: [],
    },
  ];
  public _currentHistory: number = 0;

  // getter
  get current(){
    return this._currentHistory;
  }

  // getter
  get historyList(): HistoryItem[] {
    return this.historys || [];
  }

  // 創(chuàng)建歷史記錄
  @Mutation
  public CREATE_HISTORY(payload: HistoryItem) {
    if (this._currentHistory < this.historys.length - 1) {
      this.historys = this.historys.slice(0, this._currentHistory);
    }
    // 由于js的深淺拷貝問題，所以在創(chuàng)建時都需要對數(shù)據(jù)進行深拷貝
    // 想嘗試lodash的clone函數(shù)，但發(fā)現(xiàn)好像JSON.stringify的方式clone應(yīng)該更快的，畢竟我們的數(shù)據(jù)不存在函數(shù)
    // 我這里就先不改了，主要是表達出思路即可
    this.historys.push(_.cloneDeep(payload));
    this._currentHistory = this.historys.length - 1;
  }

  @Mutation
  public SET_CURRENT_HISTORY(index: number) {
    this._currentHistory = index < 0 ? 0 : index;
  }

  // 重做
  @Action
  public RedoHistory(times: number = 1) {
    let { state, commit } = this.context;
    let historys: HistoryItem[] = state.historys;
    let current: number = state._currentHistory;
    if (current + times >= historys.length) return;
    while (times > 0) {
      current++;
      let history = historys[current];
      if (history) {
        commit(history.redo, ...history.redoParams, { root: true });
      }
      times--;
    }
    commit("SET_CURRENT_HISTORY", current);
  }

  // 撤銷
  @Action
  public UndoHistory(times: number = 1) {
    let { state, commit } = this.context;
    let historys: HistoryItem[] = state.historys;
    let current: number = state._currentHistory;
    if (current - times < 0) return;
    while (times > 0) {
      let history = historys[current];
      if (history) {
        commit(history.undo, ...history.undoParams, { root: true });
      }
      times--;
      current--;
    }
    commit("SET_CURRENT_HISTORY", current);
  }
}

3. 編寫可以撤銷或重做的功能

完成上面兩步后，我們就可以編寫各種操作了

編寫對數(shù)據(jù)基礎(chǔ)操作的Mutation

@Mutation
public CREATE_PAGE(payload: { page: PageItem; index: number }) {
  this.pages.splice(payload.index, 0, _.cloneDeep(payload.page));
  this._currentPage = this.pages.length - 1;
}

@Mutation
public REMOVE_PAGE(id: string) {
  let index = this.pages.findIndex((p) => p.id == id);
  index > -1 && this.pages.splice(index, 1);
  if (this._currentPage == index) {
    this._currentPage = this.pages.length > 0 ? 0 : -1;
  }
}

將基礎(chǔ)操作按要求封裝成帶保存->記錄->執(zhí)行的Action

// 包裝創(chuàng)建頁面函數(shù)
@Action
public CreatePage(type: "page" | "dialog") {
  let { state, commit } = this.context;
  
  // 記錄保存即將創(chuàng)建的頁面
  let id = _.uniqueId(type) + Date.now();
  let pageName = pageType[type];
  let page: PageItem = {
    id,
    name: `${pageName}${state.pages.length + 1}`,
    type,
    layers: [],
    style: { width: 720, height: 1280 },
  };

  //創(chuàng)建歷史記錄
  let history: HistoryItem = {
    name: `創(chuàng)建${pageName}`,
    timestrap: Date.now(),
    redo: "Page/CREATE_PAGE",
    redoParams: [{ index: state.pages.length - 1, page }],
    undo: "Page/REMOVE_PAGE",
    undoParams: [id],
  };
  // 保存記錄此歷史記錄
  commit("Histroy/CREATE_HISTORY", history, { root: true });

  commit(history.redo, ...history.redoParams, { root: true });
}

@Action
public RemovePage(id: string) {
  // 記錄保存現(xiàn)場狀態(tài)
  let index = this.pages.findIndex((p) => p.id == id);
  if (index < 0) return;
  let page: PageItem = this.context.state.pages[index];

  //創(chuàng)建歷史記錄
  let history: HistoryItem = {
    name: `刪除 ${page.name}`,
    timestrap: Date.now(),
    redo: "Page/REMOVE_PAGE",
    redoParams: [id],
    undo: "Page/CREATE_PAGE",
    undoParams: [{ page, index }],
  };

  // 保存記錄此歷史記錄
  this.context.commit("Histroy/CREATE_HISTORY", history, { root: true });
  this.context.commit(history.redo, ...history.redoParams, { root: true });
}

以上，撤銷與重做的功能就基本完成了

4. 使用

1. 我們現(xiàn)在只需要在使用時創(chuàng)建或刪除頁面時使用封裝的`Action`后

  private create(type: "page" | "dialog") {
    this.$store.dispatch("Page/CreatePage", type);
  }

  private remove(id: number) {
    this.$store.dispatch("Page/RemovePage", id);
  }

2. 配置全局熱鍵

typescript App.vue

private mounted() {
    let self = this;
    hotkeys("ctrl+z", function (event, handler) {
      self.$store.dispatch("History/UndoHistory");
    });
    hotkeys("ctrl+y", function (event, handler) {
      self.$store.dispatch("History/RedoHistory");
    });
  }

效果