npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@zhangqingcq/plug-r-qw

v1.5.15

Published

A JS lib base on Vue and View-design, you can achieve some complex functions with simple code after install this lib.

Downloads

515

Readme

plug-r-qw

  • A JS lib base on Vue and View-design, you can achieve some complex functions with simple code after install this lib.

  • 简介:这是一个主要基于Vue和View-design的JS库,库里面提供一些集成度较高功能较复杂的全局组件,和一些实用的但不常见(其他库可能没有)的方法,并且使用起来灵活简单。

  • 安装该库后,可以用简单的几行代码实现较复杂的业务需求;对经验丰富的开发者来说,大大提高开发速度、代码质量、可读性、和可维护性;对萌新来说,将入门门槛进一步降低,让你更快上手。

vue3: @zhangqingcq/[email protected]

vue2: @zhangqingcq/[email protected]

vue3 version README file is start from here:

vue3版本开发基本完成,所有公共方法、UI组件已可以使用(vue3版本弃用了少数几个组件),说明文档已更新,使用示例项目还在开发中,后续会慢慢更新。
  • 组件方法 都有各自详细的markdown格式说明文档,可直接在GitHub 查看,也可将项目拉到本地直接查看,或者将示例项目运行起来在示例页面查看。

推荐环境

  • node: >= 18.16.0
  • npm: >= 9.5.1
  • pnpm: >= 8.6.0

用法

  1. npm i @zhangqingcq/plug-r-qw@vue3 or pnpm add @zhangqingcq/plug-r-qw@vue3

  2. 在main.js中添加:

    // main.js or main.ts
       
    import { createApp } from 'vue'
    import { createPinia } from 'pinia'
    import router from './router'
    import App from './App.vue'
    import ViewUIPlus from 'view-ui-plus'
    import 'view-ui-plus/dist/styles/viewuiplus.css'
    import plugRQw from '@zhangqingcq/plug-r-qw'
    import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css'
    import { useStore } from './stores/main'
       
    createApp(App).use(createPinia()).use(router).use(ViewUIPlus).use(plugRQw,{useStore,router}).mount('#app')

    国际化版本:

    // main.js or main.ts
       
    import { createApp } from 'vue'
    import { createPinia } from 'pinia'
    import router from './router'
    import App from './App.vue'
    import { createI18n } from 'vue-i18n'
    import en from '@/locale/en'
    import zh from '@/locale/zh'
    import ViewUIPlus from 'view-ui-plus'
    import 'view-ui-plus/dist/styles/viewuiplus.css'
    import enI from 'view-ui-plus/dist/locale/en-US'
    import zhI from 'view-ui-plus/dist/locale/zh-CN'
    import plugRQw from '@zhangqingcq/plug-r-qw'
    import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css'
    import enR from '@zhangqingcq/plug-r-qw/lib/lang/en-US'
    import zhR from '@zhangqingcq/plug-r-qw/lib/lang/zh-CN'
    import { useStore } from './stores/main'
       
    const i18n = createI18n({
      allowComposition: true,
      globalInjection: true,
      legacy: false,
      locale: 'zh',
      messages: { 
        en: { ...en, ...enI, ...enR },
        zh: { ...zh, ...zhI, ...zhR } 
      }
    })
       
    createApp(App).use(createPinia()).use(router).use(ViewUIPlus, { i18n }).use(plugRQw,{useStore,router,i18n}).mount('#app')

    该库支持按需引入,以支持tree-shaking

    // main.ts or main.js
     
       app.use(plugRQw,{notRegistryGlobal:true,...})
    
    // xxx.vue setup
     
       import {$fetch,Hello} from '@zhangqingcq/plug-r-qw
     
       $fetch.get(...).then()
    
    // xxx.vue template
     
       <Hello/>
     

    该库支持TypeScript + Vue的项目(非TypeScript项目依然支持),用法和JS + Vue的项目大同小异,除了下面的不同,其他都相同。

    Ts项目在安装该库时"app.use(plugRQw)"可能会提示plugRQw类型错误,这并非库的问题,不影响使用,使用//@ts-ignore 忽略类型错误,或者把项目升级到基于node20的架构,可参考本库架构

    如果用了lodash-es等自身没有声明文件的第三方库,需要在env.d.ts文件中(或其他在tsconfig.app.jsoninclude 中的声明文件) 声明相关模块(如果安装对应第三方声明依赖如@types/lodash-es,则不用),如:

    // env.d.ts or xxx.d.ts include in tsconfig.app.json
    
    declare module 'lodash-es'
    declare module 'js-cookie'

    该库推荐使用Pinia(Vuex的升级版)作为状态管理库,如果使用Vuex,就用Vuexstore替换PiniauseStore,用法如下:

    // main.ts or main.js
    
    import store from './store'
    
    app.use(plugRQw,{store,...})
  3. 挂载在app.config.globalProperties下(按需引入模式除外)的方法的使用:

    // vue3 SFC 选项式 script methods
    
    this.xxx()
    // vue3 SFC template
       
    <Button @click='xxx' >ok</Button>
  4. 库内所有方法都支持的用法:

    // vue3 SFC 组合式 script setup
    // or in *.js or *.ts file
       
    import {xxx} from '@zhangqingcq/plug-r-qw'
       
    xxx()
  5. 所有UI组件均被库注册为了全局组件(按需引入模式除外),所以在需要的地方直接使用即可,如:

     <IconTxtBtn icon='ios-trash' name='批量删除'/>

