Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@zhangqingcq/plug-r-qw

Package Overview
Dependencies
Maintainers
3
Versions
499
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@zhangqingcq/plug-r-qw

A JS lib base on Vue@3.x and view-ui-plus, you can achieve some complex functions with simple code after install this lib.

  • 2.0.31
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
1.1K
increased by17983.33%
Maintainers
3
Weekly downloads
 
Created
Source

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/plug-r-qw@2.x.x

vue2: @zhangqingcq/plug-r-qw@1.x.x

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的项目大同小异,除了下面的不同,其他都相同。

    如果用了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 plugRQw from '@zhangqingcq/plug-r-qw'
    
    plugRQw.xxx()
    
    // 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作为你项目的包管理器

  • 你的项目使用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;默认颜色列表默认尺寸列表

    注意:

    1. 请不要随意改变这些变量,除非你很清楚改变后会带来的影响,他们在整个库中被多次使用。
    2. 因为该库是基于view-ui-plus封装的,所以很多样式继承于view-ui-plus,要定制那些样式,直接定制view-ui-plus即可。
  • 该库有数个用于控制样式的全局变量,挂在app.config.globalProperties下,直接在main.js or main.ts中给对应变量赋值即可定制对应样式:

      //main.js or main.ts
    
      app.config.globalProperties.searchFormLabelWidth = 100
    
      //已支持的全局变量有:searchFormLabelWidth, formModalLabelWidth, formGroupLabelWidth, iconTxtBtnIconSize
    
  • 该库主要依赖有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
        },
        ...
      })
    
  • 该库使用了less@4.2.x,如项目有less语法报错,可以在vite.config.jsorvite.config.ts 中加上配置,如:

    export default defineConfig({
      ...
      css: {
      	  preprocessorOptions: {
      		  less: {
      			  javascriptEnabled: true,
      			  rewriteUrls: 'all',
      			  math: 'always'
      		  }
      	  }
        }
    })
    

本库自带自定义指令

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

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

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/plug-r-qw@1.3.12开始支持TypeScript + Vue的项目(非TypeScript项目依然支持,用法没有任何改动),用法和之前 JS + Vue的项目大同小异,除了下面列出的不同,其他都相同。

    为了更好的支持Typescript类型检查,我们需要在Vue接口模块补充

    该库的全局方法,这样可以避免使用this.xxxproxy.xxx(proxy为vue@2.7.14的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中添加该文件
    
    // tsconfig.json
    {
      "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/plug-r-qw@1.3.12开始支持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()
    
  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时那样偷懒)。

  • 如果你的网络环境较差,安装依赖推荐使用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;默认颜色列表默认尺寸列表

    注意:

    1. 请不要随意改变这些变量,除非你很清楚改变后会带来的影响,他们在整个库中被多次使用。
    2. 因为该库是基于view-design封装的,所以很多样式继承了view-design,要定制那些样式,直接定制view-design即可。
  • 自@zhangqingcq/plug-r-qw@1.4.8开始,新增了部分全局变量用于控制样式,挂在Vue.prototype下,直接在main.js or main.ts中给对应变量赋值即可定制对应样式:

      //main.js or main.ts
    
      Vue.prototype.searchFormLabelWidth = 100
    
      //已支持的全局变量有:searchFormLabelWidth, formModalLabelWidth, formGroupLabelWidth, iconTxtBtnIconSize
    
  • 因为有些方法使用频率较低,所以没有挂载在Vue原型或者window上,使用时需要单独引用,如:improt {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/plug-r-qw@1.3.0版本开始,弃用view-design,改用本人改良的@zhangqingcq/view-design-r (这么做的原因是view-design@4x版本自2021年11月以后不再被作者维护,一些问题无望解决),@zhangqingcq/view-design-r 基于view-design@4.7.0 创建,主要改动是修复了使用中发现的一些view-design的bug和自己的一些定制化。@zhangqingcq/view-design-r 初始化方法和原view-design一样,只需将原项目中view-design全部替换成@zhangqingcq/view-design-r,如:

      import ViewUI from '@zhangqingcq/view-design-r'
      import '@zhangqingcq/view-design-r/dist/styles/iview.css'
      import enI from '@zhangqingcq/view-design-r/dist/locale/en-US'
      import zhI from '@zhangqingcq/view-design-r/dist/locale/zh-CN'
    
      样式定制化文件顶部改为:
      @import "~@zhangqingcq/view-design-r/src/styles/index.less";
    
      具体可参考本库示例项目examples中的使用方法
    
  • 该库自@zhangqingcq/plug-r-qw@1.3.0版本开始,使用了less@4.0.0,如项目有less语法报错,可以在vue.config.js 中加上配置,如:

    module.exports = defineConfig({
      ...
      css: {
        loaderOptions: {
          less: {
            lessOptions: {
              javascriptEnabled: true
            }
          }
        }
      }
    })
    
    
  • 该库自@zhangqingcq/plug-r-qw@1.1.35版本开始,弃用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')]
      }
      
      注意:
        1. 这个loader会用到'path'、'core-js'、'babel-loader'、'babel-core'、'babel-preset-env'、'babel-preset-stage-2'、'webpack',如果项目报错没有这些npm依赖,请安装它们
        2. include的路径是该库相对于webpack.base.conf.js文件的相对路径
        3. 如果添加了该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为回调函数,比如在函数内部拉取数据并渲染到容器内),滚动容器默认为指令绑定的元素

Keywords

FAQs

Package last updated on 20 Mar 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc