uview-pro 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/changelog.md +424 -406
  2. package/components/u-action-sheet/types.ts +35 -35
  3. package/components/u-action-sheet/u-action-sheet.vue +160 -160
  4. package/components/u-alert-tips/types.ts +39 -39
  5. package/components/u-alert-tips/u-alert-tips.vue +212 -212
  6. package/components/u-avatar/types.ts +34 -34
  7. package/components/u-avatar/u-avatar.vue +193 -193
  8. package/components/u-avatar-cropper/types.ts +23 -23
  9. package/components/u-avatar-cropper/u-avatar-cropper.vue +286 -286
  10. package/components/u-avatar-cropper/weCropper.d.ts +62 -62
  11. package/components/u-avatar-cropper/weCropper.js +1253 -1253
  12. package/components/u-avatar-cropper/weCropper.ts +1255 -1255
  13. package/components/u-back-top/types.ts +39 -39
  14. package/components/u-back-top/u-back-top.vue +125 -125
  15. package/components/u-badge/types.ts +36 -36
  16. package/components/u-badge/u-badge.vue +165 -165
  17. package/components/u-button/types.ts +66 -66
  18. package/components/u-button/u-button.vue +556 -556
  19. package/components/u-calendar/types.ts +63 -63
  20. package/components/u-calendar/u-calendar.vue +592 -592
  21. package/components/u-car-keyboard/types.ts +12 -12
  22. package/components/u-car-keyboard/u-car-keyboard.vue +234 -234
  23. package/components/u-card/types.ts +59 -59
  24. package/components/u-card/u-card.vue +194 -194
  25. package/components/u-cell-group/types.ts +17 -17
  26. package/components/u-cell-group/u-cell-group.vue +50 -50
  27. package/components/u-cell-item/types.ts +54 -54
  28. package/components/u-cell-item/u-cell-item.vue +202 -202
  29. package/components/u-checkbox/types.ts +31 -31
  30. package/components/u-checkbox/u-checkbox.vue +267 -267
  31. package/components/u-checkbox-group/types.ts +32 -32
  32. package/components/u-checkbox-group/u-checkbox-group.vue +79 -79
  33. package/components/u-circle-progress/types.ts +52 -52
  34. package/components/u-circle-progress/u-circle-progress.vue +187 -187
  35. package/components/u-city-select/types.ts +20 -20
  36. package/components/u-city-select/u-city-select.vue +236 -236
  37. package/components/u-col/types.ts +30 -30
  38. package/components/u-col/u-col.vue +123 -123
  39. package/components/u-collapse/types.ts +31 -31
  40. package/components/u-collapse/u-collapse.vue +68 -68
  41. package/components/u-collapse-item/types.ts +25 -25
  42. package/components/u-collapse-item/u-collapse-item.vue +194 -194
  43. package/components/u-column-notice/types.ts +48 -48
  44. package/components/u-column-notice/u-column-notice.vue +176 -176
  45. package/components/u-count-down/types.ts +42 -42
  46. package/components/u-count-down/u-count-down.vue +258 -258
  47. package/components/u-count-to/types.ts +32 -32
  48. package/components/u-count-to/u-count-to.vue +241 -241
  49. package/components/u-divider/types.ts +31 -31
  50. package/components/u-divider/u-divider.vue +121 -121
  51. package/components/u-dropdown/types.ts +32 -32
  52. package/components/u-dropdown/u-dropdown.vue +289 -289
  53. package/components/u-dropdown-item/types.ts +27 -27
  54. package/components/u-dropdown-item/u-dropdown-item.vue +123 -123
  55. package/components/u-empty/types.ts +36 -36
  56. package/components/u-empty/u-empty.vue +88 -88
  57. package/components/u-field/types.ts +69 -69
  58. package/components/u-field/u-field.vue +354 -354
  59. package/components/u-form/u-form.vue +132 -132
  60. package/components/u-form-item/u-form-item.vue +417 -417
  61. package/components/u-full-screen/types.ts +14 -14
  62. package/components/u-full-screen/u-full-screen.vue +82 -82
  63. package/components/u-gap/types.ts +18 -18
  64. package/components/u-gap/u-gap.vue +40 -40
  65. package/components/u-grid/types.ts +19 -19
  66. package/components/u-grid/u-grid.vue +93 -93
  67. package/components/u-grid-item/types.ts +16 -16
  68. package/components/u-grid-item/u-grid-item.vue +130 -130
  69. package/components/u-icon/types.ts +62 -62
  70. package/components/u-icon/u-icon.vue +274 -274
  71. package/components/u-image/types.ts +51 -51
  72. package/components/u-image/u-image.vue +222 -222
  73. package/components/u-index-anchor/types.ts +16 -16
  74. package/components/u-index-anchor/u-index-anchor.vue +86 -86
  75. package/components/u-index-list/types.ts +43 -43
  76. package/components/u-index-list/u-index-list.vue +355 -355
  77. package/components/u-input/types.ts +140 -140
  78. package/components/u-input/u-input.vue +264 -255
  79. package/components/u-keyboard/types.ts +40 -40
  80. package/components/u-keyboard/u-keyboard.vue +158 -158
  81. package/components/u-lazy-load/types.ts +37 -37
  82. package/components/u-lazy-load/u-lazy-load.vue +233 -233
  83. package/components/u-line/types.ts +44 -44
  84. package/components/u-line/u-line.vue +59 -59
  85. package/components/u-line-progress/types.ts +58 -58
  86. package/components/u-line-progress/u-line-progress.vue +109 -109
  87. package/components/u-link/types.ts +43 -43
  88. package/components/u-link/u-link.vue +75 -75
  89. package/components/u-loading/types.ts +35 -35
  90. package/components/u-loading/u-loading.vue +90 -90
  91. package/components/u-loading-popup/types.ts +26 -26
  92. package/components/u-loading-popup/u-loading-popup.vue +239 -239
  93. package/components/u-loadmore/types.ts +79 -79
  94. package/components/u-loadmore/u-loadmore.vue +140 -140
  95. package/components/u-mask/types.ts +43 -43
  96. package/components/u-mask/u-mask.vue +106 -106
  97. package/components/u-message-input/types.ts +74 -74
  98. package/components/u-message-input/u-message-input.vue +255 -255
  99. package/components/u-modal/types.ts +118 -118
  100. package/components/u-modal/u-modal.vue +204 -204
  101. package/components/u-navbar/types.ts +103 -103
  102. package/components/u-navbar/u-navbar.vue +226 -226
  103. package/components/u-no-network/image.ts +2 -2
  104. package/components/u-no-network/types.ts +28 -28
  105. package/components/u-no-network/u-no-network.vue +290 -290
  106. package/components/u-notice-bar/types.ts +111 -111
  107. package/components/u-notice-bar/u-notice-bar.vue +174 -174
  108. package/components/u-number-box/types.ts +42 -42
  109. package/components/u-number-box/u-number-box.vue +312 -312
  110. package/components/u-number-keyboard/types.ts +26 -26
  111. package/components/u-number-keyboard/u-number-keyboard.vue +166 -166
  112. package/components/u-picker/types.ts +123 -123
  113. package/components/u-picker/u-picker.vue +637 -637
  114. package/components/u-popup/types.ts +59 -59
  115. package/components/u-popup/u-popup.vue +359 -359
  116. package/components/u-radio/types.ts +25 -25
  117. package/components/u-radio/u-radio.vue +258 -258
  118. package/components/u-radio-group/types.ts +29 -29
  119. package/components/u-radio-group/u-radio-group.vue +98 -98
  120. package/components/u-rate/types.ts +40 -40
  121. package/components/u-rate/u-rate.vue +234 -234
  122. package/components/u-read-more/types.ts +35 -35
  123. package/components/u-read-more/u-read-more.vue +150 -150
  124. package/components/u-row/types.ts +20 -20
  125. package/components/u-row/u-row.vue +87 -87
  126. package/components/u-row-notice/types.ts +39 -39
  127. package/components/u-row-notice/u-row-notice.vue +213 -213
  128. package/components/u-safe-bottom/u-safe-bottom.vue +46 -46
  129. package/components/u-search/types.ts +53 -53
  130. package/components/u-search/u-search.vue +256 -256
  131. package/components/u-section/types.ts +32 -32
  132. package/components/u-section/u-section.vue +125 -125
  133. package/components/u-select/types.ts +43 -43
  134. package/components/u-select/u-select.vue +361 -361
  135. package/components/u-skeleton/types.ts +20 -20
  136. package/components/u-skeleton/u-skeleton.vue +205 -205
  137. package/components/u-slider/types.ts +32 -32
  138. package/components/u-slider/u-slider.vue +238 -238
  139. package/components/u-status-bar/u-status-bar.vue +65 -65
  140. package/components/u-steps/types.ts +28 -28
  141. package/components/u-steps/u-steps.vue +160 -160
  142. package/components/u-sticky/types.ts +22 -22
  143. package/components/u-sticky/u-sticky.vue +159 -159
  144. package/components/u-subsection/types.ts +36 -36
  145. package/components/u-subsection/u-subsection.vue +328 -328
  146. package/components/u-swipe-action/types.ts +50 -50
  147. package/components/u-swipe-action/u-swipe-action.vue +253 -253
  148. package/components/u-swiper/types.ts +47 -47
  149. package/components/u-swiper/u-swiper.vue +266 -266
  150. package/components/u-switch/types.ts +28 -28
  151. package/components/u-switch/u-switch.vue +136 -136
  152. package/components/u-tabbar/types.ts +36 -36
  153. package/components/u-tabbar/u-tabbar.vue +280 -280
  154. package/components/u-table/types.ts +25 -25
  155. package/components/u-table/u-table.vue +55 -55
  156. package/components/u-tabs/types.ts +51 -51
  157. package/components/u-tabs/u-tabs.vue +284 -284
  158. package/components/u-tabs-swiper/types.ts +53 -53
  159. package/components/u-tabs-swiper/u-tabs-swiper.vue +379 -379
  160. package/components/u-tag/types.ts +37 -37
  161. package/components/u-tag/u-tag.vue +244 -244
  162. package/components/u-td/types.ts +12 -12
  163. package/components/u-td/u-td.vue +87 -87
  164. package/components/u-th/types.ts +12 -12
  165. package/components/u-th/u-th.vue +81 -81
  166. package/components/u-time-line/u-time-line.vue +39 -39
  167. package/components/u-time-line-item/types.ts +14 -14
  168. package/components/u-time-line-item/u-time-line-item.vue +78 -78
  169. package/components/u-toast/types.ts +36 -36
  170. package/components/u-toast/u-toast.vue +233 -233
  171. package/components/u-top-tips/types.ts +14 -14
  172. package/components/u-top-tips/u-top-tips.vue +113 -113
  173. package/components/u-tr/types.ts +8 -8
  174. package/components/u-tr/u-tr.vue +24 -24
  175. package/components/u-upload/types.ts +74 -74
  176. package/components/u-upload/u-upload.vue +545 -545
  177. package/components/u-verification-code/types.ts +22 -22
  178. package/components/u-verification-code/u-verification-code.vue +164 -164
  179. package/components/u-waterfall/types.ts +16 -16
  180. package/components/u-waterfall/u-waterfall.vue +175 -175
  181. package/iconfont.css +912 -912
  182. package/index.scss +23 -23
  183. package/index.ts +202 -204
  184. package/libs/config/config.ts +26 -26
  185. package/libs/config/zIndex.ts +37 -37
  186. package/libs/css/color.scss +155 -155
  187. package/libs/css/common.scss +178 -178
  188. package/libs/css/style.components.scss +7 -7
  189. package/libs/css/style.h5.scss +8 -8
  190. package/libs/css/style.mp.scss +72 -72
  191. package/libs/css/style.nvue.scss +3 -3
  192. package/libs/css/style.vue.scss +177 -177
  193. package/libs/function/$parent.ts +21 -21
  194. package/libs/function/addUnit.ts +13 -13
  195. package/libs/function/color.ts +37 -71
  196. package/libs/function/colorGradient.ts +125 -125
  197. package/libs/function/debounce.ts +28 -28
  198. package/libs/function/deepClone.ts +39 -39
  199. package/libs/function/deepMerge.ts +34 -34
  200. package/libs/function/getParent.ts +59 -59
  201. package/libs/function/getRect.ts +26 -26
  202. package/libs/function/guid.ts +42 -42
  203. package/libs/function/md5.ts +391 -391
  204. package/libs/function/parent.ts +21 -21
  205. package/libs/function/queryParams.ts +60 -60
  206. package/libs/function/random.ts +16 -16
  207. package/libs/function/randomArray.ts +11 -11
  208. package/libs/function/route.ts +118 -118
  209. package/libs/function/styleUtils.ts +83 -83
  210. package/libs/function/sys.ts +15 -15
  211. package/libs/function/test.ts +229 -229
  212. package/libs/function/throttle.ts +31 -31
  213. package/libs/function/timeFormat.ts +54 -54
  214. package/libs/function/timeFrom.ts +48 -48
  215. package/libs/function/toast.ts +14 -14
  216. package/libs/function/trim.ts +21 -21
  217. package/libs/function/type2icon.ts +36 -36
  218. package/libs/hooks/useEmitter.ts +77 -77
  219. package/libs/hooks/useParent.ts +29 -29
  220. package/libs/request/auto-http.ts +76 -76
  221. package/libs/request/index.ts +223 -223
  222. package/libs/store/index.ts +88 -88
  223. package/libs/util/area.ts +3771 -3771
  224. package/libs/util/async-validator.d.ts +62 -62
  225. package/libs/util/async-validator.js +1368 -1368
  226. package/libs/util/city.ts +432 -432
  227. package/libs/util/emitter.ts +102 -102
  228. package/libs/util/mitt.ts +115 -115
  229. package/libs/util/parent.ts +20 -20
  230. package/libs/util/province.ts +37 -37
  231. package/package.json +1 -1
  232. package/readme.md +237 -237
  233. package/theme.scss +38 -38
  234. package/types/components.d.ts +95 -95
  235. package/types/global.d.ts +255 -221
  236. package/types/ignore-errors.d.ts +30 -30
  237. package/types/index.d.ts +90 -90
  238. package/types/uni-app.d.ts +63 -63
