Vue 頁面狀態(tài)保持頁面間數(shù)據(jù)傳輸?shù)囊环N方法(推薦)

更新時間：2018年11月01日 08:33:58 作者：趙津

vue router給我們提供了兩種頁面間傳遞參數(shù)的方式,一種是動態(tài)路由匹配，一種是編程式導(dǎo)航，接下來通過本文給大家介紹Vue 頁面狀態(tài)保持頁面間數(shù)據(jù)傳輸?shù)囊环N方法,需要的朋友可以參考下

如果大家覺得有用，更多的模塊請點(diǎn)擊查看

vue router給我們提供了兩種頁面間傳遞參數(shù)的方式:

動態(tài)路由匹配
編程式的導(dǎo)航

// 命名的路由
router.push({ name: 'user', params: { userId: 123 }})

// 帶查詢參數(shù)，變成 /register?plan=private
router.push({ path: 'register', query: { plan: 'private' }})

下面介紹一下 vue-viewplus 一個簡化Vue應(yīng)用開發(fā)的工具庫中的參數(shù)棧模塊params-stack.js：

該插件為Vue實例提供了一個 $vp 屬性，模塊提供了一系列api，來做自己的頁面參數(shù)方式：

// 跳轉(zhuǎn)頁面，并傳遞參數(shù)
this.$vp.psPageNext('/Demo/PageStack/Page2', {
 params: {
  phoneNumb: '15111111111'
 }
})

這一點(diǎn)和vue router給我們提供的傳遞方式類似，并且目前還不支持 query: { plan: 'private' } 傳遞url參數(shù)，但是我們?yōu)槭裁催€要做這個模塊：

提供一個棧來管理棧內(nèi)所有頁面的參數(shù)，方便頁面在回退的時候，拿到對應(yīng)頁面的緩存參數(shù) ；即一般我們使用vue router的時候每個頁面的參數(shù)（除了使用url參數(shù)），在做統(tǒng)一返回鍵處理的時候，都不太方便進(jìn)行頁面狀態(tài)恢復(fù)，而如果我們提供了一個棧，在頁面入棧的時候，將當(dāng)前頁面的參數(shù)存儲，在下一個頁面點(diǎn)擊返回按鈕回到當(dāng)前頁面的時候我們再從參數(shù)棧恢復(fù)參數(shù)，這樣就能實現(xiàn)客戶端開發(fā)中具有的這一特性；
該參數(shù)棧也支持緩存->自動恢復(fù)，vuex state和session storage兩級存儲保證參數(shù)棧不會被頁面刷新而導(dǎo)致頁面參數(shù)丟失
也為了統(tǒng)一編程方式

并且，當(dāng)前模塊提供的參數(shù)傳遞方式，和vue router給我們提供了兩種頁面間傳遞參數(shù)的方式，并不沖突，可以互補(bǔ)使用。

只不過目前插件的參數(shù)棧并沒有管理vue router幫我們傳遞的參數(shù)；

vuex state 參數(shù)棧存儲示例：

session storage 參數(shù)棧二級存儲示例：

示例

模擬一個簡單表單提交流程

圖詳見源碼 example 項目中當(dāng)前模塊示例

表單錄入頁面(簡稱：Page1)

<template>
 <group title="模擬手機(jī)號充值 - 堆棧底-第一頁" label-width="5em" class="bottom-group">
  <box gap="10px 10px">
   <x-input title="手機(jī)號" v-model="dataParams.phoneNumb"></x-input>
  </box>
  <box gap="10px 10px">
   <x-button plain @click.native="submit()">點(diǎn)擊充值</x-button>
   <x-button plain @click.native="modify()">修改參數(shù)棧內(nèi)參數(shù)對象</x-button>
  </box>
 </group>
</template>

<script type="text/ecmascript-6">
import demoMixin from '../demo-mixin'
import { XInput } from 'vux'
// 1.參數(shù)棧模塊提供的一個**混入**組件，方便頁面組件簡化參數(shù)棧的api操作和開發(fā)，詳見下面的`paramsStack mixin`說明
import { paramsStack } from 'vue-viewplus'

