uView Image 图片

简介: uView Image 图片

此组件为uni-app的image组件的加强版,在继承了原有功能外,还支持淡入动画、加载中、加载失败提示、圆角值和形状等。

我们推荐您在任何使用图片场景的地方,都优先考虑使用这个小巧,精致而实用的组件。

注意:

由于在nvue下,u-image名称被uni-app官方占用,在nvue页面中请使用u--image名称,在vue页面中使用u--image或者u-image均可。

#平台差异说明

App(vue) App(nvue) H5 小程序

#基本使用

配置图片的width宽和height高,以及src路径即可使用。

<template>
  <u--image :showLoading="true" :src="src" width="80px" height="80px" @click="click"></u--image>
</template>
<script>
  export default {
    data() {
      return {
        src: 'https://cdn.uviewui.com/uview/album/1.jpg'
      }
    }
  }
</script>

copy

#裁剪模式

通过mode参数配置填充模式,此模式用法与uni-app的image组件的mode参数完全一致,详见:Image(opens new window)

<u--image src="https://cdn.uviewui.com/uview/album/1.jpg" mode="widthFix"></u--image>

copy

#图片形状

  • 通过shape参数设置图片的形状,circle为圆形,square为方形
  • 如果为方形时,还可以通过radius属性设置圆角值
<u--image src="https://cdn.uviewui.com/uview/album/1.jpg" shape="circle"></u--image>

copy

#懒加载

注意:此功能只对微信小程序、App、百度小程序、字节跳动小程序有效,默认开启。

<u-image src="https://cdn.uviewui.com/uview/album/1.jpg" :lazy-load="true"></u-image>

copy

#加载中提示

图片加载过程中,为加载中状态(默认显示一个小图标),可以通过loading自定义插槽,结合uView的u-loading组件,实现加载的动画效果。

<u--image src="https://cdn.uviewui.com/uview/album/1.jpg">
  <template v-slot:loading>
    <u-loading-icon color="red"></u-loading-icon>
  </template>
</u--image>

copy

#加载错误提示

图片加载失败时,默认显示一个错误提示图标,可以通过error自定义插槽,实现个性化的提示方式。

<u--image src="https://cdn.uviewui.com/uview/album/1.jpg">
  <view slot="error" style="font-size: 24rpx;">加载失败</view>
</u--image>

copy

#淡入动画

组件自带了加载完成时的淡入动画效果:

  • 通过fade参数配置是否开启动画效果
  • 通过duration参数配置动画的过渡时间,单位ms
<u--image src="https://cdn.uviewui.com/uview/album/1.jpg" :fade="true" duration="450"></u--image>

copy

#事件冒泡

默认情况下,组件是允许内部向外事件冒泡的,因为很多情况下,我们都希望点击图片,同时图片所在的父元素的点击事件也能触发。

如果您想避免事件冒泡,那么您可以在组件外面嵌套一个view,同时给它加上@tap.stop即可。

<!-- 点击图片将不会触发clickHandler -->
<view @tap="clickHandler">
  <view @tap.stop>
    <u--image src="https://cdn.uviewui.com/uview/album/1.jpg"></u--image>
  </view>
</view>
相关实践学习
Serverless极速搭建Hexo博客
本场景介绍如何使用阿里云函数计算服务命令行工具快速搭建一个Hexo博客。
相关文章
|
6月前
|
前端开发
UniApp 中的 image 属性讲解
UniApp 中的 image 属性讲解
837 2
|
6月前
|
小程序 搜索推荐
uniapp中如何使用image图片
uniapp中如何使用image图片
1435 0
|
安全 开发者
SwiftUI极简教程02:Image图片的使用
SwiftUI极简教程02:Image图片的使用
1442 1
SwiftUI极简教程02:Image图片的使用
|
JavaScript
Element-ui中 使用图片查看器(el-image-viewer) 预览图片
Element-ui中 使用图片查看器(el-image-viewer) 预览图片
1912 1
Element-ui中 使用图片查看器(el-image-viewer) 预览图片
|
3月前
|
容器
Vue3图片(Image)
该图片预览组件提供丰富的功能,包括设置鼠标悬浮预览文本、图像描述、尺寸调整、适应容器模式等。支持单张或多张图片展示,具备旋转、缩放、镜像等功能,并可通过键盘或滚轮控制。组件允许自定义多项属性,如图像地址、宽度、高度、边框显示等,并兼容多种使用场景,如相册模式和循环切换。组件内部使用了 Vue3 的 `Spin` 和 `Space` 组件以及 `add` 函数辅助实现。
Vue3图片(Image)
|
3月前
|
JavaScript
如何在Vue页面中引入img下的图片作为背景图。../的使用
这篇文章介绍了在Vue页面中如何引入`img`目录下的图片作为背景图,提供了两种使用相对路径的方法。第一种是使用`../assets/img/`作为路径引入图片,第二种是使用`../../assets/img/`作为路径。文章还展示了使用这些方法的代码实现和效果展示,并鼓励读者学无止境。
如何在Vue页面中引入img下的图片作为背景图。../的使用
|
5月前
Elementui-Image组件,单个图片点击放大展示
Elementui-Image组件,单个图片点击放大展示
215 2
|
6月前
|
数据安全/隐私保护
vue-img-cutter 图片裁剪详解
vue-img-cutter 图片裁剪详解
154 1
|
6月前
|
前端开发 JavaScript 容器
ElementPlus Image 图片
ElementPlus Image 图片
84 0
|
11月前
|
计算机视觉 C++
png,jpg图片透明度化demo
png,jpg图片透明度化demo
70 0