注意

  • 要看例子,需要下载github上项目,然后npm ipnpm i ,安装依赖,然后npm run devpnpm dev 把项目跑起来,就可以查看各个组件或方法的示例了。

  • 推荐使用pnpm作为你项目的包管理器

    如果安装依赖失败,可更换国内的镜像再试,淘宝镜像https://registry.npmmirror.com,腾讯云镜像https://mirrors.cloud.tencent.com/npm/

  • 你的项目使用npm作为包管理器时,plug-r-qw库使用了的依赖不用再次在你的项目安装

  • 使用pnpm作为包管理器时,需要执行下面命令安装第三方依赖,如果仍提示缺少依赖,缺什么就安装什么。

      pnpm add lodash-es ar-cascader @wangeditor/editor @wangeditor/editor-for-vue moment
  • 部分示例有需要请求接口的组件,所以需要在项目目录下新开一个命令窗口运行:npm run node-servepnpm node-serve 将该项目配置好的nodeJs服务器启动起来,那些需要请求nodeJs服务器的组件才有数据

  • 因为这个库里面包含UI组件,所以需要在main.js引用lab/plugRQw.min.css 才能正常显示样式,如:import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css',‘按需引入’模式也需要引入这个样式文件

  • 如果需要定制化样式(例如主题色),则需要创建一个less文件(如plugRQwTheme.less,注意:这种情况下不再需要引入 plugRQw.min.css),在该文件中顶部引入src/style/index.less ( 如:@import "@zhangqingcq/plug-r-qw/src/style/index.less";) ,然后在后面写上想要覆盖的变量名,并给出想要的值,如:@primary: #46be87;默认颜色列表默认尺寸列表

    注意:

    • 请不要随意改变这些变量,除非你很清楚改变后会带来的影响,他们在整个库中被多次使用。
    • 因为该库是基于view-ui-plus封装的,所以很多样式继承于view-ui-plus,要定制那些样式,直接定制view-ui-plus即可。
    • 如出现样式异常,请使用[email protected]版本,可以和库的less版本保持一致。
  • 该库使用了[email protected],如项目有less语法报错,可以在vite.config.jsorvite.config.ts 中加上配置,如:

    export default defineConfig({
      ...,
      css: {
        preprocessorOptions: {
          less: {
            javascriptEnabled: true,
            math: 'always'
          }
        }
      }
    })
  • 如果你的项目view-ui-plus库字体图标无法正常显示,可能是view-ui-plus的iconfont字体文件url不正确,尝试下面的解决方案:

    首先关闭项目配置中less的rewriteUrls功能:

    //vite.config.ts
    
    export default defineConfig({
      ...,
      css: {
          preprocessorOptions: {
              less: {
                javascriptEnabled: true,
                math: 'always',
               rewriteUrls: 'off' //或者删除该行代码
              }
          }
        }
    })

    然后在定制view-ui-plus的less文件(如本库examples/global/iViewTheme.less)中改写它iconfont字体文件的url:

    //iViewTheme.less
    
    @import 'view-ui-plus/src/styles/index.less';
    
    //改写view-ui-plus中iconfont字体文件地址
    @ionicons-font-path: "view-ui-plus/src/styles/common/iconfont/fonts";
  • 该库有数个用于控制样式的全局变量,挂在app.config.globalProperties下,直接在main.js or main.ts中给对应变量赋值即可定制对应样式:

      //main.js or main.ts
      
      app.use()
      app.config.globalProperties.searchFormLabelWidth = 100
      
      //已支持的全局变量有:pageSizes, searchFormLabelWidth, formModalLabelWidth, formGroupLabelWidth, iconTxtBtnIconSize, btTablePageUsePagePro, pageShowTotal, pageShowSizer, tableSettingBg, tableSettingTransfer, tableSettingEventsEnabled
      //注意:需要在库安装<app.use(plugRQw,{...})>后指定全局变量,即将赋值的代码写在use代码之后,否则指定的值会在库安装时被库内全局变量默认覆盖。
  • 该库主要依赖有

    vue、vue-router、pinia、view-ui-plus、sweetalert、lodash-es、axios、echarts、moment、@amap/amap-jsapi-loader、@wangeditor/editor、@wangeditor/editor-for-vue、js-cookie、ar-cascader、vue-json-viewer

    其中vue、vue-router在使用vite脚手架搭建项目时安装(选上),如果你的项目是国际化版本,vue-i18n 需要手动安装。

    使用npm时,其他依赖在项目安装该库后,可直接在项目中使用,无需再次将它们安装至你的项目;

    使用pnpm时,需执行前面提到过的命令安装部分依赖。

    不管使用那种包管理器,其中view-ui-plus、@amap/amap-jsapi-loader需要在你的项目手动初始化,可以参考对应官网或npm网站页面或本项目examples目录里的初始化方法

  • 该库使用了地图的组件依赖于高德地图@amap/amap-jsapi-loader ,使用方法参考该项目的examples中main.ts或其官网开放平台,值得注意的是,要将你的securityJsCodekey传 给plug-r-qw库:

    // main.ts or main.js
      
    app.use(plugRQw,{
      amap:{ 
        securityJsCode: 'your code',
        key: 'your key'
      },
      ...
        })

