Blame view

node_modules/uview-ui/components/u-form-item/u-form-item.vue 13.6 KB
c7add6cf   “wangming”   初始版本开发完毕
1
  <template>
25852764   unknown   s
2
3
4
5
  	<view class="u-form-item" :class="{'u-border-bottom': elBorderBottom, 'u-form-item__border-bottom--error': validateState === 'error' && showError('border-bottom')}">
  		<view class="u-form-item__body" :style="{
  			flexDirection: elLabelPosition == 'left' ? 'row' : 'column'
  		}">
c7add6cf   “wangming”   初始版本开发完毕
6
  			<!-- 微信小程序中,将一个参数设置空字符串,结果会变成字符串"true" -->
25852764   unknown   s
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
  			<view class="u-form-item--left" :style="{
  				width: uLabelWidth,
  				flex: `0 0 ${uLabelWidth}`,
  				marginBottom: elLabelPosition == 'left' ? 0 : '10rpx',
  			}">
  				<!-- 为了块对齐 -->
  				<view class="u-form-item--left__content" v-if="required || leftIcon || label">
  					<!-- nvue不支持伪元素before -->
  					<text v-if="required" class="u-form-item--left__content--required">*</text>
  					<view class="u-form-item--left__content__icon" v-if="leftIcon">
  						<u-icon :name="leftIcon" :custom-style="leftIconStyle"></u-icon>
  					</view>
  					<view class="u-form-item--left__content__label" :style="[elLabelStyle, {
  						'justify-content': elLabelAlign == 'left' ? 'flex-start' : elLabelAlign == 'center' ? 'center' : 'flex-end'
  					}]">
  						{{label}}
c7add6cf   “wangming”   初始版本开发完毕
23
24
  					</view>
  				</view>
25852764   unknown   s
25
26
27
28
  			</view>
  			<view class="u-form-item--right u-flex">
  				<view class="u-form-item--right__content">
  					<view class="u-form-item--right__content__slot ">
c7add6cf   “wangming”   初始版本开发完毕
29
30
  						<slot />
  					</view>
25852764   unknown   s
31
32
  					<view class="u-form-item--right__content__icon u-flex" v-if="$slots.right || rightIcon">
  						<u-icon :custom-style="rightIconStyle" v-if="rightIcon" :name="rightIcon"></u-icon>
c7add6cf   “wangming”   初始版本开发完毕
33
34
35
36
37
  						<slot name="right" />
  					</view>
  				</view>
  			</view>
  		</view>
25852764   unknown   s
38
39
40
  		<view class="u-form-item__message" v-if="validateState === 'error' && showError('message')" :style="{
  			paddingLeft: elLabelPosition == 'left' ? $u.addUnit(elLabelWidth) : '0',
  		}">{{validateMessage}}</view>
c7add6cf   “wangming”   初始版本开发完毕
41
42
43
44
  	</view>
  </template>
  
  <script>
25852764   unknown   s
45
46
47
48
49
  	import Emitter from '../../libs/util/emitter.js';
  	import schema from '../../libs/util/async-validator';
  	// 去除警告信息
  	schema.warning = function() {};
  
c7add6cf   “wangming”   初始版本开发完毕
50
  	/**
25852764   unknown   s
51
  	 * form-item 表单item
c7add6cf   “wangming”   初始版本开发完毕
52
  	 * @description 此组件一般用于表单场景,可以配置Input输入框,Select弹出框,进行表单验证等。
25852764   unknown   s
53
54
55
56
57
58
59
60
61
62
63
64
65
66
  	 * @tutorial http://uviewui.com/components/form.html
  	 * @property {String} label 左侧提示文字
  	 * @property {Object} prop 表单域model对象的属性名,在使用 validateresetFields 方法的情况下,该属性是必填的
  	 * @property {Boolean} border-bottom 是否显示表单域的下划线边框
  	 * @property {String} label-position 表单域提示文字的位置,left-左侧,top-上方
  	 * @property {String Number} label-width 提示文字的宽度,单位rpx(默认90
  	 * @property {Object} label-style lable的样式,对象形式
  	 * @property {String} label-align lable的对齐方式
  	 * @property {String} right-icon 右侧自定义字体图标(uView内置图标)或图片地址
  	 * @property {String} left-icon 左侧自定义字体图标(uView内置图标)或图片地址
  	 * @property {Object} left-icon-style 左侧图标的样式,对象形式
  	 * @property {Object} right-icon-style 右侧图标的样式,对象形式
  	 * @property {Boolean} required 是否显示左边的"*"号,这里仅起展示作用,如需校验必填,请通过rules配置必填规则(默认false)
  	 * @example <u-form-item label="姓名"><u-input v-model="form.name" /></u-form-item>
c7add6cf   “wangming”   初始版本开发完毕
67
  	 */
25852764   unknown   s
68
  
c7add6cf   “wangming”   初始版本开发完毕
69
70
  	export default {
  		name: 'u-form-item',
25852764   unknown   s
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
  		mixins: [Emitter],
  		inject: {
  			uForm: {
  				default () {
  					return null
  				}
  			}
  		},
  		props: {
  			// input的label提示语
  			label: {
  				type: String,
  				default: ''
  			},
  			// 绑定的值
  			prop: {
  				type: String,
  				default: ''
  			},
  			// 是否显示表单域的下划线边框
  			borderBottom: {
  				type: [String, Boolean],
  				default: ''
  			},
  			// label的位置,left-左边,top-上边
  			labelPosition: {
  				type: String,
  				default: ''
  			},
  			// label的宽度,单位rpx
  			labelWidth: {
  				type: [String, Number],
  				default: ''
  			},
  			// lable的样式,对象形式
  			labelStyle: {
  				type: Object,
  				default () {
  					return {}
  				}
  			},
  			// lable字体的对齐方式
  			labelAlign: {
  				type: String,
  				default: ''
  			},
  			// 右侧图标
  			rightIcon: {
  				type: String,
  				default: ''
  			},
  			// 左侧图标
  			leftIcon: {
  				type: String,
  				default: ''
  			},
  			// 左侧图标的样式
  			leftIconStyle: {
  				type: Object,
  				default () {
  					return {}
  				}
  			},
  			// 左侧图标的样式
  			rightIconStyle: {
  				type: Object,
  				default () {
  					return {}
  				}
  			},
  			// 是否显示左边的必填星号,只作显示用,具体校验必填的逻辑,请在rules中配置
  			required: {
  				type: Boolean,
  				default: false
  			}
  		},
c7add6cf   “wangming”   初始版本开发完毕
147
148
  		data() {
  			return {
25852764   unknown   s
149
150
151
152
153
154
155
156
  				initialValue: '', // 存储的默认值
  				// isRequired: false, // 是否必填,由于人性化考虑,必填"*"号通过props的required配置,不再通过rules的规则自动生成
  				validateState: '', // 是否校验成功
  				validateMessage: '', // 校验失败的提示语
  				// 有错误时的提示方式,message-提示信息,border-如果input设置了边框,变成呈红色,
  				errorType: ['message'],
  				fieldValue: '', // 获取当前子组件input的输入的值
  				// 父组件的参数,在computed计算中,无法得知this.parent发生变化,故将父组件的参数值,放到data中
c7add6cf   “wangming”   初始版本开发完毕
157
  				parentData: {
25852764   unknown   s
158
159
  					borderBottom: true,
  					labelWidth: 90,
c7add6cf   “wangming”   初始版本开发完毕
160
  					labelPosition: 'left',
c7add6cf   “wangming”   初始版本开发完毕
161
  					labelStyle: {},
25852764   unknown   s
162
  					labelAlign: 'left',
c7add6cf   “wangming”   初始版本开发完毕
163
  				}
25852764   unknown   s
164
165
166
167
168
169
170
171
172
173
174
  			};
  		},
  		watch: {
  			validateState(val) {
  				this.broadcastInputError();
  			},
  			// 监听u-form组件的errorType的变化
  			"uForm.errorType"(val) {
  				this.errorType = val;
  				this.broadcastInputError();
  			},
c7add6cf   “wangming”   初始版本开发完毕
175
  		},
c7add6cf   “wangming”   初始版本开发完毕
176
  		computed: {
25852764   unknown   s
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
  			// 计算后的label宽度,由于需要多个判断,故放到computed中
  			uLabelWidth() {
  				// 如果用户设置label为空字符串(微信小程序空字符串最终会变成字符串的'true'),意味着要将label的位置宽度设置为auto
  				return this.elLabelPosition == 'left' ? (this.label === 'true' || this.label === '' ? 'auto' : this.$u.addUnit(this
  					.elLabelWidth)) : '100%';
  			},
  			showError() {
  				return type => {
  					// 如果errorType数组中含有none,或者toast提示类型
  					if (this.errorType.indexOf('none') >= 0) return false;
  					else if (this.errorType.indexOf(type) >= 0) return true;
  					else return false;
  				}
  			},
  			// label的宽度
  			elLabelWidth() {
  				// label默认宽度为90,优先使用本组件的值,如果没有(如果设置为0,也算是配置了值,依然起效),则用u-form的值
  				return (this.labelWidth != 0 || this.labelWidth != '') ? this.labelWidth : (this.parentData.labelWidth ? this.parentData
  					.labelWidth :
  					90);
  			},
  			// label的样式
  			elLabelStyle() {
  				return Object.keys(this.labelStyle).length ? this.labelStyle : (this.parentData.labelStyle ? this.parentData.labelStyle :
  					{});
  			},
  			// label的位置,左侧或者上方
  			elLabelPosition() {
  				return this.labelPosition ? this.labelPosition : (this.parentData.labelPosition ? this.parentData.labelPosition :
  					'left');
  			},
  			// label的对齐方式
  			elLabelAlign() {
  				return this.labelAlign ? this.labelAlign : (this.parentData.labelAlign ? this.parentData.labelAlign : 'left');
  			},
  			// label的下划线
  			elBorderBottom() {
  				// 子组件的borderBottom默认为空字符串,如果不等于空字符串,意味着子组件设置了值,优先使用子组件的值
  				return this.borderBottom !== '' ? this.borderBottom : this.parentData.borderBottom ? this.parentData.borderBottom :
  					true;
c7add6cf   “wangming”   初始版本开发完毕
217
218
  			}
  		},
c7add6cf   “wangming”   初始版本开发完毕
219
  		methods: {
25852764   unknown   s
220
221
222
  			broadcastInputError() {
  				// 子组件发出事件,第三个参数为true或者false,true代表有错误
  				this.broadcast('u-input', 'on-form-item-error', this.validateState === 'error' && this.showError('border'));
c7add6cf   “wangming”   初始版本开发完毕
223
  			},
25852764   unknown   s
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
  			// 判断是否需要required校验
  			setRules() {
  				let that = this;
  				// 由于人性化考虑,必填"*"号通过props的required配置,不再通过rules的规则自动生成
  				// 从父组件u-form拿到当前u-form-item需要验证 的规则
  				// let rules = this.getRules();
  				// if (rules.length) {
  				// 	this.isRequired = rules.some(rule => {
  				// 		// 如果有必填项,就返回,没有的话,就是undefined
  				// 		return rule.required;
  				// 	});
  				// }
  
  				// blur事件
  				this.$on('on-form-blur', that.onFieldBlur);
  				// change事件
  				this.$on('on-form-change', that.onFieldChange);
  			},
  
  			// 从u-form的rules属性中,取出当前u-form-item的校验规则
  			getRules() {
  				// 父组件的所有规则
  				let rules = this.parent.rules;
  				rules = rules ? rules[this.prop] : [];
  				// 保证返回的是一个数组形式
  				return [].concat(rules || []);
  			},
  
  			// blur事件时进行表单校验
  			onFieldBlur() {
  				this.validation('blur');
c7add6cf   “wangming”   初始版本开发完毕
255
  			},
25852764   unknown   s
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
  
  			// change事件进行表单校验
  			onFieldChange() {
  				this.validation('change');
  			},
  
  			// 过滤出符合要求的rule规则
  			getFilteredRule(triggerType = '') {
  				let rules = this.getRules();
  				// 整体验证表单时,triggerType为空字符串,此时返回所有规则进行验证
  				if (!triggerType) return rules;
  				// 历遍判断规则是否有对应的事件,比如blur,change触发等的事件
  				// 使用indexOf判断,是因为某些时候设置的验证规则的trigger属性可能为多个,比如['blur','change']
  				// 某些场景可能的判断规则,可能不存在trigger属性,故先判断是否存在此属性
  				return rules.filter(res => res.trigger && res.trigger.indexOf(triggerType) !== -1);
  			},
  
  			// 校验数据
  			validation(trigger, callback = () => {}) {
  				// 检验之间,先获取需要校验的值
  				this.fieldValue = this.parent.model[this.prop];
  				// blur和change是否有当前方式的校验规则
  				let rules = this.getFilteredRule(trigger);
  				// 判断是否有验证规则,如果没有规则,也调用回调方法,否则父组件u-form会因为
  				// 对count变量的统计错误而无法进入上一层的回调
  				if (!rules || rules.length === 0) {
  					return callback('');
  				}
  				// 设置当前的装填,标识为校验中
  				this.validateState = 'validating';
  				// 调用async-validator的方法
  				let validator = new schema({
  					[this.prop]: rules
  				});
  				validator.validate({
  					[this.prop]: this.fieldValue
  				}, {
  					firstFields: true
  				}, (errors, fields) => {
  					// 记录状态和报错信息
  					this.validateState = !errors ? 'success' : 'error';
  					this.validateMessage = errors ? errors[0].message : '';
  					// 调用回调方法
  					callback(this.validateMessage);
  				});
c7add6cf   “wangming”   初始版本开发完毕
301
  			},
25852764   unknown   s
302
303
  
  			// 清空当前的u-form-item
c7add6cf   “wangming”   初始版本开发完毕
304
  			resetField() {
25852764   unknown   s
305
306
307
  				this.parent.model[this.prop] = this.initialValue;
  				// 设置为`success`状态,只是为了清空错误标记
  				this.validateState = 'success';
c7add6cf   “wangming”   初始版本开发完毕
308
309
  			}
  		},
25852764   unknown   s
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
  
  		// 组件创建完成时,将当前实例保存到u-form中
  		mounted() {
  			// 支付宝、头条小程序不支持provide/inject,所以使用这个方法获取整个父组件,在created定义,避免循环应用
  			this.parent = this.$u.$parent.call(this, 'u-form');
  			if (this.parent) {
  				// 历遍parentData中的属性,将parent中的同名属性赋值给parentData
  				Object.keys(this.parentData).map(key => {
  					this.parentData[key] = this.parent[key];
  				});
  				// 如果没有传入prop,或者uForm为空(如果u-form-input单独使用,就不会有uForm注入),就不进行校验
  				if (this.prop) {
  					// 将本实例添加到父组件中
  					this.parent.fields.push(this);
  					this.errorType = this.parent.errorType;
  					// 设置初始值
  					this.initialValue = this.fieldValue;
  					// 添加表单校验,这里必须要写在$nextTick中,因为u-form的rules是通过ref手动传入的
  					// 不在$nextTick中的话,可能会造成执行此处代码时,父组件还没通过ref把规则给u-form,导致规则为空
  					this.$nextTick(() => {
  						this.setRules();
  					})
  				}
  			}
  		},
  
  		// 组件销毁前,将实例从u-form的缓存中移除
  		beforeDestroy() {
  			// 如果当前没有prop的话表示当前不要进行删除(因为没有注入)
  			if (this.parent && this.prop) {
  				this.parent.fields.map((item, index) => {
  					if (item === this) this.parent.fields.splice(index, 1);
  				})
  			}
  		},
  	};
c7add6cf   “wangming”   初始版本开发完毕
346
347
348
  </script>
  
  <style lang="scss" scoped>
25852764   unknown   s
349
  	@import "../../libs/css/style.components.scss";
c7add6cf   “wangming”   初始版本开发完毕
350
351
  
  	.u-form-item {
25852764   unknown   s
352
353
354
355
  		@include vue-flex;
  		// align-items: flex-start;
  		padding: 20rpx 0;
  		font-size: 28rpx;
c7add6cf   “wangming”   初始版本开发完毕
356
  		color: $u-main-color;
25852764   unknown   s
357
358
359
360
361
362
363
  		box-sizing: border-box;
  		line-height: $u-form-item-height;
  		flex-direction: column;
  
  		&__border-bottom--error:after {
  			border-color: $u-type-error;
  		}
c7add6cf   “wangming”   初始版本开发完毕
364
365
  
  		&__body {
25852764   unknown   s
366
367
  			@include vue-flex;
  		}
c7add6cf   “wangming”   初始版本开发完毕
368
  
25852764   unknown   s
369
370
371
372
373
374
375
  		&--left {
  			@include vue-flex;
  			align-items: center;
  
  			&__content {
  				position: relative;
  				@include vue-flex;
c7add6cf   “wangming”   初始版本开发完毕
376
  				align-items: center;
25852764   unknown   s
377
378
379
380
381
382
383
384
385
386
387
388
389
390
  				padding-right: 10rpx;
  				flex: 1;
  
  				&__icon {
  					margin-right: 8rpx;
  				}
  
  				&--required {
  					position: absolute;
  					left: -16rpx;
  					vertical-align: middle;
  					color: $u-type-error;
  					padding-top: 6rpx;
  				}
c7add6cf   “wangming”   初始版本开发完毕
391
  
25852764   unknown   s
392
393
  				&__label {
  					@include vue-flex;
c7add6cf   “wangming”   初始版本开发完毕
394
  					align-items: center;
c7add6cf   “wangming”   初始版本开发完毕
395
  					flex: 1;
c7add6cf   “wangming”   初始版本开发完毕
396
397
  				}
  			}
25852764   unknown   s
398
  		}
c7add6cf   “wangming”   初始版本开发完毕
399
  
25852764   unknown   s
400
401
402
403
404
405
  		&--right {
  			flex: 1;
  
  			&__content {
  				@include vue-flex;
  				align-items: center;
c7add6cf   “wangming”   初始版本开发完毕
406
407
  				flex: 1;
  
25852764   unknown   s
408
  				&__slot {
c7add6cf   “wangming”   初始版本开发完毕
409
  					flex: 1;
25852764   unknown   s
410
411
412
413
  					/* #ifndef MP */
  					@include vue-flex;
  					align-items: center;
  					/* #endif */
c7add6cf   “wangming”   初始版本开发完毕
414
415
  				}
  
25852764   unknown   s
416
417
418
419
  				&__icon {
  					margin-left: 10rpx;
  					color: $u-light-color;
  					font-size: 30rpx;
c7add6cf   “wangming”   初始版本开发完毕
420
421
422
  				}
  			}
  		}
25852764   unknown   s
423
424
425
426
427
428
429
  
  		&__message {
  			font-size: 24rpx;
  			line-height: 24rpx;
  			color: $u-type-error;
  			margin-top: 12rpx;
  		}
c7add6cf   “wangming”   初始版本开发完毕
430
431
  	}
  </style>