c4c9bc6068d02afde68c36720206acf751444993.svn-base 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181
  1. # JDictSelectTag 组件用法
  2. ----
  3. - 从字典表获取数据,dictCode格式说明: 字典code
  4. ```html
  5. <j-dict-select-tag v-model="queryParam.sex" placeholder="请输入用户性别"
  6. dictCode="sex"/>
  7. ```
  8. v-decorator用法:
  9. ```html
  10. <j-dict-select-tag v-decorator="['sex', {}]" :triggerChange="true" placeholder="请输入用户性别"
  11. dictCode="sex"/>
  12. ```
  13. - 从数据库表获取字典数据,dictCode格式说明: 表名,文本字段,取值字段
  14. ```html
  15. <j-dict-select-tag v-model="queryParam.username" placeholder="请选择用户名称"
  16. dictCode="sys_user,realname,id"/>
  17. ```
  18. # JDictSelectUtil.js 列表字典函数用法
  19. ----
  20. - 第一步: 引入依赖方法
  21. ```html
  22. import {initDictOptions, filterDictText} from '@/components/dict/JDictSelectUtil'
  23. ```
  24. - 第二步: 在created()初始化方法执行字典配置方法
  25. ```html
  26. //初始化字典配置
  27. this.initDictConfig();
  28. ```
  29. - 第三步: 实现initDictConfig方法,加载列表所需要的字典(列表上有多个字典项,就执行多次initDictOptions方法)
  30. ```html
  31. initDictConfig() {
  32. //初始化字典 - 性别
  33. initDictOptions('sex').then((res) => {
  34. if (res.success) {
  35. this.sexDictOptions = res.result;
  36. }
  37. });
  38. },
  39. ```
  40. - 第四步: 实现字段的customRender方法
  41. ```html
  42. customRender: (text, record, index) => {
  43. //字典值替换通用方法
  44. return filterDictText(this.sexDictOptions, text);
  45. }
  46. ```
  47. # JMultiSelectTag 多选组件
  48. 下拉/checkbox
  49. ## 参数配置
  50. | 参数 | 类型 | 必填 |说明|
  51. |--------------|---------|----|---------|
  52. | placeholder |string | | placeholder |
  53. | disabled |Boolean | | 是否禁用 |
  54. | type |string | | 多选类型 select/checkbox 默认是select |
  55. | dictCode |string | | 数据字典编码或者表名,显示字段名,存储字段名拼接而成的字符串,如果提供了options参数 则此参数可不填|
  56. | options |Array | | 多选项,如果dictCode参数未提供,可以设置此参数加载多选项 |
  57. 使用示例
  58. ----
  59. ```vue
  60. <template>
  61. <a-form>
  62. <a-form-item label="下拉多选" style="width: 300px">
  63. <j-multi-select-tag
  64. v-model="selectValue"
  65. :options="dictOptions"
  66. placeholder="请做出你的选择">
  67. </j-multi-select-tag>
  68. {{ selectValue }}
  69. </a-form-item>
  70. <a-form-item label="checkbox">
  71. <j-multi-select-tag
  72. v-model="checkboxValue"
  73. :options="dictOptions"
  74. type="checkbox">
  75. </j-multi-select-tag>
  76. {{ checkboxValue }}
  77. </a-form-item>
  78. </a-form >
  79. </template>
  80. <script>
  81. import JMultiSelectTag from '@/components/dict/JMultiSelectTag'
  82. export default {
  83. components: {JMultiSelectTag},
  84. data() {
  85. return {
  86. selectValue:"",
  87. checkboxValue:"",
  88. dictOptions:[{
  89. label:"选项一",
  90. value:"1"
  91. },{
  92. label:"选项二",
  93. value:"2"
  94. },{
  95. label:"选项三",
  96. value:"3"
  97. }]
  98. }
  99. }
  100. }
  101. </script>
  102. ```
  103. # JSearchSelectTag 字典表的搜索组件
  104. 下拉搜索组件,支持异步加载,异步加载用于大数据量的字典表
  105. ## 参数配置
  106. | 参数 | 类型 | 必填 |说明|
  107. |--------------|---------|----|---------|
  108. | placeholder |string | | placeholder |
  109. | disabled |Boolean | | 是否禁用 |
  110. | dict |string | | 表名,显示字段名,存储字段名拼接而成的字符串,如果提供了dictOptions参数 则此参数可不填|
  111. | dictOptions |Array | | 多选项,如果dict参数未提供,可以设置此参数加载多选项 |
  112. | async |Boolean | | 是否支持异步加载,设置成true,则通过输入的内容加载远程数据,否则在本地过滤数据,默认false|
  113. 使用示例
  114. ----
  115. ```vue
  116. <template>
  117. <a-form>
  118. <a-form-item label="下拉搜索" style="width: 300px">
  119. <j-search-select-tag
  120. placeholder="请做出你的选择"
  121. v-model="selectValue"
  122. :dictOptions="dictOptions">
  123. </j-search-select-tag>
  124. {{ selectValue }}
  125. </a-form-item>
  126. <a-form-item label="异步加载" style="width: 300px">
  127. <j-search-select-tag
  128. placeholder="请做出你的选择"
  129. v-model="asyncSelectValue"
  130. dict="sys_depart,depart_name,id"
  131. :async="true">
  132. </j-search-select-tag>
  133. {{ asyncSelectValue }}
  134. </a-form-item>
  135. </a-form >
  136. </template>
  137. <script>
  138. import JSearchSelectTag from '@/components/dict/JSearchSelectTag'
  139. export default {
  140. components: {JSearchSelectTag},
  141. data() {
  142. return {
  143. selectValue:"",
  144. asyncSelectValue:"",
  145. dictOptions:[{
  146. text:"选项一",
  147. value:"1"
  148. },{
  149. text:"选项二",
  150. value:"2"
  151. },{
  152. text:"选项三",
  153. value:"3"
  154. }]
  155. }
  156. }
  157. }
  158. </script>
  159. ```