/csj-tiger-vue

Primary LanguageVueMIT LicenseMIT

一、知识参考

  1. vue.js

  2. ECMAScript 6 入门

  3. vue-element-admin

  4. element-ui

  5. Lodash 中文文档

  6. webpack概述


二、代码拉取以及启动方式

拉取

http方式:

git clone http://lis530@192.168.1.226/deliverGroup/csj-shark-vue.git

ssh方式:

git clone git@192.168.1.226:deliverGroup/csj-shark-vue.git

启动方式

npm run start

打包方式

测试环境:

npm run build-test

正式环境:

npm run build


三、目录结构

参考vue-element-admin


四、组价介绍

ItemTitle(模块标题组件)

模块的标题,突出该模块

使用方式

 <item-title text="基本信息"/>
 

属性介绍

属性 描述 类型 默认值 是否必填
text 标题名称 String -
boxStyle 标题盒子的样式 String width:100%

ItemCard(详情页基本信息卡片组件)

详情页基本信息卡片

使用方式

 <item-card :config="infoConfig" :loading="loading"   :cardData="config"  />
 

属性介绍

属性 描述 类型 默认值 是否必填
config 配置属性 Array -
cardData 数据源 Object {}
loading loading Boolean false
boxStyle 外层盒子的样式 String marginBottom:12px
bodyStyle 卡片的样式 String padding:12px

config配置项参数介绍

[
  {
      title:'',
      prop:'',
      type:'',
      useApi:'',
      useLocalEnum:'',
      userFormatter:'',
      format:'',
  }
]

| 属性 | 描述 | 类型 | | --- | --- | --- | --- | | title | 标题 | String | | prop | 索引key | String | | type | 类型:time,boolean,toFixed,其他本地定义的api方法名或枚举名(结合useLocalEnum,useApi),可以很方便的进行数据的格式化和类型转换 | String | | format | type为time时的时间展示格式(默认:YYYY-MM-DD) | String | | useApi | 是否使用本地api枚举,使用时只需将useApi设置为true,同时给type传递一个api枚举的方法名即可 | Boolean | | useLocalEnum | 是否使用本地前端定义的枚举,使用时只需将useLocalEnum设置为true,同时给type传递一个枚举的方法名即可 | Boolean | | userFormatter | 格式化函数 | function | | uesStringify | 文本插件{ title:'入参',prop:'paramData',span:24,uesStringify:true,rows:4}, | Boolean | | useIf | 可以实现诸如 files、link、linkDom的渲染 | String |

useIf配置项参数介绍

| 属性 | 描述 | | --- | --- | --- | --- | | files | 数据源是一个数组 [{path:'',name:''}] | | | link | 结合linkTo、query使用 useIf:'link',linkTo:'/warehousing/businessorder-detail',query:[{key:'busiBillNo',value:'busiBillNo'}] | | linkDom |结合linkTo、query、linkText使用useIf:'linkDom',linkTo:'/warehousing/plan-detail',query:[{key:'planCode',value:'signNo'}],linkText:'查看入库详情' |


UploadMode(文件上传组件组件)

上传附件组件

使用方式

  <upload-mode
    @fileListChange="fileListChange" 
    :defailFileList="[]" >
  </upload-mode>
 

属性介绍

属性 描述 类型 默认值 是否必填
defailFileList 默认已上传的列表数组 [{ name: '', url: ''}] 注:name:文件名,url:绝对路径 Array -
filesuploadUrl 文件上传的地址 String /webApi/fileupload/common/filetoserver

方法介绍

方法 描述 返回值
fileListChange 上传成功和移除文件的回调 上传成功的文件列表

table组件

1. BaseTable(后端分页table组件)

后端分页组件,支持后端分页,,多用于主页table

使用方式

   <template>
     <base-table 
      @sizeChange="handleSizeChange"
      @currentChange="handleCurrentChange"
      :loading="loading"
      :config="listIndexConfig"  
      :total="total" 
      :maxTotal="10"
      :pageSize="pageSize"
      :currentPage="pageNum"
      :tableData="tableData"/>
   </template>
   
   <script>
     import BaseTable from '@/components/Table'
     export default {
       components: { BaseTable},    
     }
   </script>
 

2. WebPaginationTable(前端分页table组件)

前端分页组件,多用于详情页table

使用方式

   <template>
    <web-pagination-table 
    :loading="loading"
    :config="detailAbnormalReceipt" 
    :allTableData="detailAbnormalReceiptData"/>
   </template>
   
   <script>
   import WebPaginationTable from '@/components/Table/webPaginationTable'
     export default {
       components: { WebPaginationTable},    
     }
   </script>
 

3. EditTable(可编辑table组件,仅支持前端分页)

参考出库技术>手工出库页面

使用方式

   <template>
      <edit-table 
        :loading="loading"
        :config="tableConfig" 
        :allTableData="tableData"
        @goeditrow="goeditrow"
        @handleDelete="handleDelete"/>
   </template>
   
   <script>
    import editTable from '@/components/Table/editTable'
     export default {
       components: { EditTable},    
     }
   </script>
 