export default {
 // 2.使用`paramsStack mixin`
 mixins: [paramsStack, demoMixin],
 components: {
  XInput
 },
 data() {
  return {
   // 3.【可選】`paramsStack mixin`中定義的`data`屬性，聲明當(dāng)前頁面組件是參數(shù)棧的棧底，當(dāng)當(dāng)前頁面被點(diǎn)擊返回彈出的時候，插件會檢測這個屬性，如果為true，就清空參數(shù)棧
   // isStackBottom: true,
   // 4.自定義需要傳遞到下一個頁面的參數(shù)
   dataParams: {
    phoneNumb: ''
   }
  }
 },
 methods: {
  submit() {
   this.$vp.psPageNext('/Demo/PageStack/Page2', {
    params: this.dataParams
   })
  }
 },
 created() {
  // 【可選】類似第三步
  // this.isStackBottom = true
  // 5.解析回傳參數(shù)
  if (!_.isEmpty(this.backParams)) {
   this.dataParams.phoneNumb = this.backParams.phoneNumb
   this.$vp.toast(`通過 backParams.phoneNumb 預(yù)填寫頁面`)
  }
 }
}
</script>

表單確認(rèn)頁面(簡稱：Page2)
<template>
 <group label-width="15em" class="bottom-group">
  <form-preview header-label="請確認(rèn)訂單信息" :body-items="list" ></form-preview>
  <x-input title="請輸出充值金額" v-model="dataParams.amount" style="margin-top: 10px"></x-input>
  <box gap="10px 10px">
   <flexbox>
    <flexbox-item>
     <x-button type="default" @click.native="replace()">確認(rèn)</x-button>
    </flexbox-item>
    <flexbox-item>
     <x-button type="default" @click.native="bck()">返回(回傳參數(shù))</x-button>
    </flexbox-item>
   </flexbox>
  </box>
 </group>
</template>

<script type="text/ecmascript-6">
import demoMixin from '../demo-mixin'
import { paramsStack } from 'vue-viewplus'
import { XInput, FormPreview, Flexbox, FlexboxItem } from 'vux'

export default {
 mixins: [paramsStack, demoMixin],
 components: {
  FormPreview,
  Flexbox,
  FlexboxItem,
  XInput
 },
 data() {
  return {
  // 1. 回顯上一個頁面錄入的手機(jī)號
   list: [
    {
     label: '手機(jī)號',
     value: ''
    }
   ],
   // 2. 自定義需要傳遞到下一個頁面的參數(shù)
   dataParams: {
    phoneNumb: '',
    amount: '50元'
   }
  }
 },
 methods: {
  /**
   * 4.提交表單方式1
   * 如果需要下一個頁面點(diǎn)擊返回，任然要回顯當(dāng)前頁面，就調(diào)用該方法
   * /
  next() {
   this.$vp.psPageNext('/Demo/PageStack/Page4', { params: this.dataParams })
  },
  /**
   * 4.提交表單方式2
   * 一般確認(rèn)頁面都無需被“保留”，故這里使用`this.$vp.psPageReplace`接口完成跳轉(zhuǎn)，底層將會使用
   * `router.replace({location})`完成跳轉(zhuǎn)
   */
  replace() {
   this.$vp.psPageReplace('/Demo/PageStack/Page4', {params: this.dataParams})
  },
  bck() {
   this.$vp.psPageGoBack({
    // 3.設(shè)置回傳參數(shù)
    backParams: {
     phoneNumb: '13222222222'
    }
   })
  }
 },
 created() {
  this.list[0].value = this.params.phoneNumb
  this.dataParams.phoneNumb = this.params.phoneNumb
 }
}
</script>

表單結(jié)果頁面(簡稱：Page4)
<template>
 <div>
  <msg title="操作成功" :description="description" :buttons="buttons"></msg>
 </div>

</template>

<script type="text/ecmascript-6">
 import demoMixin from '../demo-mixin'
 import { paramsStack } from 'vue-viewplus'
 import { FormPreview, Msg } from 'vux'

 export default {
  mixins: [paramsStack, demoMixin],
  components: {
   FormPreview,
   Msg
  },
  data() {
   return {
    description: '',
    buttons: [{
     type: 'primary',
     text: '在做一筆',
     onClick: ((that) => {
      return () => {
       // 返回棧頂頁面
       that.$vp.psPageGoBack()
      }
     })(this)
    }, {
     type: 'default',
     text: '完成',
     onClick: ((that) => {
      return () => {
       // 返回指定頁面，并清空參數(shù)棧
       // that.$vp.psPageGoBack({
       //  backPopPageNumbs: -2,
       //  clearParamsStack: true
       // })
       that.$vp.psPageNext('/Demo', {
        clearParamsStack: true,
        backState: true
       })
      }
     })(this)
    }]
   }
  },
  created() {
   this.description = `${this.params.phoneNumb} 成功充值 ${this.params.amount}`
  }
 }
</script>

paramsStack mixin

以上3個頁面都集成了 paramsStack mixin ，定義如下：

/**
 * 參數(shù)棧mixin對象
 * <p>
 *  方便頁面組件繼承之后操作參數(shù)棧
 * @type {Object}
 */
