uni-events-helper-wx/uview-ui/components/u-album/u-album.vue

<template>
	<view class="u-album">
		<view
		    class="u-album__row"
		    ref="u-album__row"
		    v-for="(arr, index) in showUrls"
			:forComputedUse="albumWidth"
			:key="index"
		>
			<view
			    class="u-album__row__wrapper"
			    v-for="(item, index1) in arr"
			    :key="index1"
			    :style="[imageStyle(index + 1, index1 + 1)]"
				@tap="onPreviewTap(getSrc(item))"
			>
				<image
				    :src="getSrc(item)"
				    :mode="urls.length === 1 ? (imageHeight > 0 ? singleMode : 'widthFix') : multipleMode"
				    :style="[{
						width: $u.addUnit(imageWidth),
						height: $u.addUnit(imageHeight)
					}]"
				></image>
				<view
				    v-if="showMore && urls.length > rowCount * showUrls.length && index === showUrls.length - 1 && index1 === showUrls[showUrls.length - 1].length - 1"
				    class="u-album__row__wrapper__text"
				>
					<u--text
					    :text="`+${urls.length - maxCount}`" 
					    color="#fff"
					    :size="multipleSize * 0.3"
						align="center"
						customStyle="justify-content: center"
					></u--text>
				</view>
			</view>
		</view>
	</view>
</template>

<script>
	import props from './props.js';
	// #ifdef APP-NVUE
	// 由于weex为阿里的KPI业绩考核的产物，所以不支持百分比单位，这里需要通过dom查询组件的宽度
	const dom = uni.requireNativePlugin('dom')
	// #endif
	
	/**
	 * Album 相册
	 * @description 本组件提供一个类似相册的功能，让开发者开发起来更加得心应手。减少重复的模板代码
	 * @tutorial https://www.uviewui.com/components/album.html
	 * 
	 * @property {Array}           urls             图片地址列表 Array<String>|Array<Object>形式
	 * @property {String}          keyName          指定从数组的对象元素中读取哪个属性作为图片地址 
	 * @property {String | Number} singleSize       单图时，图片长边的长度  （默认 180 ）
	 * @property {String | Number} multipleSize     多图时，图片边长 （默认 70 ）
	 * @property {String | Number} space            多图时，图片水平和垂直之间的间隔 （默认 6 ）
	 * @property {String}          singleMode       单图时，图片缩放裁剪的模式 （默认 'scaleToFill' ）
	 * @property {String}          multipleMode     多图时，图片缩放裁剪的模式 （默认 'aspectFill' ）
	 * @property {String | Number} maxCount         取消按钮的提示文字 （默认 9 ）
	 * @property {Boolean}         previewFullImage 是否可以预览图片 （默认 true ）
	 * @property {String | Number} rowCount         每行展示图片数量，如设置，singleSize和multipleSize将会无效	（默认 3 ）
	 * @property {Boolean}         showMore         超出maxCount时是否显示查看更多的提示 （默认 true ）
	 * 
	 * @event    {Function}        albumWidth       某些特殊的情况下，需要让文字与相册的宽度相等，这里事件的形式对外发送  （回调参数 width ）
	 * @example <u-album :urls="urls2" @albumWidth="width => albumWidth = width" multipleSize="68" ></u-album>
	 */
	export default {
		name: 'u-album',
		mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
		data() {
			return {
				// 单图的宽度
				singleWidth: 0,
				// 单图的高度
				singleHeight: 0,
				// 单图时，如果无法获取图片的尺寸信息，让图片宽度默认为容器的一定百分比
				singlePercent: 0.6,
			}
		},
		watch: {
			urls: {
				immediate: true,
				handler(newVal) {
					if (newVal.length === 1) {
						this.getImageRect()
					}
				}
			}
		},
		computed: {
			imageStyle() {
				return (index1, index2) => {
					const {
						space,
						rowCount,
						multipleSize,
						urls
					} = this, {
						addUnit,
						addStyle
					} = uni.$u,
						rowLen = this.showUrls.length,
						allLen = this.urls.length
					const style = {
						marginRight: addUnit(space),
						marginBottom: addUnit(space)
					}
					// 如果为最后一行，则每个图片都无需下边框
					if (index1 === rowLen) style.marginBottom = 0
					// 每行的最右边一张和总长度的最后一张无需右边框
					if (index2 === rowCount || index1 === rowLen && index2 === this.showUrls[index1 - 1].length) style.marginRight =
						0
					return style
				}
			},
			// 将数组划分为二维数组
			showUrls() {
				const arr = []
				this.urls.map((item, index) => {
					// 限制最大展示数量
					if(index + 1 <= this.maxCount) {
						// 计算该元素为第几个素组内
						const itemIndex = Math.floor(index / this.rowCount)
						// 判断对应的索引是否存在
						if (!arr[itemIndex]) { 
							arr[itemIndex] = []
						}
						arr[itemIndex].push(item)
					}
				})
				return arr
			},
			imageWidth() {
				return this.urls.length === 1 ? this.singleWidth : this.multipleSize
			},
			imageHeight() {
				return this.urls.length === 1 ? this.singleHeight : this.multipleSize
			},
			// 此变量无实际用途，仅仅是为了利用computed特性，让其在urls长度等变化时，重新计算图片的宽度
			// 因为用户在某些特殊的情况下，需要让文字与相册的宽度相等，所以这里事件的形式对外发送
			albumWidth() {
				let width = 0
				if(this.urls.length === 1) {
					width = this.singleWidth
				} else {
					width = this.showUrls[0].length * this.multipleSize + this.space * (this.showUrls[0].length - 1)
				}
				this.$emit('albumWidth', width)
				return width
			}
		},
		methods: {
			// 预览图片
			onPreviewTap(url) {
				const urls = this.urls.map(item => {
					return this.getSrc(item)
				})
				uni.previewImage({
					current: url,
					urls
				});
			},
			// 获取图片的路径
			getSrc(item) {
				return uni.$u.test.object(item) ? this.keyName && item[this.keyName] || item.src : item
			},
			// 单图时，获取图片的尺寸
			// 在小程序中，需要将网络图片的的域名添加到小程序的download域名才可能获取尺寸
			// 在没有添加的情况下，让单图宽度默认为盒子的一定宽度(singlePercent)
			getImageRect() {
				const src = this.getSrc(this.urls[0])
				uni.getImageInfo({
					src,
					success: (res) => {
						// 判断图片横向还是竖向展示方式
						const isHorizotal = res.width >= res.height
						this.singleWidth = isHorizotal ? this.singleSize : res.width / res.height * this.singleSize
						this.singleHeight = !isHorizotal ? this.singleSize : res.height / res.width * this.singleWidth
					},
					fail: () => {
						this.getComponentWidth()
					}
				})
			},
			// 获取组件的宽度
			async getComponentWidth() {
				// 延时一定时间，以获取dom尺寸
				await uni.$u.sleep(30)
				// #ifndef APP-NVUE
				this.$uGetRect('.u-album__row').then(size => {
					this.singleWidth = size.width * this.singlePercent
				})
				// #endif

				// #ifdef APP-NVUE
				// 这里ref="u-album__row"所在的标签为通过for循环出来，导致this.$refs['u-album__row']是一个数组
				const ref = this.$refs['u-album__row'][0]
				ref && dom.getComponentRect(ref, (res) => {
					this.singleWidth = res.size.width * this.singlePercent
				})
				// #endif
			},
		}
	}
</script>

<style lang="scss">
	@import "../../libs/css/components.scss";

	.u-album {
		@include flex(column);

		&__row {
			@include flex(row);
			flex-wrap: wrap;
			
			&__wrapper {
				position: relative;
				
				&__text {
					position: absolute;
					top: 0;
					left: 0;
					right: 0;
					bottom: 0;
					background-color: rgba(0, 0, 0, 0.3);
					@include flex(row);
					justify-content: center;
					align-items: center;
				}
			}
		}
	}
</style>