@zhangqingcq/plug-r-qw - npm Package Compare versions

Comparing version 1.0.73 to 1.0.74

package.json

 {
   "name": "@zhangqingcq/plug-r-qw",
-  "version": "1.0.73",
+  "version": "1.0.74",
   "description": "this is a collection fo plug-in developed when I was in qw",
@@ -48,4 +48,2 @@ "main": "/lib/plugRQw.umd.min.js",
     "node-sass": "^4.12.0",
-    "nprogress": "0.2.0",
-    "qs": "^6.7.0",
     "sass-loader": "^8.0.0",
@@ -52,0 +50,0 @@ "style-loader": "^1.2.1",

README.md

@@ -14,2 +14,4 @@ # plug-r-qw
 
-* 因为有些方法使用频率较低，所以没有挂载在Vue原型或者window上，使用时需要单独引用，如：`improt {fullScreenImgPreview} from '@zhangqingcq/plug-r-qw'`
+* 因为有些方法使用频率较低，所以没有挂载在Vue原型或者window上，使用时需要单独引用，如：`improt {fullScreenImgPreview} from '@zhangqingcq/plug-r-qw'`
+
+* 本库运行依赖vue、vue-router、vuex、view-design、sweetalert、lodash、axios、echarts、moment、wangeditor、js-cookie、iview-area、vue-amap、vue-json-viewer，但并未将他们的代码打包到库的生产版本中，所以需要在你的项目中安装他们才能使用该库

src/components/formR/README.md

@@ -90,6 +90,7 @@ ## formR
 ### formData元素支持字段说明（按字母升序）
-* <a name='activeChange'>activeChange</a> 布尔对象，InputNumber（数字输入框）是否实时响应数据，设置为`false`时，只会在失焦时更改数据，默认:`true`
+* <a name='activeChange'>activeChange</a> 布尔对象，InputNumber（数字输入框）是否实时响应数据，设置为`false`时，只会在失焦时更改数
+据，默认:`true`
 
-* <a name='addTime'>addTime</a> 布尔对象，DatePicker不选择时间（只选日期）时，但提交时需要带上时间，给该字段赋值`true`,会自动加上`00:00:00`，
-如果是区间，开始时间加`00:00:00`，结束时间加`23:59:59`，默认:`false`
+* <a name='addTime'>addTime</a> 布尔对象，DatePicker不选择时间（只选日期）时，但提交时需要带上时间，给该字段赋值`true`,会自动加上
+`00:00:00`，如果是区间，开始时间加`00:00:00`，结束时间加`23:59:59`，默认:`false`
 
@@ -101,3 +102,4 @@ * <a name='asyncOption'>asyncOption</a> 布尔对象，有选项的表单项的待选项数据来源于接口，需配合[optionUrl](#optionUrl)使用，默认:`false`
 
-* <a name='borrowOption'>borrowOption</a> 字符串，有待选项的表单项，待选项数据来自另一表单项的待选项时（借用），需给该字段赋值另一表单项的key对应的值
+* <a name='borrowOption'>borrowOption</a> 字符串，有待选项的表单项，待选项数据来自另一表单项的待选项时（借用），需给该字段赋值另一表
+单项的key对应的值
 
@@ -107,3 +109,4 @@ * <a name='buttonType'>buttonType</a> 布尔对象，RadioGroup是否为按钮样式，按钮样式即为一排连在一起的按钮，默认：`false`
 * <a name='changeOption'>changeOption</a> 布尔对象/对象/数组，有待选项的表单项，待选项数据从接口拉取时，拉取地址会改变，给该字段赋值
-`true`，需要改变时直接改变[optionUrl](#optionUrl)即可；如果地址有的查询条件是另一表单项的值，则给该字段赋值对象，如：`{valKey:'name',key:'user'}`
+`true`，需要改变时直接改变[optionUrl](#optionUrl)即可；如果地址有的查询条件是另一表单项的值，则给该字段赋值对象，如：
+`{valKey:'name',key:'user'}`
 表示其中一个查询条件是`&user=name表单项的值`，name表单项值改变，optionUrl就会自动改变，就会重新拉取待选项数据；如果有多个这种条件，用数
@@ -114,3 +117,4 @@ 组存放他们，如：`[{valKey...},{...}]`
 
-* <a name='collectLabel'>collectLabel</a> 对象/数组，选项中除val外的其他字段（如label）连同值一并返回，如：`collectLabel:{valKey:'label',key:'name'}`，
+* <a name='collectLabel'>collectLabel</a> 对象/数组，选项中除val外的其他字段（如label）连同值一并返回，如：
+`collectLabel:{valKey:'label',key:'name'}`，
 表示表单被提交时，该表单项选中项的label会以name被一起提交出去。
@@ -136,3 +140,4 @@
 
-* <a name='disabled'>disabled</a> 布尔对象，禁用表单项，因为formData非响应式，自然该字段也非响应式，注意：这和组件props中disabled不是同一个，默认：`false`
+* <a name='disabled'>disabled</a> 布尔对象，禁用表单项，因为formData非响应式，自然该字段也非响应式，注意：这和组件props中disabled
+不是同一个，默认：`false`
 
@@ -154,3 +159,4 @@ * <a name='disableOptionByOthers'>disableOptionByOthers</a> 字符串/数组，根据其他表单项的值禁用待选项，例如：表单中有一个下拉框的
 
-* <a name='key'>key</a> 字符串，表单被提交时该项收集的数据所在字段，如：`{type:'input',key:'name'}`,用户输入`'Ricky'`，提交时返回`{name:'Ricky'}`
+* <a name='key'>key</a> 字符串，表单被提交时该项收集的数据所在字段，如：`{type:'input',key:'name'}`,用户输入`'Ricky'`，提交时返回
+`{name:'Ricky'}`
 
@@ -181,9 +187,13 @@ * <a name='key2'>key2</a> 字符串，除key以外的另一要收集的数据，如时间区间，key为起始，key2为终止，以此类推，如果有三个数据，则有key3等
 
-* <a name='numberVal'>numberVal</a> 布尔对象，表单项收集的值自动转换为number类型，需是类似number的字符串才能转，否则收集的值为字符串，默认：`false`
+* <a name='numberVal'>numberVal</a> 布尔对象，表单项收集的值自动转换为number类型，需是类似number的字符串才能转，否则收集的值为字符串，
+默认：`false`
 
-* <a name='onlyLastVal'>onlyLastVal</a> 布尔对象，只返回最后一级的值，表单项特殊配置，如远程数据级联，具体见后面的'type说明'，默认：`true`
+* <a name='onlyLastVal'>onlyLastVal</a> 布尔对象，只返回最后一级的值，表单项特殊配置，如远程数据级联，具体见后面的'type说明'，默认：
+`true`
 
-* <a name='onlyLastLabel'>onlyLastLabel</a> 布尔对象，只显示最后一级的label，表单项特殊配置，如远程数据级联，具体见后面的'type说明'，默认：`true`
+* <a name='onlyLastLabel'>onlyLastLabel</a> 布尔对象，只显示最后一级的label，表单项特殊配置，如远程数据级联，具体见后面的'type说明'，
+默认：`true`
 
-* <a name='options'>options</a> 对象，有待选项的表单项，待选项数据存放在该字段下，[详细说明](#optionsDetail)，如：`{type:'select',key:'sex',options:[{label:'男',val:1},{label:'女',val:0}]}`
+* <a name='options'>options</a> 对象，有待选项的表单项，待选项数据存放在该字段下，[详细说明](#optionsDetail)，如：
+`{type:'select',key:'sex',options:[{label:'男',val:1},{label:'女',val:0}]}`
 
@@ -193,4 +203,4 @@ * <a name='optionLabel'>optionLabel</a> 字符串/数组，有待选项的表单项，待选项数据从接口拉取时，待选项label对应接口数据的字段名，如：
 
-* <a name='optionUrl'>optionUrl</a> 字符串，有待选项的表单项，待选项数据从接口拉取时，接口地址放在该字段下，需配合[asyncOption](#asyncOption)、[optionLabel](#optionLabel)、
-[optionVal](#optionVal)使用，注意：请求方式为get，且不可更改
+* <a name='optionUrl'>optionUrl</a> 字符串，有待选项的表单项，待选项数据从接口拉取时，接口地址放在该字段下，需配合
+[asyncOption](#asyncOption)、[optionLabel](#optionLabel)、[optionVal](#optionVal)使用，注意：请求方式为get，且不可更改
 
@@ -207,5 +217,5 @@ * <a name='optionVal'>optionVal</a> 字符串，有待选项的表单项，待选项数据从接口拉取时，待选项val对应接口数据的字段名，如：`optionVal:'id'`
 
-* <a name='show'>show</a> 对象/数组，表单项显示设置，[详细说明](#showDetail)如：`{key:'name',val:['Ricky','Tom']}`，表示只在name为Ricky或Tom时显示该表
-单项；如果有多个条件，用数组装这些条件对象，如：`[{key,val...},{...}]`，它们的关系为且，即所有条件都满足才显示，如果需要条件关系为或，给
-表单项[showOr](#showOr)赋值`true`
+* <a name='show'>show</a> 对象/数组，表单项显示设置，[详细说明](#showDetail)如：`{key:'name',val:['Ricky','Tom']}`，表示只在
+name为Ricky或Tom时显示该表单项；如果有多个条件，用数组装这些条件对象，如：`[{key,val...},{...}]`，它们的关系为且，即所有条件都满足才显
+示，如果需要条件关系为或，给表单项[showOr](#showOr)赋值`true`
 
@@ -231,3 +241,4 @@ * <a name='showImg'>showImg</a> 布尔对象，uploadGroup是否以图片方式显示已上传的图片文件，默认：`false`
 
-* <a name='valKey'>valKey</a> 字符串，表单项值为表单中另外一个表单项（兄弟项）收集数据中的一个字段，只有type为txt时有效，具体用法见后面的'type说明'
+* <a name='valKey'>valKey</a> 字符串，表单项值为表单中另外一个表单项（兄弟项）收集数据中的一个字段，只有type为txt时有效，具体用法见后
+面的'type说明'
 
@@ -388,3 +399,4 @@ * <a name='withCredentials'>withCredentials</a> 布尔对象，uploadGroup远程上传时是否携带cookie，默认：`true`
 
-* [key](#key) 表单项收集的数据在提交时所在字段，如果有默认值，默认值会存放在该字段下，该表单项该字段是会随着选择框的值改变的，key改变时表单项值会自动清空
+* [key](#key) 表单项收集的数据在提交时所在字段，如果有默认值，默认值会存放在该字段下，该表单项该字段是会随着选择框的值改变的，key改变时表
+单项值会自动清空
 
@@ -416,3 +428,3 @@ * [defaultVal](#defaultVal) 默认值
 
-* [defaultVal](#defaultVal) 默认值
+* [defaultVal](#defaultVal) 默认值，行政区域编码，如：`500103000000`
 
@@ -560,2 +572,4 @@ * [level](#level) 行政区域级数，默认：`2`，表示到区县级；0-省级，1-市级，2-区县，3-街道
 
+* 注意：该类型表单项值为数组
+
 #### textarea 文本框
@@ -591,3 +605,3 @@ * [label](#label) 标签
 
-* [defaultVal](#defaultVal) 默认值
+* [defaultVal](#defaultVal) 默认值，仅远程上传时支持默认值，为文件id
 
@@ -620,8 +634,110 @@ * [url](#url) 远程上传接口地址
 
-* 注意：远程上传时，值为上传成功后接口返回的文件id，或id组成的数组；本地上传时，值为file对象，或file对象组成的数组；远程上传时有诸多限制，具
-体参考[uploadGroup](../uploadGroup/README.md)组件的README.md文档
+* 注意：远程上传时，值为上传成功后接口返回的文件id，或id组成的数组；本地上传时，值为file对象，或file对象组成的数组；远程上传时有诸多限制，
+具体参考[uploadGroup](../uploadGroup/README.md)组件的README.md文档
 
+#### date 日期选择器
+* [label](#label) 标签
 
+* [key](#key) 表单项收集的数据在提交时所在字段
 
+* [defaultVal](#defaultVal) 默认值
 
+* [defaultVal2](#defaultVal2) 默认值2，为区间时间时，结束时间默认值
 
+* [dateType](#dateType) 日期类型，可选值：date、daterange、datetime、datetimerange、year、month
+
+* [dateOptions](#dateOptions) DatePicker选择器额外配置，比如不可选日期与快捷选项
+
+* [placeholder](#placeholder) 占位符，默认：`'请选择'`
+
+* [clearable](#clearable) 表单项是否可单独清空，为true且输入框有值时，光标移动到输入框尾部会有小叉，点击清空，默认：`true`
+
+* [disabled](#disabled) 禁用该表单项，非响应式，可用updateFormDataT方法更改，默认：`false`
+
+* [show](#show) 显示条件
+
+* [showOr](#showOr) 显示条件间关系，设置true时为或运算，默认：`false`
+
+* [info](#info) 表单项的提示文字，位于表单项下面
+
+* [title](#title) 表单项的标题，位于表单项左上方
+
+#### editor 富文本框
+* [label](#label) 标签
+
+* [key](#key) 表单项收集的数据在提交时所在字段
+
+* [defaultVal](#defaultVal) 默认值
+
+* [disabled](#disabled) 禁用该表单项，非响应式，可用updateFormDataT方法更改，默认：`false`
+
+* [show](#show) 显示条件
+
+* [showOr](#showOr) 显示条件间关系，设置true时为或运算，默认：`false`
+
+* [info](#info) 表单项的提示文字，位于表单项下面
+
+* [title](#title) 表单项的标题，位于表单项左上方
+
+#### inputMap 地图组件
+* [label](#label) 标签
+
+* [key](#key) 表单项收集的数据在提交时所在字段，经度
+
+* [key2](#key2) 表单项收集的数据在提交时所在字段，纬度
+
+* [defaultVal](#defaultVal) 默认值，经度
+
+* [defaultVal2](#defaultVal2) 默认值2，纬度
+
+* [showMap](#showMap) 显示地图，默认：`true`
+
+* [mapHeight](#mapHeight) 地图高度，默认：`'250px'`
+
+* [placeholder](#placeholder) 占位符，默认：`'搜索'`
+
+* [disabled](#disabled) 禁用该表单项，非响应式，可用updateFormDataT方法更改，默认：`false`
+
+* [show](#show) 显示条件
+
+* [showOr](#showOr) 显示条件间关系，设置true时为或运算，默认：`false`
+
+* [info](#info) 表单项的提示文字，位于表单项下面
+
+* [title](#title) 表单项的标题，位于表单项左上方
+
+#### custom 自定义组件
+* [label](#label) 标签
+
+* [key](#key) 表单项收集的数据在提交时所在字段
+
+* [defaultVal](#defaultVal) 默认值
+
+* [slotName](#slotName) 插槽名字，自定义组件通过插槽接入表单
+
+* [show](#show) 显示条件
+
+* [showOr](#showOr) 显示条件间关系，设置true时为或运算，默认：`false`
+
+* [info](#info) 表单项的提示文字，位于表单项下面
+
+* 注意：自定义组件限制非常少，理论上想放什么进来都行，需遵循几点，具名插槽模板放在formR组件标签内，将valGroup（表单组件收集值的对象）传进模板，如：
+```
+  <form-r>
+    <template #myFormItem='{valGroup}'>
+      <i-switch v-model='valGroup.myKey'/>
+    </template>
+  </form-r>
+  
+  其中myFormItem为slotName的值，myKey为key的值
+```
+* 注意：有时候自定义组件不靠formR组件收集值（仅展示或有独立的采集值的逻辑），则不需要设置key，也不支持defaultVal，如：
+```
+  <formR>
+    <template slot='myFormItem2'>
+      <Table :columns='columns' :data='data'/>
+    </template>
+  </formR>
+  
+  其中myFormItem2为slotName的值，columns和data是使用formR组件的地方定义的table的数据
+```

No alert changes

Improved metrics

Total package byte prevSize

1038972

increased by0.56%

Dev dependency count

28

decreased by-6.67%

Lines of code

15736

increased by0.14%

Number of lines in readme file

16

increased by14.29%

No dependency changes