jwtx-common-component-library开发文档
适用于PC端涉及表单功能的后台管理系统,简化开发流程,开箱即用
作者:杭文镭
npm地址:www.npmjs.com/package/jwt…
改进建议(邮箱):hangwenlei@gmail.com
在线文档地址:kdocs.cn/join/gt3jfa… (后期会进行在线化文档部署)
依赖环境:Vue3 + vite + element-plus + sass
组件库
JwTable表格
- 支持单元格宽度根据文本内容长度自适应
- 表格行的操作按钮组会根据操作列的宽度进行自适应,放不下的按钮则自动进入更多下拉列
- 表格的统一操作按钮组(比如批量操作)支持统一化配置,内置了弹窗,仅需将弹窗功能内容放入插槽即可
- 支持当前页以及跨页进行表格的勾选操作
- 表头列的展现、表格行的操作按钮、统一操作按钮可进行权限化配置
- 可接收一个返回promise的函数,用来异步获取表格数据(言外之意就是支持将表格数据的请求接口直接传入,并传入一个数据格式化的函数使表格内容正常展现,筛选条件需额外传入,会被自动带到请求的参数中去),也支持直接静态数据的传入并展现
- 对于分页的支持
- 表头列的展示支持动态函数传入控制
- 所有其余配置继承element-plus的table组件
JwBtnList按钮群组
- 支持权限配置
- 支持按钮群组根据父容器的宽度进行自适应,放不下的按钮则自动进入更多下拉列(从JwTable组件中单独抽离出来)
JwTform表单
- 支持权限配置
- 集成了input、inputNumber、select、datePicker、timerPicker交互组件,所有配置也继承自element-plus,简化开发。v-model直接绑定一个表单数据对象,传入一个配置对象控制各个交互项
- 如果是inline模式,每一表单交互项会以最合适的宽度自适应布满整个父容器,如果是block模式,则单个表单交互会设为width: 100%
JwSearch筛选交互项群组
- 对JwForm进行再次封装成一个针对搜索的模块组件
JwImage图片
- 优化了图片加载的视觉效果,支持三种模式:默认加载(行内元素)、以块级元素加载(区域块)、转圈圈的加载方式
- 图片从加载到现实做了淡入的效果
- 支持控制图片防止被选中跟拖拽
JwIcon图标
- 结合本地字体图标库使用,传入一个class类名
JwLoadingSelect下拉筛选项
- 传入一个返回promise的函数,用来加载下拉数据,下拉数据会在下拉事件触发的时候执行,也支持直接传入下拉数据
JwUploadImage图片上传JwUploadImageSingle单个图片上传JwUploadImageBlock图片上传(整个区域块)
自定义指令
v-echart数据图形可视化v-draggable拖拽v-resize监听元素尺寸变化v-permission权限管理v-tooltip文本tooltip显示优化
公共方法
- aesDecrypt
- aesEncrypt
- cloneRestForm
- convertToDate
- copyText
- deepFindFromOut
- deepForEachFromOut
- deepFindObjectAndParents
- downloadZipByCDN
- fileDownload
- findLabelPathByKey
- flattenArray
- floorToTwoDecimalsString
- fmtRefObjAttrs
- formatDateTimeToString
- formatDateToString
- formatTime
- generateRandomString
- getActualSize
- getActualTextWidth
- getCloneForm
- getDepth
- getFmtDateTimeData
- getFmtTimePickerData
- getLastMonthRange
- getLastYearRange
- getPermission
- getSessionStore
- getStore
- isNull
- isPrimitive
- isPromise
- isUncloneableType
- loadFont
- parseStyleString
- removeSessionStore
- removeStore
- rsaEncrypt
- setRemSize
- setSessionStore
- setStore
- showNoPermissionOverlay
- hideNoPermissionOverlay