@gmcb/uv-ui 0.2.26

package/components/uv-image/uv-image.vue

@@ -0,0 +1,296 @@
+<template>
+	<view :style="viewStyle">
+    <uv-transition
+    	:show="show"
+    	mode="fade"
+    	:duration="fade ? duration : 0"
+    	:cell-child="cellChild"
+			:custom-style="wrapStyle"
+    >
+    	<view
+    		class="uv-image"
+    		:class="[`uv-image--${elIndex}`]"
+    		@tap="onClick"
+    		:style="[wrapStyle, backgroundStyle]"
+    	>
+    		<image
+    			v-if="!isError && observeShow"
+    			:src="imageUrl"
+    			:mode="mode"
+    			@error="onErrorHandler"
+    			@load="onLoadHandler"
+    			:show-menu-by-longpress="showMenuByLongpress"
+    			:lazy-load="lazyLoad"
+    			class="uv-image__image"
+    			:style="[imageStyle]"
+    			:webp="webp"
+    		></image>
+    		<view
+    			v-if="showLoading && loading"
+    			class="uv-image__loading"
+    			:style="{
+    				borderRadius: shape == 'circle' ? '50%' : $uv.addUnit(radius),
+    				backgroundColor: bgColor,
+    				width: $uv.addUnit(width),
+    				height: $uv.addUnit(height)
+    			}"
+    		>
+    			<slot name="loading">
+    				<uv-icon
+    					:name="loadingIcon"
+    					:width="width"
+    					:height="height"
+    				></uv-icon>
+    			</slot>
+    		</view>
+    		<view
+    			v-if="showError && isError && !loading"
+    			class="uv-image__error"
+    			:style="{
+    				borderRadius: shape == 'circle' ? '50%' : $uv.addUnit(radius),
+    				width: $uv.addUnit(width),
+    				height: $uv.addUnit(height)
+    			}"
+    		>
+    			<slot name="error">
+    				<uv-icon
+    					:name="errorIcon"
+    					:width="width"
+    					:height="height"
+    				></uv-icon>
+    			</slot>
+    		</view>
+    	</view>
+    </uv-transition>
+  </view>
+</template>
+
+<script>
+	import mpMixin from '../../libs/mixin/mpMixin.js'
+	import mixin from '../../libs/mixin/mixin.js'
+	import props from './props.js';
+	/**
+	 * Image 图片
+	 * @description 此组件为uni-app的image组件的加强版，在继承了原有功能外，还支持淡入动画、加载中、加载失败提示、圆角值和形状等。
+	 * @tutorial https://www.uvui.cn/components/image.html
+	 * @property {String}			src 				图片地址
+	 * @property {String}			mode 				裁剪模式，见官网说明 （默认 'aspectFill' ）
+	 * @property {String | Number}	width 				宽度，单位任意，如果为数值，则为px单位 （默认 '300' ）
+	 * @property {String | Number}	height 				高度，单位任意，如果为数值，则为px单位 （默认 '225' ）
+	 * @property {String}			shape 				图片形状，circle-圆形，square-方形 （默认 'square' ）
+	 * @property {String | Number}	radius		 		圆角值，单位任意，如果为数值，则为px单位 （默认 0 ）
+	 * @property {Boolean}			lazyLoad			是否懒加载，仅微信小程序、App、百度小程序、字节跳动小程序有效 （默认 true ）
+	 * @property {Boolean}			showMenuByLongpress	是否开启长按图片显示识别小程序码菜单，仅微信小程序有效 （默认 true ）
+	 * @property {String}			loadingIcon 		加载中的图标，或者小图片 （默认 'photo' ）
+	 * @property {String}			errorIcon 			加载失败的图标，或者小图片 （默认 'error-circle' ）
+	 * @property {Boolean}			showLoading 		是否显示加载中的图标或者自定义的slot （默认 true ）
+	 * @property {Boolean}			showError 			是否显示加载错误的图标或者自定义的slot （默认 true ）
+	 * @property {Boolean}			fade 				是否需要淡入效果 （默认 true ）
+	 * @property {Boolean}			webp 				只支持网络资源，只对微信小程序有效 （默认 false ）
+	 * @property {String | Number}	duration 			搭配fade参数的过渡时间，单位ms （默认 500 ）
+	 * @property {String}			bgColor 			背景颜色，用于深色页面加载图片时，为了和背景色融合  (默认 '#f3f4f6' )
+	 * @property {Object}			customStyle  		定义需要用到的外部样式
+	 * @property {Boolean}		compress  		是否压缩图片，默认true
+	 * @event {Function}	click	点击图片时触发
+	 * @event {Function}	error	图片加载失败时触发
+	 * @event {Function} load 图片加载成功时触发
+	 * @example <uv-image width="100%" height="300px" :src="src"></uv-image>
+	 */
+	export default {
+		name: 'uv-image',
+		emits: ['click','load','error'],
+		mixins: [mpMixin, mixin, props],
+		data() {
+			return {
+				// 图片是否加载错误，如果是，则显示错误占位图
+				isError: false,
+				// 初始化组件时，默认为加载中状态
+				loading: true,
+				// 图片加载完成时，去掉背景颜色，因为如果是png图片，就会显示灰色的背景
+				backgroundStyle: {},
+				// 用于fade模式的控制组件显示与否
+				show: false,
+				// 是否开启图片出现在可视范围进行加载（另一种懒加载）
+				observeShow: !this.observeLazyLoad,
+				elIndex: '',
+				// 因为props的值无法修改，故需要一个中间值
+				imgWidth: this.width,
+				// 因为props的值无法修改，故需要一个中间值
+				imgHeight: this.height,
+				thresholdValue: 50
+			};
+		},
+		watch: {
+			src: {
+				immediate: true,
+				handler(n) {
+					if (!n) {
+						// 如果传入null或者''，或者false，或者undefined，标记为错误状态
+						this.isError = true
+					} else {
+						this.isError = false;
+						this.loading = true;
+					}
+				}
+			},
+			width(newVal){
+				// 这样做的目的是避免在更新时候，某些平台动画会恢复关闭状态
+				this.show = false;
+				this.$uv.sleep(2).then(res=>{
+					this.show = true;
+				});
+				this.imgWidth = newVal;
+			},
+			height(newVal){
+				// 这样做的目的是避免在更新时候，某些平台动画会恢复关闭状态
+				this.show = false;
+				this.$uv.sleep(2).then(res=>{
+					this.show = true;
+				});
+				this.imgHeight = newVal;
+			}
+		},
+		computed: {
+			wrapStyle() {
+				const style = {};
+        // 通过调用addUnit()方法，如果有单位，如百分比，px单位等，直接返回，如果是纯粹的数值，则加上rpx单位
+        if(this.mode !== 'heightFix') {
+					style.width = this.$uv.addUnit(this.imgWidth);
+				}
+				if(this.mode !== 'widthFix') {
+					style.height = this.$uv.addUnit(this.imgHeight);
+				}
+				// 如果是显示圆形，设置一个很多的半径值即可
+				style.borderRadius = this.shape == 'circle' ? '10000px' : this.$uv.addUnit(this.radius)
+				// 如果设置圆角，必须要有hidden，否则可能圆角无效
+				style.overflow = 'hidden';
+				return this.$uv.deepMerge(style, this.$uv.addStyle(this.customStyle));
+			},
+      viewStyle({ wrapStyle }) {
+        const { width, height } = wrapStyle;
+        return {
+          width,
+          height,
+        };
+      },
+			imageStyle({ imgWidth, imgHeight }) {
+				return {
+					width: this.$uv.addUnit(imgWidth),
+					height: this.$uv.addUnit(imgHeight),
+				}
+			},
+			imageUrl({ src, imageStyle, compress }) {
+				return compress && uni.$uv.compress ? uni.$uv.compress.image(src, imageStyle) : src;
+			},
+		},
+		created() {
+			this.elIndex = this.$uv.guid();
+			this.observer = {}
+			this.observerName = 'lazyLoadContentObserver'
+		},
+		mounted() {
+			this.show = true;
+			this.$nextTick(()=>{
+				if(this.observeLazyLoad) this.observerFn();
+			})
+		},
+		methods: {
+			// 点击图片
+			onClick() {
+				this.$emit('click')
+			},
+			// 图片加载失败
+			onErrorHandler(err) {
+				this.loading = false
+				this.isError = true
+				this.$emit('error', err)
+			},
+			// 图片加载完成，标记loading结束
+			onLoadHandler(event) {
+				if(this.mode == 'widthFix') this.imgHeight = 'auto'
+				if(this.mode == 'heightFix') this.imgWidth = 'auto'
+				this.loading = false
+				this.isError = false
+				this.$emit('load', event)
+				this.removeBgColor()
+			},
+			// 移除图片的背景色
+			removeBgColor() {
+				// 淡入动画过渡完成后，将背景设置为透明色，否则png图片会看到灰色的背景
+				this.backgroundStyle = {
+					backgroundColor: 'transparent'
+				};
+			},
+			// 观察图片是否在可见视口
+			observerFn(){
+				// 在需要用到懒加载的页面，在触发底部的时候触发tOnLazyLoadReachBottom事件，保证所有图片进行加载
+				this.$nextTick(() => {
+					uni.$once('onLazyLoadReachBottom', () => {
+						if (!this.observeShow) this.observeShow = true
+					})
+				})
+				setTimeout(() => {
+					// #ifndef APP-NVUE
+					this.disconnectObserver(this.observerName)
+					const contentObserver = uni.createIntersectionObserver(this)
+					contentObserver.relativeToViewport({
+						bottom: this.thresholdValue
+					}).observe(`.uv-image--${this.elIndex}`, (res) => {
+						if (res.intersectionRatio > 0) {
+							// 懒加载状态改变
+							this.observeShow = true
+							// 如果图片已经加载，去掉监听，减少性能消耗
+							this.disconnectObserver(this.observerName)
+						}
+					})
+					this[this.observerName] = contentObserver
+					// #endif
+					// #ifdef APP-NVUE
+					this.observeShow = true;
+					// #endif
+				}, 50)
+			},
+			disconnectObserver(observerName) {
+				const observer = this[observerName]
+				observer && observer.disconnect()
+			}
+		}
+	};
+</script>
+
+<style lang="scss" scoped>
+	@import '../../libs/css/components.scss';
+	@import '../../libs/css/color.scss';
+	$uv-image-error-top:0px !default;
+	$uv-image-error-left:0px !default;
+	$uv-image-error-width:100% !default;
+	$uv-image-error-hight:100% !default;
+	$uv-image-error-background-color:$uv-bg-color !default;
+	$uv-image-error-color:$uv-tips-color !default;
+	$uv-image-error-font-size: 46rpx !default;
+
+	.uv-image {
+		position: relative;
+		transition: opacity 0.5s ease-in-out;
+
+		&__image {
+			width: 100%;
+			height: 100%;
+		}
+
+		&__loading,
+		&__error {
+			position: absolute;
+			top: $uv-image-error-top;
+			left: $uv-image-error-left;
+			width: $uv-image-error-width;
+			height: $uv-image-error-hight;
+			@include flex;
+			align-items: center;
+			justify-content: center;
+			background-color: $uv-image-error-background-color;
+			color: $uv-image-error-color;
+			font-size: $uv-image-error-font-size;
+		}
+	}
+</style>

package/components/uv-index-anchor/props.js

@@ -0,0 +1,30 @@
+export default {
+	props: {
+		// 列表锚点文本内容
+		text: {
+			type: [String, Number],
+			default: ''
+		},
+		// 列表锚点文字颜色
+		color: {
+			type: String,
+			default: '#606266'
+		},
+		// 列表锚点文字大小，单位默认px
+		size: {
+			type: [String, Number],
+			default: 14
+		},
+		// 列表锚点背景颜色
+		bgColor: {
+			type: String,
+			default: '#dedede'
+		},
+		// 列表锚点高度，单位默认px
+		height: {
+			type: [String, Number],
+			default: 32
+		},
+		...uni.$uv?.props?.indexAnchor
+	}
+}

package/components/uv-index-anchor/uv-index-anchor.vue

@@ -0,0 +1,98 @@
+<template>
+	<!-- #ifdef APP-NVUE -->
+	<header>
+	<!-- #endif -->
+	<view
+	  :class="['uv-index-anchor',{'uv-index-anchor-sticky': parentData.sticky}]"
+		:ref="`uv-index-anchor-${text}`"
+	  :style="{
+			height: $uv.addUnit(height),
+			backgroundColor: bgColor
+		}"
+	>
+		<text
+		  class="uv-index-anchor__text"
+		  :style="{
+				fontSize: $uv.addUnit(size),
+				color: color
+			}"
+		>{{ text }}</text>
+	</view>
+	<!-- #ifdef APP-NVUE -->
+	</header>
+	<!-- #endif -->
+</template>
+
+<script>
+	import mpMixin from '../../libs/mixin/mpMixin.js'
+	import mixin from '../../libs/mixin/mixin.js'
+	import props from './props.js';
+	// #ifdef APP-NVUE
+	const dom = uni.requireNativePlugin('dom')
+	// #endif
+	/**
+	 * IndexAnchor 列表锚点
+	 * @description 
+	 * @tutorial https://www.uvui.cn/components/indexList.html
+	 * @property {String | Number}	text	列表锚点文本内容
+	 * @property {String}			color	列表锚点文字颜色 ( 默认 '#606266' )
+	 * @property {String | Number}	size	列表锚点文字大小，单位默认px ( 默认 14 )
+	 * @property {String}			bgColor	列表锚点背景颜色 ( 默认 '#dedede' )
+	 * @property {String | Number}	height	列表锚点高度，单位默认px ( 默认 32 )
+	 * @example <uv-index-anchor :text="indexList[index]"></uv-index-anchor>
+	 */
+	export default {
+		name: 'uv-index-anchor',
+		mixins: [mpMixin, mixin, props],
+		data() {
+			return {
+				parentData: {
+					sticky: true
+				}
+			}
+		},
+		created() {
+			this.init()
+		},
+		methods: {
+			init() {
+				// 此处会活动父组件实例，并赋值给实例的parent属性
+				const indexList = this.$uv.$parent.call(this, 'uv-index-list')
+				if (!indexList) { 
+					return this.$uv.error('uv-index-anchor必须要搭配uv-index-list组件使用')
+				}
+				this.parentData.sticky = indexList.sticky;
+				// 将当前实例放入到uv-index-list中
+				indexList.anchors.push(this)
+				const indexListItem = this.$uv.$parent.call(this, 'uv-index-item')
+				// #ifndef APP-NVUE
+				// 只有在非nvue下，uv-index-anchor才是嵌套在uv-index-item中的
+				if (!indexListItem) {
+					return this.$uv.error('uv-index-anchor必须要搭配uv-index-item组件使用')
+				}
+				// 设置uv-index-item的id为anchor的text标识符，因为非nvue下滚动列表需要依赖scroll-view滚动到元素的特性
+				indexListItem.id = this.text.charCodeAt(0)
+				// #endif
+			}
+		},
+	}
+</script>
+
+<style lang="scss" scoped>
+	@import '../../libs/css/components.scss';
+
+	.uv-index-anchor {
+		@include flex;
+		align-items: center;
+		padding-left: 15px;
+		z-index: 1;
+		&-sticky {
+			position: sticky;
+			top: 0;
+		}
+		&__text {
+			@include flex;
+			align-items: center;
+		}
+	}
+</style>

package/components/uv-index-item/uv-index-item.vue

@@ -0,0 +1,87 @@
+<template>
+	<!-- #ifdef APP-NVUE -->
+	<cell ref="uv-index-item">
+		<!-- #endif -->
+		<view
+			class="uv-index-item"
+			:id="`uv-index-item-${id}`"
+			:class="[`uv-index-item-${id}`]"
+		>
+			<slot />
+		</view>
+		<!-- #ifdef APP-NVUE -->
+	</cell>
+	<!-- #endif -->
+</template>
+
+<script>
+	import mpMixin from '../../libs/mixin/mpMixin.js'
+	import mixin from '../../libs/mixin/mixin.js'
+	// #ifdef APP-NVUE
+	// 由于weex为阿里的KPI业绩考核的产物，所以不支持百分比单位，这里需要通过dom查询组件的宽度
+	const dom = uni.requireNativePlugin('dom')
+	// #endif
+	/**
+	 * IndexItem 
+	 * @description 
+	 * @tutorial https://www.uvui.cn/components/indexList.html
+	 * @property {String}
+	 * @event {Function}
+	 * @example
+	 */
+	export default {
+		name: 'uv-index-item',
+		mixins: [mpMixin, mixin],
+		data() {
+			return {
+				// 本组件到滚动条顶部的距离
+				top: 0,
+				height: 0,
+				id: ''
+			}
+		},
+		created() {
+			// 子组件uv-index-anchor的实例
+			this.anchor = {}
+		},
+		mounted() {
+			this.init()
+		},
+		methods: {
+			init() {
+				// 此处会活动父组件实例，并赋值给实例的parent属性
+				this.getParentData('uv-index-list')
+				if (!this.parent) {
+					return this.$uv.error('uv-index-item必须要搭配uv-index-list组件使用')
+				}
+				this.$uv.sleep().then(() =>{
+					this.getIndexItemRect().then(size => {
+						// 由于对象的引用特性，此处会同时生效到父组件的children数组的本实例的top属性中，供父组件判断读取
+						this.top = Math.ceil(size.top)
+						this.height = Math.ceil(size.height)
+					})
+				})
+			},
+			getIndexItemRect() {
+				return new Promise(resolve => {
+					// #ifndef APP-NVUE
+					this.$uvGetRect('.uv-index-item').then(size => {
+						resolve(size)
+					})
+					// #endif
+
+					// #ifdef APP-NVUE
+					const ref = this.$refs['uv-index-item']
+					dom.getComponentRect(ref, res => {
+						resolve(res.size)
+					})
+					// #endif
+				}) 
+			}
+		},
+	}
+</script>
+
+<style lang="scss" scoped>
+	@import '../../libs/css/components.scss';
+</style>

package/components/uv-index-list/props.js

@@ -0,0 +1,30 @@
+export default {
+	props: {
+		// 右边锚点非激活的颜色
+		inactiveColor: {
+			type: String,
+			default: '#606266'
+		},
+		// 右边锚点激活的颜色
+		activeColor: {
+			type: String,
+			default: '#5677fc'
+		},
+		// 索引字符列表，数组形式
+		indexList: {
+			type: Array,
+			default: () => []
+		},
+		// 是否开启锚点自动吸顶
+		sticky: {
+			type: Boolean,
+			default: true
+		},
+		// 自定义导航栏的高度
+		customNavHeight: {
+			type: [String, Number],
+			default: 0
+		},
+		...uni.$uv?.props?.indexList
+	}
+}