export const paramsStackMixin = {
 data() {
  return {
   /**
    * 聲明該頁面是棧底部
    */
   isStackBottom: false
  }
 },
 computed: {
  ...mapGetters([
   /**
    * 查看`vuex#vplus.paramsStack[top-length]`棧頂參數(shù)
    */
   'params'
  ]),
  /**
   * 查看`vuex#vplus.backParams`回傳參數(shù)
   */
  backParams() {
   return this.$store.state[MODULE_NAME].backParams
  },
  /**
   * 查看`vuex#vplus.backState`是否是出棧|是否是返回狀態(tài)
   */
  backState() {
   return this.$store.state[MODULE_NAME].backState
  }
 },
 methods: {
  ...mapMutations([
   /**
    * 入棧
    */
   'pushParams',
   /**
    * 修改棧頂參數(shù)
    */
   'modifyParams',
   /**
    * 出棧
    */
   'popParams',
   /**
    * 清空參數(shù)棧
    */
   'clearParamsStack',
   /**
    * 設(shè)置是否是出棧|是否是返回狀態(tài)（點(diǎn)擊返回頁面）
    */
   'setBackState'
  ])
 },
 // 導(dǎo)航離開該組件的對應(yīng)路由時調(diào)用
 beforeRouteLeave(to, from, next) {
  if (this.backState && this.isStackBottom) {
   this.clearParamsStack()
  }
  next()
 }
}

配置

沒有個性化配置，可以查看全局通用配置

API接口

restoreParamsStack

/**
  * $vp.restoreParamsStack()
  * 恢復(fù)插件中`vuex#$vp.paramsStack` && vuex#$vp.backParams` && vuex#$vp.backState`參數(shù)棧所用狀態(tài)
  * <p>
  * 在當(dāng)前模塊重新安裝的時候，一般對應(yīng)就是插件初始化和頁面刷新的時候
  */
 restoreParamsStack()

psModifyBackState

/**
  * $vp.psModifyBackState(bckState)
  * <p>
  * 設(shè)置`vuex#vplus.backState`返回狀態(tài)
  * @param {Boolean} [backState=false]
  */
 psModifyBackState(bckState)

psClearParamsStack

/**
  * $vp.psClearParamsStack()
  * <p>
  * 清空參數(shù)棧
  */
 psClearParamsStack()

psPageNext

/**
  * $vp.(location[, {params = {}, clearParamsStack = false, backState = false} = {}])
  * <p>
  * 頁面導(dǎo)航
  * @param location router location對象
  * @param {Object} [params={}] 向下一個頁面需要傳遞的參數(shù)
  * @param {Boolean} [clearParamsStack=false] 在進(jìn)行頁面導(dǎo)航的時候，是否清空參數(shù)棧，默認(rèn)為false
  * @param {Boolean} [backState=false] 設(shè)置`vuex#vplus.backState`返回狀態(tài)，默認(rèn)為false
  */
 psPageNext(location, {params = {}, clearParamsStack = false, backState = false} = {})

psPageReplace

/**
  * $vp.(location[, {params = {}, isPop = true} = {}])
  * <p>
  * 頁面導(dǎo)航(基于Router)，移除上一個頁面
  * <p>
  *  將會出棧頂對象，并重新設(shè)置`params`為參數(shù)棧的棧頂參數(shù)
  *  注：在調(diào)用該方法的頁面，必須是要調(diào)用`ParamsStack#psPageNext`導(dǎo)航的頁面，因為需要保證“彈?！辈僮鳠o誤，
  *  又或者設(shè)置`isPop`為false
  * @param location router location對象
  * @param {Object} [params={}] 向下一個頁面需要傳遞的參數(shù)
  * @param {Boolean} [isPop=false] 是否pop當(dāng)前頁面的參數(shù)后在進(jìn)行頁面跳轉(zhuǎn)，默認(rèn)為true，防止當(dāng)前頁面
  * 不是通過`ParamsStack#psPageNext`導(dǎo)航過來的，但是由需要使用當(dāng)前方法
  */
 psPageReplace(location, {params = {}, isPop = true} = {})

psPageGoBack

/**
  * $vp.psPageGoBack({backParams = {}, clearParamsStack = false, backPopPageNumbs = -1} = {})
  * <p>
  * 頁面回退
  * @param {Object} backParams 設(shè)置回傳參數(shù)
  * @param {Boolean} clearParamsStack 是否清空參數(shù)棧
  * @param {Number} backPopPageNumbs 出棧頁面數(shù)
  */
 psPageGoBack({backParams = {}, clearParamsStack = false, backPopPageNumbs = -1} = {})

您可能感興趣的文章: