数据动态过滤技巧在 Vue 项目中的实战

这个问题是在下在做一个 Vue 项目中遇到的实际场景,这里记录一下我遇到问题之后的思考和最后怎么解决的(老年程序员记性不好 -。-),过程中会涉及到一些Vue源码的概念比如 $mount、 render watcher等,如果不太了解的话可以瞅瞅 Vue源码阅读系列文章 ~

问题是这样的:页面从后台拿到的数据是由 0、 1之类的key,而这个key代表的value比如 0-女、 1-男的对应关系是要从另外一个数据字典接口拿到的;类似于这样的Api:

{

  "SEX_TYPE": [

    { "paramValue": 0, "paramDesc": "女" },

    { "paramValue": 1, "paramDesc": "男" }

  ]

}

那么如果view拿到的是 0,就要从字典中找到它的描述 女并且显示出来;下面故事开始了~

1. 思考

有人说,这不是过滤器 filter 要做的事么,直接 Vue.filter 不就行了,然而问题是这个filter 是要等待异步的数据字典接口返回之后才能拿到,如果在 $mount 的时候这个filter没有找到,那么就会导致错误影响之后的渲染(白屏并报 undefined错);

我想到的解决方法有两个:

把接口变为同步,在 beforeCreate或 created钩子中同步地获取数据字典接口,保证在 $mount的时候可以拿到注册好的filter,保证时序,但是这样会阻塞挂载,延长白屏时间,因此不推介;

把filter的注册变为异步,在获取filter之后通知 render watcher 更新自己,这样可以利用vue自己的响应式化更新视图,不会阻塞渲染,因此在下初步采用了这个方法。

2. 实现

因为filter属于 assettypes ,关于在Vue实例中assettypes的访问链有以下几个结论;具体代码实践可以参考:Codepen - filter test

asset_types包括 filters、 components、 directives,以下所有的 asset_types都自行替换成前面几项

子组件中的 asset_types访问不到父组件中的 asset_types,但是可以访问到全局注册的挂载在 $root.$options.asset_types.__proto__上的 asset_types,这里对应源码 src/core/util/options.js

全局注册方法Vue.assettypes,比如Vue.filters注册的assettypes会挂载到根实例(其他实例的 $root)的 $options.asset_types.__proto__上,并被以后所有创建的Vue实例继承,也就是说,以后所有创建的Vue实例都可以访问到

组件的slot的作用域仅限于它被定义的地方,也就是它被定义的组件中,访问不到父组件的 asset_types,但是可以访问到全局定义的 asset_types

同理,因为main.js中的 newVue()实例是根实例,它中注册的 asset_types会被挂载在 $root.$options.asset_types上而不是 $root.$options.asset_types.__proto__上

根据以上几个结论,可以着手coding了~

2.1 使用根组件的filters

因此首先我考虑的是把要注册的filter挂载到根组件上,这样其他组件通过访问 $root可以拿到注册的filter,这里的实现:

<template>

  <div>

    {{ rootFilters( sexVal )}}

  </div>

</template>

<script type='text/javascript'>

  import Vue from 'vue'

  import { registerFilters } from 'utils/filters'

  export default {

    data() {

      return {

        sexVal: 1  // 性别

      }

    },

    methods: {

      /* 根组件上的过滤器 */

      rootFilters(val, id = 'SEX_TYPE') {

        const mth = this.$root.$options.filters[id]

        return mth && mth(val) || val

      }

    },

    created() {

      // 把根组件中的filters响应式化

      Vue.util.defineReactive(this.$root.$options, 'filters', this.$root.$options.filters)

    },

    mounted() {

      registerFilters.call(this)

        .then(data =>

          // 这里获取到数据字典的data

        )

    }

  }

</script>

注册filter的js

// utils/filters

import * as Api from 'api'

/**

* 获取并注册过滤器

* 注册在$root.$options.filters上不是$root.$options.filters.__proto__上

* 注意这里的this是vue实例,需要用call或apply调用

* @returns {Promise}

*/

