u-album.vue 9.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262
  1. <template>
  2. <view class="u-album">
  3. <view
  4. class="u-album__row"
  5. ref="u-album__row"
  6. v-for="(arr, index) in showUrls"
  7. :forComputedUse="albumWidth"
  8. :key="index"
  9. >
  10. <view
  11. class="u-album__row__wrapper"
  12. v-for="(item, index1) in arr"
  13. :key="index1"
  14. :style="[imageStyle(index + 1, index1 + 1)]"
  15. @tap="previewFullImage ? onPreviewTap(getSrc(item)) : ''"
  16. >
  17. <image
  18. :src="getSrc(item)"
  19. :mode="
  20. urls.length === 1
  21. ? imageHeight > 0
  22. ? singleMode
  23. : 'widthFix'
  24. : multipleMode
  25. "
  26. :style="[
  27. {
  28. width: imageWidth,
  29. height: imageHeight
  30. }
  31. ]"
  32. ></image>
  33. <view
  34. v-if="
  35. showMore &&
  36. urls.length > rowCount * showUrls.length &&
  37. index === showUrls.length - 1 &&
  38. index1 === showUrls[showUrls.length - 1].length - 1
  39. "
  40. class="u-album__row__wrapper__text"
  41. >
  42. <u--text
  43. :text="`+${urls.length - maxCount}`"
  44. color="#fff"
  45. :size="multipleSize * 0.3"
  46. align="center"
  47. customStyle="justify-content: center"
  48. ></u--text>
  49. </view>
  50. </view>
  51. </view>
  52. </view>
  53. </template>
  54. <script>
  55. import props from './props.js';
  56. import mpMixin from '../../libs/mixin/mpMixin.js';
  57. import mixin from '../../libs/mixin/mixin.js';
  58. // #ifdef APP-NVUE
  59. // 由于weex为阿里的KPI业绩考核的产物,所以不支持百分比单位,这里需要通过dom查询组件的宽度
  60. const dom = uni.requireNativePlugin('dom')
  61. // #endif
  62. /**
  63. * Album 相册
  64. * @description 本组件提供一个类似相册的功能,让开发者开发起来更加得心应手。减少重复的模板代码
  65. * @tutorial https://ijry.github.io/uview-plus/components/album.html
  66. *
  67. * @property {Array} urls 图片地址列表 Array<String>|Array<Object>形式
  68. * @property {String} keyName 指定从数组的对象元素中读取哪个属性作为图片地址
  69. * @property {String | Number} singleSize 单图时,图片长边的长度 (默认 180 )
  70. * @property {String | Number} multipleSize 多图时,图片边长 (默认 70 )
  71. * @property {String | Number} space 多图时,图片水平和垂直之间的间隔 (默认 6 )
  72. * @property {String} singleMode 单图时,图片缩放裁剪的模式 (默认 'scaleToFill' )
  73. * @property {String} multipleMode 多图时,图片缩放裁剪的模式 (默认 'aspectFill' )
  74. * @property {String | Number} maxCount 取消按钮的提示文字 (默认 9 )
  75. * @property {Boolean} previewFullImage 是否可以预览图片 (默认 true )
  76. * @property {String | Number} rowCount 每行展示图片数量,如设置,singleSize和multipleSize将会无效 (默认 3 )
  77. * @property {Boolean} showMore 超出maxCount时是否显示查看更多的提示 (默认 true )
  78. *
  79. * @event {Function} albumWidth 某些特殊的情况下,需要让文字与相册的宽度相等,这里事件的形式对外发送 (回调参数 width )
  80. * @example <u-album :urls="urls2" @albumWidth="width => albumWidth = width" multipleSize="68" ></u-album>
  81. */
  82. export default {
  83. name: 'u-album',
  84. mixins: [mpMixin, mixin, props],
  85. data() {
  86. return {
  87. // 单图的宽度
  88. singleWidth: 0,
  89. // 单图的高度
  90. singleHeight: 0,
  91. // 单图时,如果无法获取图片的尺寸信息,让图片宽度默认为容器的一定百分比
  92. singlePercent: 0.6
  93. }
  94. },
  95. watch: {
  96. urls: {
  97. immediate: true,
  98. handler(newVal) {
  99. if (newVal.length === 1) {
  100. this.getImageRect()
  101. }
  102. }
  103. }
  104. },
  105. emits: ["albumWidth"],
  106. computed: {
  107. imageStyle() {
  108. return (index1, index2) => {
  109. const { space, rowCount, multipleSize, urls } = this,
  110. { addUnit, addStyle } = uni.$u,
  111. rowLen = this.showUrls.length,
  112. allLen = this.urls.length
  113. const style = {
  114. marginRight: addUnit(space),
  115. marginBottom: addUnit(space)
  116. }
  117. // 如果为最后一行,则每个图片都无需下边框
  118. if (index1 === rowLen) style.marginBottom = 0
  119. // 每行的最右边一张和总长度的最后一张无需右边框
  120. if (
  121. index2 === rowCount ||
  122. (index1 === rowLen &&
  123. index2 === this.showUrls[index1 - 1].length)
  124. )
  125. style.marginRight = 0
  126. return style
  127. }
  128. },
  129. // 将数组划分为二维数组
  130. showUrls() {
  131. const arr = []
  132. this.urls.map((item, index) => {
  133. // 限制最大展示数量
  134. if (index + 1 <= this.maxCount) {
  135. // 计算该元素为第几个素组内
  136. const itemIndex = Math.floor(index / this.rowCount)
  137. // 判断对应的索引是否存在
  138. if (!arr[itemIndex]) {
  139. arr[itemIndex] = []
  140. }
  141. arr[itemIndex].push(item)
  142. }
  143. })
  144. return arr
  145. },
  146. imageWidth() {
  147. return uni.$u.addUnit(
  148. this.urls.length === 1 ? this.singleWidth : this.multipleSize
  149. )
  150. },
  151. imageHeight() {
  152. return uni.$u.addUnit(
  153. this.urls.length === 1 ? this.singleHeight : this.multipleSize
  154. )
  155. },
  156. // 此变量无实际用途,仅仅是为了利用computed特性,让其在urls长度等变化时,重新计算图片的宽度
  157. // 因为用户在某些特殊的情况下,需要让文字与相册的宽度相等,所以这里事件的形式对外发送
  158. albumWidth() {
  159. let width = 0
  160. if (this.urls.length === 1) {
  161. width = this.singleWidth
  162. } else {
  163. width =
  164. this.showUrls[0].length * this.multipleSize +
  165. this.space * (this.showUrls[0].length - 1)
  166. }
  167. this.$emit('albumWidth', width)
  168. return width
  169. }
  170. },
  171. methods: {
  172. // 预览图片
  173. onPreviewTap(url) {
  174. const urls = this.urls.map((item) => {
  175. return this.getSrc(item)
  176. })
  177. uni.previewImage({
  178. current: url,
  179. urls
  180. })
  181. },
  182. // 获取图片的路径
  183. getSrc(item) {
  184. return uni.$u.test.object(item)
  185. ? (this.keyName && item[this.keyName]) || item.src
  186. : item
  187. },
  188. // 单图时,获取图片的尺寸
  189. // 在小程序中,需要将网络图片的的域名添加到小程序的download域名才可能获取尺寸
  190. // 在没有添加的情况下,让单图宽度默认为盒子的一定宽度(singlePercent)
  191. getImageRect() {
  192. const src = this.getSrc(this.urls[0])
  193. uni.getImageInfo({
  194. src,
  195. success: (res) => {
  196. // 判断图片横向还是竖向展示方式
  197. const isHorizotal = res.width >= res.height
  198. this.singleWidth = isHorizotal
  199. ? this.singleSize
  200. : (res.width / res.height) * this.singleSize
  201. this.singleHeight = !isHorizotal
  202. ? this.singleSize
  203. : (res.height / res.width) * this.singleWidth
  204. },
  205. fail: () => {
  206. this.getComponentWidth()
  207. }
  208. })
  209. },
  210. // 获取组件的宽度
  211. async getComponentWidth() {
  212. // 延时一定时间,以获取dom尺寸
  213. await uni.$u.sleep(30)
  214. // #ifndef APP-NVUE
  215. this.$uGetRect('.u-album__row').then((size) => {
  216. this.singleWidth = size.width * this.singlePercent
  217. })
  218. // #endif
  219. // #ifdef APP-NVUE
  220. // 这里ref="u-album__row"所在的标签为通过for循环出来,导致this.$refs['u-album__row']是一个数组
  221. const ref = this.$refs['u-album__row'][0]
  222. ref &&
  223. dom.getComponentRect(ref, (res) => {
  224. this.singleWidth = res.size.width * this.singlePercent
  225. })
  226. // #endif
  227. }
  228. }
  229. }
  230. </script>
  231. <style lang="scss" scoped>
  232. @import '../../libs/css/components.scss';
  233. .u-album {
  234. @include flex(column);
  235. &__row {
  236. @include flex(row);
  237. flex-wrap: wrap;
  238. &__wrapper {
  239. position: relative;
  240. &__text {
  241. position: absolute;
  242. top: 0;
  243. left: 0;
  244. right: 0;
  245. bottom: 0;
  246. background-color: rgba(0, 0, 0, 0.3);
  247. @include flex(row);
  248. justify-content: center;
  249. align-items: center;
  250. }
  251. }
  252. }
  253. }
  254. </style>