@@ -1,417 +1,417 @@
1
- <template>
2
- <view
3
- class="u-form-item"
4
- :class="{
5
- 'u-border-bottom': elBorderBottom,
6
- 'u-form-item__border-bottom--error': validateState === 'error' && showError('border-bottom')
7
- }"
8
- >
9
- <view
10
- class="u-form-item__body"
11
- :style="{
12
- flexDirection: elLabelPosition == 'left' ? 'row' : 'column'
13
- }"
14
- >
15
- <!-- 微信小程序中,将一个参数设置空字符串,结果会变成字符串"true" -->
16
- <view
17
- class="u-form-item--left"
18
- :style="{
19
- width: uLabelWidth,
20
- flex: `0 0 ${uLabelWidth}`,
21
- marginBottom: elLabelPosition == 'left' ? 0 : '10rpx'
22
- }"
23
- >
24
- <!-- 为了块对齐 -->
25
- <view class="u-form-item--left__content" v-if="required || leftIcon || label">
26
- <!-- nvue不支持伪元素before -->
27
- <text v-if="required" class="u-form-item--left__content--required">*</text>
28
- <view class="u-form-item--left__content__icon" v-if="leftIcon">
29
- <u-icon :name="leftIcon" :custom-style="leftIconStyle"></u-icon>
30
- </view>
31
- <view
32
- class="u-form-item--left__content__label"
33
- :style="[
34
- elLabelStyle,
35
- {
36
- 'justify-content': elLabelAlign == 'left' ? 'flex-start' : elLabelAlign == 'center' ? 'center' : 'flex-end'
37
- }
38
- ]"
39
- >
40
- {{ label }}
41
- </view>
42
- </view>
43
- </view>
44
- <view class="u-form-item--right u-flex">
45
- <view class="u-form-item--right__content">
46
- <view class="u-form-item--right__content__slot">
47
- <slot />
48
- </view>
49
- <view class="u-form-item--right__content__icon u-flex" v-if="$slots.right || rightIcon">
50
- <u-icon :custom-style="rightIconStyle" v-if="rightIcon" :name="rightIcon"></u-icon>
51
- <slot name="right" />
52
- </view>
53
- </view>
54
- </view>
55
- </view>
56
- <view
57
- class="u-form-item__message"
58
- v-if="validateState === 'error' && showError('message')"
59
- :style="{
60
- paddingLeft: elLabelPosition == 'left' ? $u.addUnit(elLabelWidth) : '0'
61
- }"
62
- >{{ validateMessage }}</view
63
- >
64
- </view>
65
- </template>
66
-
67
- <script setup lang="ts">
68
- import { ref, computed, inject, onMounted, onBeforeUnmount, watch, getCurrentInstance, nextTick } from 'vue';
69
- import { $u } from '../..';
70
- import { broadcast } from '../../libs/util/emitter';
71
- // @ts-ignore
72
- import schema from '../../libs/util/async-validator';
73
- import { FormItemProps } from './types';
74
- // 去除警告信息
75
- schema.warning = function () {};
76
-
77
- defineOptions({
78
- name: 'u-form-item'
79
- });
80
-
81
- /**
82
- * form-item 表单item
83
- * @description 此组件一般用于表单场景,可以配置Input输入框,Select弹出框,进行表单验证等。
84
- * @tutorial https://uviewpro.cn/zh/components/form.html
85
- * @property {String} label 左侧提示文字
86
- * @property {Object} prop 表单域model对象的属性名,在使用 validate、resetFields 方法的情况下,该属性是必填的
87
- * @property {Boolean} border-bottom 是否显示表单域的下划线边框
88
- * @property {String} label-position 表单域提示文字的位置,left-左侧,top-上方
89
- * @property {String Number} label-width 提示文字的宽度,单位rpx(默认90)
90
- * @property {Object} label-style label的样式,对象形式
91
- * @property {String} label-align label的对齐方式
92
- * @property {String} right-icon 右侧自定义字体图标(限uView内置图标)或图片地址
93
- * @property {String} left-icon 左侧自定义字体图标(限uView内置图标)或图片地址
94
- * @property {Object} left-icon-style 左侧图标的样式,对象形式
95
- * @property {Object} right-icon-style 右侧图标的样式,对象形式
96
- * @property {Boolean} required 是否显示左边的"*"号,这里仅起展示作用,如需校验必填,请通过rules配置必填规则(默认false)
97
- * @example <u-form-item label="姓名"><u-input v-model="form.name" /></u-form-item>
98
- */
99
-
100
- const props = defineProps(FormItemProps);
101
-
102
- // inject 父表单实例
103
- let parent = inject<any>('u-form', null);
104
- const instance = getCurrentInstance();
105
-
106
- // 组件状态
107
- const initialValue = ref(''); // 存储初始值,用于重置
108
- const validateState = ref(''); // 校验状态 success/error/validating
109
- const validateMessage = ref(''); // 校验失败的提示语
110
- const errorType = ref<string[]>(['message']); // 错误提示方式,默认 message
111
- const fieldValue = ref(''); // 当前表单项的值
112
- const parentData = ref({
113
- borderBottom: true, // 父表单下划线边框
114
- labelWidth: 90, // 父表单 label 宽度
115
- labelPosition: 'left', // 父表单 label 位置
116
- labelStyle: {}, // 父表单 label 样式
117
- labelAlign: 'left' // 父表单 label 对齐
118
- });
119
-
120
- // 监听校验状态和父表单 errorType 变化
121
- watch(validateState, () => {
122
- broadcastInputError();
123
- });
124
-
125
- // 监听u-form组件的errorType的变化
126
- watch(
127
- () => parent?.errorType,
128
- val => {
129
- if (val) errorType.value = val;
130
- broadcastInputError();
131
- },
132
- { immediate: true }
133
- );
134
-
135
- // 计算属性
136
- const uLabelWidth = computed(() => {
137
- // 如果用户设置label为空字符串(微信小程序空字符串最终会变成字符串的'true'),意味着要将label的位置宽度设置为auto
138
- return elLabelPosition.value == 'left' ? (props.label === 'true' || props.label === '' ? 'auto' : $u.addUnit(elLabelWidth.value)) : '100%';
139
- });
140
-
141
- // 显示错误提示
142
- // errorType: ['message', 'toast', 'border-bottom', 'none']
143
- const showError = computed(() => (type: string) => {
144
- // 如果errorType数组中含有none,或者toast提示类型
145
- if (errorType.value.indexOf('none') >= 0) return false;
146
- else if (errorType.value.indexOf(type) >= 0) return true;
147
- else return false;
148
- });
149
-
150
- // label的宽度
151
- const elLabelWidth = computed(() => {
152
- // label默认宽度为90,优先使用本组件的值,如果没有(如果设置为0,也算是配置了值,依然起效),则用u-form的值
153
- return props.labelWidth != 0 && props.labelWidth !== '' ? props.labelWidth : parentData.value.labelWidth ? parentData.value.labelWidth : 90;
154
- });
155
-
156
- // label的样式
157
- const elLabelStyle = computed(() => {
158
- return Object.keys(props.labelStyle).length ? props.labelStyle : parentData.value.labelStyle ? parentData.value.labelStyle : {};
159
- });
160
-
161
- // label的位置,左侧或者上方
162
- const elLabelPosition = computed(() => {
163
- return props.labelPosition ? props.labelPosition : parentData.value.labelPosition ? parentData.value.labelPosition : 'left';
164
- });
165
-
166
- // label的对齐方式
167
- const elLabelAlign = computed(() => {
168
- return props.labelAlign ? props.labelAlign : parentData.value.labelAlign ? parentData.value.labelAlign : 'left';
169
- });
170
-
171
- // label的下划线
172
- const elBorderBottom = computed(() => {
173
- // 子组件的borderBottom默认为空字符串,如果不等于空字符串,意味着子组件设置了值,优先使用子组件的值
174
- return props.borderBottom !== '' ? props.borderBottom : parentData.value.borderBottom ? parentData.value.borderBottom : true;
175
- });
176
-
177
- // 事件派发/广播工具
178
- function broadcastInputError() {
179
- // 子组件发出事件,第三个参数为true或者false,true代表有错误
180
- if (instance) {
181
- // 这里可用 emitter 工具库的 broadcast 方法
182
- // 子组件发出事件,第三个参数为true或者false,true代表有错误
183
- broadcast(instance, 'u-input', 'on-form-item-error', validateState.value === 'error' && showError.value('border'));
184
- }
185
- }
186
-
187
- /**
188
- * 添加表单校验事件监听
189
- */
190
- function setRules() {
191
- // 由于人性化考虑,必填"*"号通过props的required配置,不再通过rules的规则自动生成
192
- // 从父组件u-form拿到当前u-form-item需要验证 的规则
193
- // let rules = this.getRules();
194
- // if (rules.length) {
195
- // this.isRequired = rules.some(rule => {
196
- // // 如果有必填项,就返回,没有的话,就是undefined
197
- // return rule.required;
198
- // });
199
- // }
200
- // // blur事件,失效了
201
- // uni.$on('on-form-blur', onFieldBlur)
202
- // // change事件,失效了
203
- // uni.$on('on-form-change', onFieldChange)
204
- }
205
-
206
- /**
207
- * 获取当前u-form-item的校验规则
208
- */
209
- function getRules() {
210
- // 父组件的所有规则
211
- let rules = parent?.rules?.value || parent?.rules || {};
212
- rules = rules ? rules[props.prop] : [];
213
- // 保证返回的是一个数组形式
214
- return [].concat(rules || []);
215
- }
216
-
217
- // blur事件时进行表单校验
218
- function onFieldBlur() {
219
- validation('blur');
220
- }
221
-
222
- // change事件进行表单校验
223
- function onFieldChange() {
224
- validation('change');
225
- }
226
-
227
- function onFormBlur() {
228
- onFieldBlur();
229
- }
230
-
231
- function onFormChange() {
232
- onFieldChange();
233
- }
234
-
235
- /**
236
- * 过滤出符合要求的rule规则
237
- * @param triggerType 触发类型
238
- */
239
- function getFilteredRule(triggerType = '') {
240
- // 获取所有规则
241
- const rules = getRules();
242
- // 整体验证表单时,triggerType为空字符串,此时返回所有规则进行验证
243
- if (!triggerType) return rules;
244
- // 历遍判断规则是否有对应的事件,比如blur,change触发等的事件
245
- // 使用indexOf判断,是因为某些时候设置的验证规则的trigger属性可能为多个,比如['blur','change']
246
- // 某些场景可能的判断规则,可能不存在trigger属性,故先判断是否存在此属性
247
- return rules.filter((res: any) => res.trigger && res.trigger.indexOf(triggerType) !== -1);
248
- }
249
-
250
- /**
251
- * 校验数据
252
- * @param trigger 触发类型
253
- * @param callback 校验回调
254
- */
255
- function validation(trigger: string, callback: (msg: string) => void = () => {}) {
256
- // 检验之前,先获取需要校验的值
257
- fieldValue.value = parent?.model?.[props.prop];
258
- // blur和change是否有当前方式的校验规则
259
- let rules = getFilteredRule(trigger);
260
- // 判断是否有验证规则,如果没有规则,也调用回调方法,否则父组件u-form会因为
261
- // 对count变量的统计错误而无法进入上一层的回调
262
- if (!rules || rules.length === 0) {
263
- callback('');
264
- return;
265
- }
266
- // 设置当前的状态,标识为校验中
267
- validateState.value = 'validating';
268
- // 调用async-validator的方法
269
- let validator = new schema({ [props.prop]: rules });
270
- validator.validate({ [props.prop]: fieldValue.value }, { firstFields: true }, (errors: any, fields: any) => {
271
- // 记录状态和报错信息
272
- validateState.value = !errors ? 'success' : 'error';
273
- validateMessage.value = errors ? errors[0].message : '';
274
- // 调用回调方法
275
- callback(validateMessage.value);
276
- });
277
- }
278
-
279
- /**
280
- * 清空当前的u-form-item
281
- */
282
- function resetField() {
283
- if (parent?.model && props.prop) {
284
- parent.model[props.prop] = initialValue.value;
285
- }
286
- // 设置为`success`状态,只是为了清空错误标记
287
- validateState.value = 'success';
288
- }
289
-
290
- // 组件挂载时注册到父表单
291
- onMounted(() => {
292
- // 支付宝、头条小程序不支持provide/inject,所以使用这个方法获取整个父组件,在created定义,避免循环应用
293
- // 兼容 provide/inject 及 $u.$parent
294
- parent = $u.parentData('u-form', instance);
295
- if (parent) {
296
- // 继承父表单配置
297
- // 历遍parentData中的属性,将parent中的同名属性赋值给parentData
298
- Object.keys(parentData.value).forEach(key => {
299
- parentData.value[key] = parent.props[key];
300
- });
301
- // 如果没有传入prop,或者uForm为空(如果u-form-input单独使用,就不会有uForm注入),就不进行校验
302
- if (props.prop) {
303
- // 将本实例添加到父组件中
304
- parent.addField &&
305
- parent.addField({
306
- validation,
307
- resetField,
308
- prop: props.prop
309
- });
310
- errorType.value = parent.errorType || errorType.value;
311
- // 设置初始值
312
- fieldValue.value = parent.model?.[props.prop];
313
- // 设置初始值
314
- initialValue.value = fieldValue.value;
315
- // 添加表单校验,这里必须要写在$nextTick中,因为u-form的rules是通过ref手动传入的
316
- // 不在$nextTick中的话,可能会造成执行此处代码时,父组件还没通过ref把规则给u-form,导致规则为空
317
- nextTick(() => {
318
- setRules();
319
- });
320
- }
321
- }
322
- });
323
- // 组件销毁前,将实例从u-form的缓存中移除
324
- onBeforeUnmount(() => {
325
- // 如果当前没有prop的话表示当前不要进行删除(因为没有注入)
326
- if (parent && props.prop) {
327
- parent.removeField && parent.removeField({ prop: props.prop });
328
- }
329
- });
330
-
331
- defineExpose({ validation, resetField, onFormBlur, onFormChange });
332
- </script>
333
-
334
- <style lang="scss" scoped>
335
- @import '../../libs/css/style.components.scss';
336
-
337
- .u-form-item {
338
- @include vue-flex;
339
- // align-items: flex-start;
340
- padding: 20rpx 0;
341
- font-size: 28rpx;
342
- color: $u-main-color;
343
- box-sizing: border-box;
344
- line-height: $u-form-item-height;
345
- flex-direction: column;
346
-
347
- &__border-bottom--error:after {
348
- border-color: $u-type-error;
349
- }
350
-
351
- &__body {
352
- @include vue-flex;
353
- }
354
-
355
- &--left {
356
- @include vue-flex;
357
- align-items: center;
358
-
359
- &__content {
360
- position: relative;
361
- @include vue-flex;
362
- align-items: center;
363
- padding-right: 10rpx;
364
- flex: 1;
365
-
366
- &__icon {
367
- margin-right: 8rpx;
368
- }
369
-
370
- &--required {
371
- position: absolute;
372
- left: -16rpx;
373
- vertical-align: middle;
374
- color: $u-type-error;
375
- padding-top: 6rpx;
376
- }
377
-
378
- &__label {
379
- @include vue-flex;
380
- align-items: center;
381
- flex: 1;
382
- }
383
- }
384
- }
385
-
386
- &--right {
387
- flex: 1;
388
-
389
- &__content {
390
- @include vue-flex;
391
- align-items: center;
392
- flex: 1;
393
-
394
- &__slot {
395
- flex: 1;
396
- /* #ifndef MP */
397
- @include vue-flex;
398
- align-items: center;
399
- /* #endif */
400
- }
401
-
402
- &__icon {
403
- margin-left: 10rpx;
404
- color: $u-light-color;
405
- font-size: 30rpx;
406
- }
407
- }
408
- }
409
-
410
- &__message {
411
- font-size: 24rpx;
412
- line-height: 24rpx;
413
- color: $u-type-error;
414
- margin-top: 12rpx;
415
- }
416
- }
417
- </style>
1
+ <template>
2
+ <view
3
+ class="u-form-item"
4
+ :class="{
5
+ 'u-border-bottom': elBorderBottom,
6
+ 'u-form-item__border-bottom--error': validateState === 'error' && showError('border-bottom')
7
+ }"
8
+ >
9
+ <view
10
+ class="u-form-item__body"
11
+ :style="{
12
+ flexDirection: elLabelPosition == 'left' ? 'row' : 'column'
13
+ }"
14
+ >
15
+ <!-- 微信小程序中,将一个参数设置空字符串,结果会变成字符串"true" -->
16
+ <view
17
+ class="u-form-item--left"
18
+ :style="{
19
+ width: uLabelWidth,
20
+ flex: `0 0 ${uLabelWidth}`,
21
+ marginBottom: elLabelPosition == 'left' ? 0 : '10rpx'
22
+ }"
23
+ >
24
+ <!-- 为了块对齐 -->
25
+ <view class="u-form-item--left__content" v-if="required || leftIcon || label">
26
+ <!-- nvue不支持伪元素before -->
27
+ <text v-if="required" class="u-form-item--left__content--required">*</text>
28
+ <view class="u-form-item--left__content__icon" v-if="leftIcon">
29
+ <u-icon :name="leftIcon" :custom-style="leftIconStyle"></u-icon>
30
+ </view>
31
+ <view
32
+ class="u-form-item--left__content__label"
33
+ :style="[
34
+ elLabelStyle,
35
+ {
36
+ 'justify-content': elLabelAlign == 'left' ? 'flex-start' : elLabelAlign == 'center' ? 'center' : 'flex-end'
37
+ }
38
+ ]"
39
+ >
40
+ {{ label }}
41
+ </view>
42
+ </view>
43
+ </view>
44
+ <view class="u-form-item--right u-flex">
45
+ <view class="u-form-item--right__content">
46
+ <view class="u-form-item--right__content__slot">
47
+ <slot />
48
+ </view>
49
+ <view class="u-form-item--right__content__icon u-flex" v-if="$slots.right || rightIcon">
50
+ <u-icon :custom-style="rightIconStyle" v-if="rightIcon" :name="rightIcon"></u-icon>
51
+ <slot name="right" />
52
+ </view>
53
+ </view>
54
+ </view>
55
+ </view>
56
+ <view
57
+ class="u-form-item__message"
58
+ v-if="validateState === 'error' && showError('message')"
59
+ :style="{
60
+ paddingLeft: elLabelPosition == 'left' ? $u.addUnit(elLabelWidth) : '0'
61
+ }"
62
+ >{{ validateMessage }}</view
63
+ >
64
+ </view>
65
+ </template>
66
+
67
+ <script setup lang="ts">
68
+ import { ref, computed, inject, onMounted, onBeforeUnmount, watch, getCurrentInstance, nextTick } from 'vue';
69
+ import { $u } from '../..';
70
+ import { broadcast } from '../../libs/util/emitter';
71
+ // @ts-ignore
72
+ import schema from '../../libs/util/async-validator';
73
+ import { FormItemProps } from './types';
74
+ // 去除警告信息
75
+ schema.warning = function () {};
76
+
77
+ defineOptions({
78
+ name: 'u-form-item'
79
+ });
80
+
81
+ /**
82
+ * form-item 表单item
83
+ * @description 此组件一般用于表单场景,可以配置Input输入框,Select弹出框,进行表单验证等。
84
+ * @tutorial https://uviewpro.cn/zh/components/form.html
85
+ * @property {String} label 左侧提示文字
86
+ * @property {Object} prop 表单域model对象的属性名,在使用 validate、resetFields 方法的情况下,该属性是必填的
87
+ * @property {Boolean} border-bottom 是否显示表单域的下划线边框
88
+ * @property {String} label-position 表单域提示文字的位置,left-左侧,top-上方
89
+ * @property {String Number} label-width 提示文字的宽度,单位rpx(默认90)
90
+ * @property {Object} label-style label的样式,对象形式
91
+ * @property {String} label-align label的对齐方式
92
+ * @property {String} right-icon 右侧自定义字体图标(限uView内置图标)或图片地址
93
+ * @property {String} left-icon 左侧自定义字体图标(限uView内置图标)或图片地址
94
+ * @property {Object} left-icon-style 左侧图标的样式,对象形式
95
+ * @property {Object} right-icon-style 右侧图标的样式,对象形式
96
+ * @property {Boolean} required 是否显示左边的"*"号,这里仅起展示作用,如需校验必填,请通过rules配置必填规则(默认false)
97
+ * @example <u-form-item label="姓名"><u-input v-model="form.name" /></u-form-item>
98
+ */
99
+
100
+ const props = defineProps(FormItemProps);
101
+
102
+ // inject 父表单实例
103
+ let parent = inject<any>('u-form', null);
104
+ const instance = getCurrentInstance();
105
+
106
+ // 组件状态
107
+ const initialValue = ref(''); // 存储初始值,用于重置
108
+ const validateState = ref(''); // 校验状态 success/error/validating
109
+ const validateMessage = ref(''); // 校验失败的提示语
110
+ const errorType = ref<string[]>(['message']); // 错误提示方式,默认 message
111
+ const fieldValue = ref(''); // 当前表单项的值
112
+ const parentData = ref({
113
+ borderBottom: true, // 父表单下划线边框
114
+ labelWidth: 90, // 父表单 label 宽度
115
+ labelPosition: 'left', // 父表单 label 位置
116
+ labelStyle: {}, // 父表单 label 样式
117
+ labelAlign: 'left' // 父表单 label 对齐
118
+ });
119
+
120
+ // 监听校验状态和父表单 errorType 变化
121
+ watch(validateState, () => {
122
+ broadcastInputError();
123
+ });
124
+
125
+ // 监听u-form组件的errorType的变化
126
+ watch(
127
+ () => parent?.errorType,
128
+ val => {
129
+ if (val) errorType.value = val;
130
+ broadcastInputError();
131
+ },
132
+ { immediate: true }
133
+ );
134
+
135
+ // 计算属性
136
+ const uLabelWidth = computed(() => {
137
+ // 如果用户设置label为空字符串(微信小程序空字符串最终会变成字符串的'true'),意味着要将label的位置宽度设置为auto
138
+ return elLabelPosition.value == 'left' ? (props.label === 'true' || props.label === '' ? 'auto' : $u.addUnit(elLabelWidth.value)) : '100%';
139
+ });
140
+
141
+ // 显示错误提示
142
+ // errorType: ['message', 'toast', 'border-bottom', 'none']
143
+ const showError = computed(() => (type: string) => {
144
+ // 如果errorType数组中含有none,或者toast提示类型
145
+ if (errorType.value.indexOf('none') >= 0) return false;
146
+ else if (errorType.value.indexOf(type) >= 0) return true;
147
+ else return false;
148
+ });
149
+
150
+ // label的宽度
151
+ const elLabelWidth = computed(() => {
152
+ // label默认宽度为90,优先使用本组件的值,如果没有(如果设置为0,也算是配置了值,依然起效),则用u-form的值
153
+ return props.labelWidth != 0 && props.labelWidth !== '' ? props.labelWidth : parentData.value.labelWidth ? parentData.value.labelWidth : 90;
154
+ });
155
+
156
+ // label的样式
157
+ const elLabelStyle = computed(() => {
158
+ return Object.keys(props.labelStyle).length ? props.labelStyle : parentData.value.labelStyle ? parentData.value.labelStyle : {};
159
+ });
160
+
161
+ // label的位置,左侧或者上方
162
+ const elLabelPosition = computed(() => {
163
+ return props.labelPosition ? props.labelPosition : parentData.value.labelPosition ? parentData.value.labelPosition : 'left';
164
+ });
165
+
166
+ // label的对齐方式
167
+ const elLabelAlign = computed(() => {
168
+ return props.labelAlign ? props.labelAlign : parentData.value.labelAlign ? parentData.value.labelAlign : 'left';
169
+ });
170
+
171
+ // label的下划线
172
+ const elBorderBottom = computed(() => {
173
+ // 子组件的borderBottom默认为空字符串,如果不等于空字符串,意味着子组件设置了值,优先使用子组件的值
174
+ return props.borderBottom !== '' ? props.borderBottom : parentData.value.borderBottom ? parentData.value.borderBottom : true;
175
+ });
176
+
177
+ // 事件派发/广播工具
178
+ function broadcastInputError() {
179
+ // 子组件发出事件,第三个参数为true或者false,true代表有错误
180
+ if (instance) {
181
+ // 这里可用 emitter 工具库的 broadcast 方法
182
+ // 子组件发出事件,第三个参数为true或者false,true代表有错误
183
+ broadcast(instance, 'u-input', 'on-form-item-error', validateState.value === 'error' && showError.value('border'));
184
+ }
185
+ }
186
+
187
+ /**
188
+ * 添加表单校验事件监听
189
+ */
190
+ function setRules() {
191
+ // 由于人性化考虑,必填"*"号通过props的required配置,不再通过rules的规则自动生成
192
+ // 从父组件u-form拿到当前u-form-item需要验证 的规则
193
+ // let rules = this.getRules();
194
+ // if (rules.length) {
195
+ // this.isRequired = rules.some(rule => {
196
+ // // 如果有必填项,就返回,没有的话,就是undefined
197
+ // return rule.required;
198
+ // });
199
+ // }
200
+ // // blur事件,失效了
201
+ // uni.$on('on-form-blur', onFieldBlur)
202
+ // // change事件,失效了
203
+ // uni.$on('on-form-change', onFieldChange)
204
+ }
205
+
206
+ /**
207
+ * 获取当前u-form-item的校验规则
208
+ */
209
+ function getRules() {
210
+ // 父组件的所有规则
211
+ let rules = parent?.rules?.value || parent?.rules || {};
212
+ rules = rules ? rules[props.prop] : [];
213
+ // 保证返回的是一个数组形式
214
+ return [].concat(rules || []);
215
+ }
216
+
217
+ // blur事件时进行表单校验
218
+ function onFieldBlur() {
219
+ validation('blur');
220
+ }
221
+
222
+ // change事件进行表单校验
223
+ function onFieldChange() {
224
+ validation('change');
225
+ }
226
+
227
+ function onFormBlur() {
228
+ onFieldBlur();
229
+ }
230
+
231
+ function onFormChange() {
232
+ onFieldChange();
233
+ }
234
+
235
+ /**
236
+ * 过滤出符合要求的rule规则
237
+ * @param triggerType 触发类型
238
+ */
239
+ function getFilteredRule(triggerType = '') {
240
+ // 获取所有规则
241
+ const rules = getRules();
242
+ // 整体验证表单时,triggerType为空字符串,此时返回所有规则进行验证
243
+ if (!triggerType) return rules;
244
+ // 历遍判断规则是否有对应的事件,比如blur,change触发等的事件
245
+ // 使用indexOf判断,是因为某些时候设置的验证规则的trigger属性可能为多个,比如['blur','change']
246
+ // 某些场景可能的判断规则,可能不存在trigger属性,故先判断是否存在此属性
247
+ return rules.filter((res: any) => res.trigger && res.trigger.indexOf(triggerType) !== -1);
248
+ }
249
+
250
+ /**
251
+ * 校验数据
252
+ * @param trigger 触发类型
253
+ * @param callback 校验回调
254
+ */
255
+ function validation(trigger: string, callback: (msg: string) => void = () => {}) {
256
+ // 检验之前,先获取需要校验的值
257
+ fieldValue.value = parent?.model?.[props.prop];
258
+ // blur和change是否有当前方式的校验规则
259
+ let rules = getFilteredRule(trigger);
260
+ // 判断是否有验证规则,如果没有规则,也调用回调方法,否则父组件u-form会因为
261
+ // 对count变量的统计错误而无法进入上一层的回调
262
+ if (!rules || rules.length === 0) {
263
+ callback('');
264
+ return;
265
+ }
266
+ // 设置当前的状态,标识为校验中
267
+ validateState.value = 'validating';
268
+ // 调用async-validator的方法
269
+ let validator = new schema({ [props.prop]: rules });
270
+ validator.validate({ [props.prop]: fieldValue.value }, { firstFields: true }, (errors: any, fields: any) => {
271
+ // 记录状态和报错信息
272
+ validateState.value = !errors ? 'success' : 'error';
273
+ validateMessage.value = errors ? errors[0].message : '';
274
+ // 调用回调方法
275
+ callback(validateMessage.value);
276
+ });
277
+ }
278
+
279
+ /**
280
+ * 清空当前的u-form-item
281
+ */
282
+ function resetField() {
283
+ if (parent?.model && props.prop) {
284
+ parent.model[props.prop] = initialValue.value;
285
+ }
286
+ // 设置为`success`状态,只是为了清空错误标记
287
+ validateState.value = 'success';
288
+ }
289
+
290
+ // 组件挂载时注册到父表单
291
+ onMounted(() => {
292
+ // 支付宝、头条小程序不支持provide/inject,所以使用这个方法获取整个父组件,在created定义,避免循环应用
293
+ // 兼容 provide/inject 及 $u.$parent
294
+ parent = $u.parentData('u-form', instance);
295
+ if (parent) {
296
+ // 继承父表单配置
297
+ // 历遍parentData中的属性,将parent中的同名属性赋值给parentData
298
+ Object.keys(parentData.value).forEach(key => {
299
+ parentData.value[key] = parent.props[key];
300
+ });
301
+ // 如果没有传入prop,或者uForm为空(如果u-form-input单独使用,就不会有uForm注入),就不进行校验
302
+ if (props.prop) {
303
+ // 将本实例添加到父组件中
304
+ parent.addField &&
305
+ parent.addField({
306
+ validation,
307
+ resetField,
308
+ prop: props.prop
309
+ });
310
+ errorType.value = parent.errorType || errorType.value;
311
+ // 设置初始值
312
+ fieldValue.value = parent.model?.[props.prop];
313
+ // 设置初始值
314
+ initialValue.value = fieldValue.value;
315
+ // 添加表单校验,这里必须要写在$nextTick中,因为u-form的rules是通过ref手动传入的
316
+ // 不在$nextTick中的话,可能会造成执行此处代码时,父组件还没通过ref把规则给u-form,导致规则为空
317
+ nextTick(() => {
318
+ setRules();
319
+ });
320
+ }
321
+ }
322
+ });
323
+ // 组件销毁前,将实例从u-form的缓存中移除
324
+ onBeforeUnmount(() => {
325
+ // 如果当前没有prop的话表示当前不要进行删除(因为没有注入)
326
+ if (parent && props.prop) {
327
+ parent.removeField && parent.removeField({ prop: props.prop });
328
+ }
329
+ });
330
+
331
+ defineExpose({ validation, resetField, onFormBlur, onFormChange });
332
+ </script>
333
+
334
+ <style lang="scss" scoped>
335
+ @import '../../libs/css/style.components.scss';
336
+
337
+ .u-form-item {
338
+ @include vue-flex;
339
+ // align-items: flex-start;
340
+ padding: 20rpx 0;
341
+ font-size: 28rpx;
342
+ color: $u-main-color;
343
+ box-sizing: border-box;
344
+ line-height: $u-form-item-height;
345
+ flex-direction: column;
346
+
347
+ &__border-bottom--error:after {
348
+ border-color: $u-type-error;
349
+ }
350
+
351
+ &__body {
352
+ @include vue-flex;
353
+ }
354
+
355
+ &--left {
356
+ @include vue-flex;
357
+ align-items: center;
358
+
359
+ &__content {
360
+ position: relative;
361
+ @include vue-flex;
362
+ align-items: center;
363
+ padding-right: 10rpx;
364
+ flex: 1;
365
+
366
+ &__icon {
367
+ margin-right: 8rpx;
368
+ }
369
+
370
+ &--required {
371
+ position: absolute;
372
+ left: -16rpx;
373
+ vertical-align: middle;
374
+ color: $u-type-error;
375
+ padding-top: 6rpx;
376
+ }
377
+
378
+ &__label {
379
+ @include vue-flex;
380
+ align-items: center;
381
+ flex: 1;
382
+ }
383
+ }
384
+ }
385
+
386
+ &--right {
387
+ flex: 1;
388
+
389
+ &__content {
390
+ @include vue-flex;
391
+ align-items: center;
392
+ flex: 1;
393
+
394
+ &__slot {
395
+ flex: 1;
396
+ /* #ifndef MP */
397
+ @include vue-flex;
398
+ align-items: center;
399
+ /* #endif */
400
+ }
401
+
402
+ &__icon {
403
+ margin-left: 10rpx;
404
+ color: $u-light-color;
405
+ font-size: 30rpx;
406
+ }
407
+ }
408
+ }
409
+
410
+ &__message {
411
+ font-size: 24rpx;
412
+ line-height: 24rpx;
413
+ color: $u-type-error;
414
+ margin-top: 12rpx;
415
+ }
416
+ }
417
+ </style>