export function registerFilters() {

  return Api.sysParams()            // 获取数据字典的Api,返回的是promise

    .then(({ data }) => {

      Object.keys(data).forEach(T =>

        this.$set(this.$root.$options.filters, T, val => {

          const tar = data[T].find(item => item['paramValue'] === val)

          return tar['paramDesc'] || ''

        })

      )

      return data

    })

    .catch(err => console.error(err, ' in utils/filters.js'))

}

这样把根组件上的filters变为响应式化的,并且在渲染的时候因为在 rootFilters方法中访问了已经在created中被响应式化的 $root.$options.filters,所以当异步获取的数据被赋给 $root.$options.filters的时候,会触发这个组件render watcher的重新渲染,这时候再获取 rootFilters方法的时候就能取到filter了;

那这里为什么不用Vue.filter方法直接注册呢,因为 Object.defineProperty不能监听 __proto__上数据的变动,而全局Vue.filter是将过滤器注册在了根组件 $root.$options.asset_types.__proto__上,因此其变动不能被响应。

这里的代码可以进一步完善,但是这个方法存在一定的问题,首先这里使用了 Vue.util上不稳定的方法,另外在使用中到处可见 this.$root.$options这样访问vue实例内部属性的情况,不太文明,读起来也让人困惑。

因此在这个项目做完等待测试的时候我思考了一下,谁说过滤器就一定放在filters里面 -。-,也可以使用mixin来实现嘛

2.2 使用 mixin

使用mixin要注意一点,因为vue中把data里所有以 _、 $开头的变量都作为内部保留的变量,并不代理到当前实例上,因此直接 this._xx是无法访问的,需要通过 this.$data._xx来访问。

// mixins/sysParamsMixin.js

import * as Api from 'api'

export default {

  data() {

    return {

      _filterFunc: null,      // 过滤器函数

      _sysParams: null,        // 获取数据字典

      _sysParamsPromise: null  // 获取sysParams之后返回的Promise

    }

  },

  methods: {

    /* 注册过滤器到_filterFunc中 */

    _getSysParamsFunc() {

      const { $data } = this

      return $data._sysParamsPromise || ($data._sysParamsPromise = Api.sysParams()

        .then(({ data }) => {

          this.$data._sysParams = data

          this.$data._filterFunc = {}

          Object.keys(data).forEach(paramKey =>

            this.$data._filterFunc[paramKey] = val => {

              const tar = data[paramKey].find(item => item['paramValue'] === val)

              return tar && tar['paramDesc'] || ''

            })

          return data

        })

        .catch(err => console.error(err, ' in src/mixins/sysParamsMixin.js')))

    },

    /* 按照键值获取单个过滤器 */

    _rootFilters(val, id = 'SEX_TYPE') {

      const func = this.$data._filterFunc

      const mth = func && func[id]

      return mth && mth(val) || val

    },

    /* 获取数据字典 */

    _getSysParams() {

      return this.$data._sysParams

    }

  }

}

这里把 Api的 promise 保存下来,如果其他地方还用到的话直接返回已经是 resolved状态的 promise,就不用再次去请求数据了。另外为了在其他实例中也可以方便的访问,这里挂载在根组件上。

那在我们的根组件中怎么使用呢:

// src/main.js

import sysParamsMixin from 'mixins/sysParamsMixin'

new Vue({

  el: '#app',

  mixins: [sysParamsMixin],

  render: h => h(App),

})

在需要用过滤器的组件中:

<template>

  <div>

    {{ $root._rootFilters( sexVal )}}

  </div>

</template>

<script type='text/javascript'>

  export default {

    data() {

      return { sexVal: 1 }

    },

    mounted() {

      this.$root._getSysParamsFunc()

        .then(data =>

          // 这里获取到数据字典的data

        )

    }

  }

</script>

这里不仅注册了过滤器,而且也暴露了数据字典,以方便某些地方的列表显示,毕竟这是实际项目中常见的场景。

当然如果使用 vuex 更好,不过这里的场景个人觉得没必要用 vuex,如果还有更好的方法欢迎讨论一下下啊~

❤️ 看完记得点赞哟

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容