Skip to content

lwd426/lwd-vue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lwd-vue

What is lwd-vue?

lwd-vue是一个加强Vue数据管理的解决方案,采用了分布式思想,提升了vue开发过程中数据的灵活性和唯一性

lwd-vue能带来什么?

  1. lwd-vue为组件增加了对外暴露公共data和methods的能力 ----- 暴露出来的属性(__data和__method),让其他组价来调用和访问、甚至是修改。

  2. 全新的组件通信方式,带来全新的编码体验----- 接入vue,任何组件之间都不需要props以及中央数据总线的方式来完成间接通信,只需要调用lwd-vue api,就能完成跨组件通信和方法调用

  3. 全无侵入 ----- lwd-vue不会影响你之前使用vue的习惯,当你想用的wue的时候,就去用

  4. api即配即用,对接yapi ----- lwd-vue,集成了axios库,只需通过简单的api配置,即可直接在Wue代码里调用,无需在组件里显式引用和注入

  5. 为了开发遍历,lwd-vue提供了Global.gl.js为全局变量,供所有组件使用,这是lwd-vue唯一一份中心化的数据。**

Usage

首先要说明的:

  1. lwd-vue本质上并没有改变vue的核心代码,它是一个语法糖,帮助开发者做了一些事情而已。

  2. 一个组件,如果想使用lwd-vue的api来帮自己访问其他组件会被其他组件访问,直接在vue的配置里增加__data和__methods就可以完成

  3. 一个已经交给lwd-vue托管了的组件,如果想按照传统的方式传值给子组件,直接按照原来的方式写就可以了。也就是说,lwd-vue不会影响你之前使用vue的习惯,当你想用的lwd-vue时候,就去用。

配置lwd-wue

简单配置,即刻拥有Wue的所有能力

import Vue from 'Vue';
import index from './index.vue'

// 引入vue增强插件
import Wue from 'lwd-vue';

Vue.use(Wue, {
  dir: require.context('./components')
})

new Vue({
  el: '#app',
  render: h => h(index)
})

API

__get

功能说明 访问其他组件的data的时候,使用:

this.__get('组件文件名.变量名')

__set

功能说明 更改其他组件的数据的时候,使用

this.__set('组件文件名.变量名')

__emit

功能说明 触发其他组件的公有方法的时候,使用

this.__emit('组件文件名.方法名')

__api

api只要按照如下配置,就可以在所有组件里直接通过 this.__api[api名]使用

export default [
  {
    api: 'getCityList',
    type: 'get',
    url: `api/citylist`,
    desc: '查询城市'
  },{
    api: 'updateCity',
    type: 'post',
    url: `api/update`,
    desc: '城市信息修改' 
  }
]

在lwd-vue中,任何地方都可以调用以下代码调用API,而不需要引入

this.__api.getCityList({q: this.cityId}, (data) => {
  this.__set('list.data.dList', data)
})

DEMO

使用一个简单的姓名输入功能来演示lwd-vue的api

api配置、全局数据及入口配置

// Global.gl.js
export default {
  auth: false
}

// api.js
export default [
  {
    api: 'auth',
    type: 'get',
    url: `api/auth`,
    desc: '鉴权接口'
  },{
    api: 'save',
    type: 'post',
    url: `api/save`,
    desc: '姓名保存' 
  },
  {
    api: 'valid',
    type: 'post',
    url: `api/valid`,
    desc: '校验姓名是否重复' 
  }
]

// index.js
import Vue from 'Vue';
import index from './index.vue'
import Wue from 'lwd-vue';

Vue.use(Wue, {
  dir: require.context('./components')
})

new Vue({
  el: '#app',
  render: h => h(index)
})

三个组件需要使用wue通信的组件

// index.vue 
<template>
  <div class="pro-module">
    <name-input/> <!--名称输入-->
    <name-duplicheck/> <!--输入重复性校验-->
  </div>
</template>
<script>
 export default {
    name: 'name-index',
    created () {
      // 鉴权接口调用
      this.__api.auth('page/name', (data) => {
        // 设置全局为全局
        this.__set('Global.auth', data['page/name'])
      })
    }
  }
</script>
// NameInput.vue
<template>
  <div class="pro-module">
    <div v-if="__get('Global.auth')">
      <input type="text" v-model="name">
      <button type="primary" @click="save">直接保存</button>
    </div>
    <div v-else>对不起,您没有录入权限</div>
  </div>
</template>
<script>
 export default {
    name: 'name-input',
    __data () {
      return {
        name: ''
      }
    },
    __methods: {
      save () {
        this.__api.save({
          name: this.name
        })
      }
    }
  }
</script>
// NameDupliCheck.vue
<template>
  <div class="pro-module">
    <label>已输入姓名:{{__get('NameInput.name')}}</label>
    <label>校验结果:{{result}}</label>
    <button type="primary" @click="valid">校验姓名是否存在</button><!--校验姓名是否存在,若不存在,直接调用NameInput的save保存-->
  </div>
</template>
<script>
 export default {
    name: 'name-duplicheck',
    data () {
      return {
        result: ''
      }
    },
    methods: {
      valid () {
        this.__api.valid({
          name: __get('NameInput.name'
        }, (data) => {
          if (data) {
            this.__emit('NameInput.save')
            return 
          } else {
            this.result = '姓名已存在'
          }
        })
      }
    }
  }
</script>

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published