本库自带自定义指令

  • has 通过本库内方法hasPermission将传入指令的值进行解析(在sessionStorage中btnPermissions中查找传入的值),如果解析结果为false,则为绑定的元素添加display:none 的内联样式,以此来实现元素的权限控制。

  • loadmore 在容器滚动到底部时调用传入指令的值(回调函数),指令在绑定对象mounted时生效,可通过指令参数传入一个class,来指定滚动的容器(如v-loadmore:boxN='getData' ,boxN的意思为document下class为boxN的首个元素,而该元素被指定为滚动的容器;getData为回调函数,比如在函数内部拉取数据并渲染到容器内),滚动容器默认为指令绑定的元素

  • clickOutside 在容器外部有鼠标点击事件时触发(如v-click-outside='close'

vue2 version README file is start from here:

  • 组件方法 都有各自详细的markdown格式说明文档,可直接在GitHub 查看,也可将项目拉到本地直接查看,或者将示例项目运行起来在示例页面查看。

推荐环境

  • node 14.21.2

  • npm 6.14.17

用法

  1. npm i @zhangqingcq/plug-r-qw or pnpm add @zhangqingcq/plug-r-qw

  2. 在main.js中添加:

     // main.js or main.ts
      
     import Vue from 'vue'
     import store from './store'
     import router from './router'
     import plugRQw from '@zhangqingcq/plug-r-qw'
     import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css'
        
     Vue.use(plugRQw,{store,router})

    国际化版本:

     // main.js or main.ts
      
     import Vue from 'vue'
     import store from './store'
     import router from './router'
     import VueI18n from "vue-i18n"
     import plugRQw from '@zhangqingcq/plug-r-qw'
     import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css'
     import enR from '@zhangqingcq/plug-r-qw/lib/lang/en-US'
     import zhR from '@zhangqingcq/plug-r-qw/lib/lang/zh-CN'
        
     Vue.use(VueI18n)
       
     Vue.locale = () => {}
     const messages = {
       en: {hello:'Hello', ...enR},
       zh: {hello:'你好', ...zhR}
     }
         
     const i18n = new VueI18n(({
       locale: 'zh',
       messages
     }))
        
     Vue.use(plugRQw,{
      store,
      router,
      i18n(path, options) {
        return i18n.t(path, options) || ''
      }
     })
        
     new Vue({ i18n,store }).$mount('#app')

    该库从@zhangqingcq/[email protected]开始支持TypeScript + Vue的项目(非TypeScript项目依然支持,用法没有任何改动),用法和之前 JS + Vue的项目大同小异,除了下面列出的不同,其他都相同。

    Ts项目在安装该库时"Vue.use(plugRQw)"可能会提示plugRQw类型错误,这并非库的问题,不影响使用,使用//@ts-ignore 忽略类型错误

    为了更好的支持Typescript类型检查,我们需要在Vue接口 模块补充 该库的全局方法,这样可以避免使用this.xxxproxy.xxx(proxy为[email protected]getCurrentInstance().proxy)时提 示xxx不存在于this或proxy, 而且能在使用这些方法时获得IDE提示或能方便的查看对应方法的声明代码,模块补充方法如下:

    // types/xxx.d.ts
    
    // 1. 确保在声明补充的类型之前导入 'vue'
    import Vue from 'vue'
    import type {ProtoFunc} from '@zhangqingcq/plug-r-qw/types'
    
    declare module 'vue/types/vue'{
      interface Vue extends ProtoFunc{}
    }

    并将该文件包含在你的项目,如在tsconfig.json的include中添加该文件

    {
      "include":["types/xxx.d.ts"]
    }

    国际化版本,需要在shims-vue.d.ts文件( 或任何被包含在tsconfig.json的include中的非模块 xxx.d.ts文件)中声明国际化文件(plug-r-qw和view-design都要),如:

    // shims-vue.d.ts or xxx.d.ts include in tsconfig.json
    
    declare module '@zhangqingcq/plug-r-qw/lib/lang/en-US'
    declare module '@zhangqingcq/plug-r-qw/lib/lang/zh-CN'
    
    declare module '@zhangqingcq/view-design-r/dist/locale/en-US'
    declare module '@zhangqingcq/view-design-r/dist/locale/zh-CN'

    国际化版本在main.js安装plug-r-qw时国际化配置方法要定义参数类型,如:

    // main.ts
    
    Vue.use(plugRQw,{
      ...,
      i18n(path:string,options:Record<string,any>){
       //其他代码
      }
    })

    如果用了lodash等自身没有声明文件的第三方库,也需要在shims-vue.d.ts文件中声明相关模块(如果安装对应第三方声明依赖 如@types/lodash,则不用),如:

    // shims-vue.d.ts or xxx.d.ts include in tsconfig.json
    
    declare module 'lodash'
    declare module 'js-cookie'

    该库从@zhangqingcq/[email protected]开始支持Pinia(Vuex的升级版),就是用PiniauseStore替换之前Vuexstore,用法如下:

    // main.ts
    
    import {useStore} from './stores/main'
    
    Vue.use(plugRQw,{useStore,...})
  3. 挂载在Vue实例下的方法的使用:

    // vue2 SFC script
    
    this.xxx()
    // vue2 SFC template
       
    xxx()
    // vue2.7.14 SFC setup
    // or in *.js or *.ts file
       
    import plugRQw from '@zhangqingcq/plug-r-qw'
       
    plugRQw.xxx()
    // vue2.7.14 SFC setup
    // or in *.js or *.ts file
    
       
    import {xxx} from '@zhangqingcq/plug-r-qw'
       
    xxx()
    // vue2.7.14 SFC setup
       
    import {getCurrentInstance} from 'vue'
       
    const proxy = getCurrentInstance().proxy
       
    proxy.xxx()
    // vue2.7.14 SFC setup lang='ts'
       
    import {getCurrentInstance} from 'vue'
       
    const proxy = getCurrentInstance()?.proxy
       
    proxy?.xxx?.()
  4. 没有挂在在Vue实例下的方法(使用频率较低):

    // *.js or *.ts
       
    import plugRQw from '@zhangqingcq/plug-r-qw'
       
    plugRQw.xxx()
    // *.js or *.ts
       
    import {xxx} from '@zhangqingcq/plug-r-qw'
       
    xxx()
  5. 所有UI组件均被库注册为了全局组件,所以在需要的地方直接使用即可,如:

     <iconTxtBtn icon='ios-trash' name='批量删除'/>

注意

  • 要看例子,需要下载github上项目,然后npm i安装依赖,然后npm run serve 把项目跑起来,就可以在/index查看各个组件或方法的示例了。

  • 推荐使用pnpm作为你项目的包管理器,但请注意,和使用npm不同,库使用了的依赖如lodash ,你项目在安装库后,想直接使用那些依赖提示“没有该模块”时,需要在你的项目安装该依赖(不能像使用npm时那样偷懒)。

    如果安装依赖失败,可更换国内的镜像再试,淘宝镜像https://registry.npmmirror.com,腾讯云镜像https://mirrors.cloud.tencent.com/npm/

  • 如果你的网络环境较差,安装依赖推荐使用npm淘宝镜像的组合(cnpm在安装一些有自己脚本的依赖时很大机率会报错; 淘宝镜像更新速度较慢,有时要隔一天才会拉到新的资源,所以在使用淘宝镜像有问题时,可以切回官方镜像 继续安装),实在是无法安装成功,可清空npm缓存后使用npm官方镜像 进行安装,如果还是无法成功,那很有可能是你的网络或环境有问题(如node不是稳定版,可降低node版本再尝试;依赖不需要一个一个装,不管哪种工具都直接全部安装)

  • 部分示例有需要请求接口的组件,所以需要在项目目录下新开一个命令窗口运行:npm run node-serve 将该项目配置好的nodeJs服务器启动起来,那些需要请求nodeJs服务器的组件才有数据

  • 因为这个库里面包含UI组件,所以需要在main.js引用lab/plugRQw.min.css 才能正常显示样式,如:import '@zhangqingcq/plug-r-qw/lib/plugRQw.min.css'

  • 如果需要定制化样式(例如主题色),则需要创建一个less文件(如plugRQwTheme.less,注意:这种情况下不再需要引入 plugRQw.min.css),在该文件中顶部引入src/style/index.less ( 如:@import "~@zhangqingcq/plug-r-qw/src/style/index.less";) ,然后在后面写上想要覆盖的变量名,并给出想要的值,如:@primary: #46be87;默认颜色列表默认尺寸列表

    注意:

    • 请不要随意改变这些变量,除非你很清楚改变后会带来的影响,他们在整个库中被多次使用。
    • 因为该库是基于view-design封装的,所以很多样式继承了view-design,要定制那些样式,直接定制view-design即可。
    • 如出现样式异常,请使用[email protected]版本,可以和库的less版本保持一致。
  • 自@zhangqingcq/[email protected]开始,新增了部分全局变量用于控制样式,挂在Vue.prototype下,直接在main.js or main.ts中给对应变量赋值即可定制对应样式:

      //main.js or main.ts
      
      Vue.use()
      Vue.prototype.searchFormLabelWidth = 100
      
      //已支持的全局变量有:pageSizes, searchFormLabelWidth, formModalLabelWidth, formGroupLabelWidth, iconTxtBtnIconSize, btTablePageUsePagePro, pageShowTotal, pageShowSizer, tableSettingBg, tableSettingTransfer, tableSettingEventsEnabled
      //注意:需要在库安装<Vue.use(plugRQw,{...})>后指定全局变量,即将赋值的代码写在use代码之后,否则指定的值会在库安装时被库内全局变量默认覆盖。
  • 因为有些方法使用频率较低,所以没有挂载在app.config.globalProperties或者window上,使用时需要单独引用,如:

      
      import { fullScreenImgPreview } from '@zhangqingcq/plug-r-qw'
  • 本库主要依赖有

    vue、vue-router、pinia、@zhangqingcq/view-design-r、sweetalert、lodash、axios、echarts、moment、wangeditor、xss、js-cookie、ar-cascader、vue-amap、vue-json-viewer

    其中vue、vue-router、vuex(如果用了)需要在使用vue-cli脚手架搭建项目时安装(选上)

    如果你的项目是国际化版本,vue-i18n需要手动安装,其他依赖在项目安装该库后,可直接在项目中使用,无需再次将它们安装至你的项目

    但其中@zhangqingcq/view-design-r、vue-amap需要在你的项目手动初始化,可以参考对应的官网 (@zhangqingcq/view-design-r初始化方法和用法跟view-design一样) 或 npm网站页面 或 本项目examples目录里的初始化方法

  • 该库自@zhangqingcq/[email protected]版本开始,弃用view-design,改用本人改良的@zhangqingcq/view-design-r (这么做的原因是view-design@4x版本自2021年11月以后不再被作者维护,一些问题无望解决),@zhangqingcq/view-design-r 基于[email protected]创建,主要改动是修复了使用中发现的一些view-design的bug和自己的一些定制化。 @zhangqingcq/view-design-r初始化方法和原view-design一样, 只需将原项目中view-design全部替换成@zhangqingcq/view-design-r,如:

    // main.js or main.ts
    import ViewUI from '@zhangqingcq/view-design-r'
    import '@zhangqingcq/view-design-r/dist/styles/iview.css' //使用less变量覆盖默认值定制化UI时无需此行代码
    import '@/global/iViewTheme.less' //不使用less变量覆盖默认值定制化UI时无需此行代码
    import enI from '@zhangqingcq/view-design-r/dist/locale/en-US'
    import zhI from '@zhangqingcq/view-design-r/dist/locale/zh-CN'

    样式定制化文件顶部改为:

    // iViewTheme.less
    
    @import "~@zhangqingcq/view-design-r/src/styles/index.less";
    
    @css-prefix: ivu-; // 像这样在此定制你的UI

    具体可参考本库示例项目examples中的使用方法

  • 该库自@zhangqingcq/[email protected]版本开始,使用了[email protected],如项目有less语法报错,可以在vue.config.js 中加上配置,如:

    module.exports = defineConfig({
      ...,
      css: {
        loaderOptions: {
          less: {
            lessOptions: {
              javascriptEnabled: true,
              math: 'always'
            }
          }
        }
      }
    })
  • 该库自@zhangqingcq/[email protected]版本开始,弃用iview-area,改用本人改良的ar-cascader, 所以升级到该版本及以后,如果你项目中之前有直接使用iview-area,替换成ar-cascader即可。 (在没有直接使用iview-area,而是使用库中alCascader及formR相关组件,则无需做任何改变)

  • 有地图的功能是用的高德地图,要在项目初始化才能使用库中地图功能,初始化方法参考该项目的examples中main.js或高德官方文档

  • 本库采用@vue/cli3脚手架搭建,用@vue/cli3或者更高版本搭建的项目引用不会有兼容问题, 低于@vue/cli3版本或其他脚手架搭建的项目引用可能会有兼容问题,表现就是报错有不认识的语法或功能异常 (目前已知$fetch可能会因为兼容问题无响应),解决方法:

    在webpack中添加loader处理库的输出文件,如@vue/cli2搭建的项目中(由于@vue/cli2脚手架过于老旧,建议更换成较新的cli版本搭建的框架, 项目只是更换框架工作量其实并不大,获得的收益比较高),找到webpack.base.conf.js,在module-->rules下添加

    {
      test: /(index\.js|plugRQw\.umd(\.min){0,1}\.js)$/,
      use: {
        loader: 'babel-loader',
        options: {
          presets: [
            'env',
            "stage-2"
          ]
        }
      },
      include: [path.resolve(__dirname,'../node_modules/@zhangqingcq/plug-r-qw')]
    }

    注意:

    • 这个loader会用到'path'、'core-js'、'babel-loader'、'babel-core'、'babel-preset-env'、'babel-preset-stage-2' 、'webpack',如果项目报错没有这些npm依赖,请安装它们

    • include的路径是该库相对于webpack.base.conf.js文件的相对路径

    • 如果添加了该loader还是有兼容问题,那么将main.js中 import plugRQw from '@zhangqingcq/plug-r-qw' 换成 import plugRQw from '@zhangqingcq/plug-r-qw/lib/plugRQw.umd.js'

本库自带自定义指令

  • has 通过本库内方法hasPermission将传入指令的值进行解析(在sessionStorage中btnPermissions中查找传入的值),如果解析结果为false,则为绑定的元素添加display:none 的内联样式,以此来实现元素的权限控制。

  • loadmore 在容器滚动到底部时调用传入指令的值(回调函数),可通过指令参数传入一个class,来指定滚动的容器(如v-loadmore:boxN='getData' ,boxN的意思为指令绑定元素的某个子元素,它有个class为boxN,而该元素被指定为滚动的容器;getData为回调函数,比如在函数内部拉取数据并渲染到容器内),滚动容器默认为指令绑定的元素

  • clickOutside 在容器外部有鼠标点击事件时触发(如v-click-outside='close'