4. NestingTable(多功能嵌套table组件,仅支持前端分页)

参考供应商直发登记页面

使用方式

   <template>
      <nesting-table 
        :loading="loading"
        :useEdit="true"
        :useDelet="false"
        :useEditExpand="true"
        :defaultExpandAll="true"
        childTableDataKey="billDetailList"
        editText="登记收货量"
        :config="addTableConfig" 
        :childConfig="addChildTableConfig"
        :allTableData="tableData"
        @goeditrow="goeditrow"/>
   </template>
   
   <script>
    import NestingTable from '@/components/Table/nestingTable'
     export default {
       components: { NestingTable},    
     }
   </script>
 

属性介绍

属性 描述 类型 默认值 是否必填
loading loading Boolean false
elementLoadingText loading提示文字 String 加载中
elementLoadingBackground loading背景颜色 String rgba(255, 255, 255, 0.5)
highlightCurrentRow 是否要高亮当前行 可以用此做单选 Boolean false
config 配置属性 Array -
tableData 后端分页数据源(后端分页参数) Array -
allTableData 前端分页数据源(前端分页参数) Array -
usePagination 是否使用前端分页 (前端分页参数) Boolean false
total 数据的总长度 Number 0
currentPage 当前页码 (后端分页参数) Number 1
pageSize 每页显示的条数 (后端分页参数) Number 10
pageSizes 分页规格数组 Array [10, 50, 100, 500]
maxTotal 只有表格的数据条数大于这个值的时候才显示分页 Number 10
layout 布局组件 参考element-ui String total, sizes, prev, pager, next, jumper
border 是否展示纵向边框 Boolean true
tableStyle 表格的样式 String width: 100%
paginationStyle 分页器的样式 String marginTop:16px
useEdit 是否使用可编辑(可编辑表格属性) Boolean false
useEditExpand 是否使用嵌套表格(NestingTable属性) Boolean false
useDelet 外层是否展示删除按钮(NestingTable属性) Boolean true
editText 外层编辑按钮文案(NestingTable属性) String 编辑
defaultExpandAll 是否默认展开所有扩展(NestingTable属性) Boolean false
childConfig 嵌套表格子表配置(NestingTable属性) Array []
childTableDataKey 嵌套表格子表数据所使用的父级索引(NestingTable属性) Array []

config配置项参数介绍

[
  {
      lable:'',
      prop:'',
      minWidth:'',
      fixed:'',
      width:'',
      type:'',
      useApi:'',
      useLocalEnum:'',
      format:'',
      dom:'',
      linkTo:'',
      query:[],
      linkText:'',
  }
]

| 属性 | 描述 | 类型 | | --- | --- | --- | --- | | lable | 表头 | String | | prop | 索引key | String | | type | 类型:time,Boolean,toFixed,index,files其他本地定义的api方法名或枚举名(结合useLocalEnum,useApi),可以很方便的进行数据的格式化和类型转换,对应列的类型 | String | | columnType | element的原生type 如果设置了 columnType:'selection' 则显示多选框 | String | | format | type为time时的时间展示格式(默认:YYYY-MM-DD) | String | | useApi | 是否使用本地api枚举,使用时只需将useApi设置为true,同时给type传递一个api枚举的方法名即可 | Boolean | | useLocalEnum | 是否使用本地前端定义的枚举,使用时只需将useLocalEnum设置为true,同时给type传递一个枚举的方法名即可 | Boolean | | minWidth | 单元格最小宽度 | Number或者String | | width | 单元格宽度 | Number或者String | | fixed | 是否固定表头 | Boolean或者String('left'、'right') | | dom | dom传递 | function类型:(row, column, cellValue, index)=>return <div>{cellValue}</div> | | linkTo | 跳转的路径,该属性需要结合query | String | | query | 页面跳转时query上的属性以及所使用的索引 query:[{key:'warehouseExeCode',value:'warehouseExeCode'}] | Array | | linkText | link随时用的文案(不传时直接为单元格值) | String | | edit | 是否可开始使用可编辑(可编辑表格属性) | String | | editType | 可编辑的类型(可编辑表格属性) | String | | max | 最大值索引数组(可编辑表格属性) | Array | | min | 最小值(可编辑表格属性) | Number |

方法介绍

方法 描述 返回值
sizeChange pageSize变化后的回调 (后端分页回调) pageSize:当前每页展示多少条
currentChange 页码变化后的回调 (后端分页回调) currentPage: 当前页码
currentRedioChange 点击某一行回调,可以用此做单选 同时将highlightCurrentRow设置为true 选中时高亮 currentRow:当前该行数据, oldCurrentRow:上一行数据
SelectionChange 多选选中后的回调 (前端分页回调) val:选中的行数组成的数组
goeditrow 点击编辑或者确定后的回调(可编辑表格属性) index:索引,type:按钮操作类型
handleDelete 点击删除的回调(可编辑表格属性) index:索引,type:按钮操作类型