Img 图片

增强版的 img 标签，提供多种图片填充模式，支持图片懒加载、加载完成、加载失败。

基本用法

基础用法与原生 image 标签一致，可以设置 src 、 width 、height 等原生属性。

原生属性，参考uni-app image 官方文档。

此处需要注意的是 src 属性：

使用 相对路径，需要注意 src 需要以组件存放位置相对图片位置为相对路径。

使用 文件导入 ，需要注意的是微信小程序 image 标签路径接受二进制数据以及 base64 编码。单独使用 import 图片路径无法访问。

<wd-img :width="100" :height="100" :src="joy" />

// import { joy } from '../images/joy'
const joy = 'data:image/jpeg;base64,...' // 图片文件base64

提示

可以配置 transformAssetUrls 使 src 属性获得与原生 image 一致的体验。

// vite.config.(js|ts)

import uni from '@dcloudio/vite-plugin-uni'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    // ...
    uni({
      vueOptions: {
        template: {
          transformAssetUrls: {
            tags: {
              'wd-img': ['src']
            }
          }
        }
      }
    })
  ]
})

修改完成后重启开发服务即可生效，查看 uni-app issue#4997 了解更多。

插槽

使用loading error插槽设置在图片加载时、加载失败后的展示内容

<template>
  <wd-img :width="100" :height="100" src="https://www.123.com/a.jpg">
    <template #error>
      <view class="error-wrap">加载失败</view>
    </template>
    <template #loading>
      <view class="loading-wrap">
        <wd-loading />
      </view>
    </template>
  </wd-img>
</template>

<style>
.error-wrap {
  width: 100%;
  height: 100%;
  background-color: red;
  color: white;
  line-height: 100px;
  text-align: center;
}

.loading-wrap {
  width: 100%;
  height: 100%;
  display: flex;
  justify-content: center;
  align-items: center;
}
</style>

填充模式

通过 mode 属性可以设置图片填充模式，可选值见下方表格。

mode 为小程序原生属性，参考微信小程序 image 官方文档。

<wd-img :width="100" :height="100" mode="center" :src="joy" />

圆形设置

通过 round 属性可以设置以圆形展示。

<wd-img :width="100" :height="100" round :src="joy" />

可预览

通过设置enable-preview属性可以支持点击预览，底层调用 uni.previewImage 来实现预览效果

<wd-img :width="100" :height="100" :src="joy" :enable-preview="true" />

也可以传入 preview-src 属性来预览另外的图片

<wd-img :width="100" :height="100" :src="joy" :preview-src="img" :enable-preview="true" />

Attributes

参数	说明	类型	可选值	默认值	最低版本
src	图片链接	string	-	-	-
width	宽度，默认单位为 px	number / string	-	-	-
height	高度，默认单位为 px	number / string	-	-	-
mode	填充模式	ImageMode	'top left' / 'top right' / 'bottom left' / 'bottom right' / 'right' / 'left' / 'center' / 'bottom' / 'top' / 'heightFix' / 'widthFix' / 'aspectFill' / 'aspectFit' / 'scaleToFill'	'scaleToFill'	-
round	是否显示为圆形	boolean	-	false	-
radius	圆角大小，默认单位为 px	number / string	-	-	-
enable-preview	是否支持点击预览	boolean	-	false	1.2.11
show-menu-by-longpress	开启长按图片显示识别小程序码菜单，仅微信小程序支持	boolean	-	false	1.3.11
preview-src	预览图片链接	string	-	-	1.8.0

Events

事件名称	说明	参数	最低版本
click	点击事件	(event: MouseEvent) => void	-
load	当图片载入完毕时触发	{height, width}	-
error	当错误发生时触发	{errMsg}	-

Slots

名称	说明	最低版本
loading	图片加载时展示	1.2.21
error	图片加载失败后展示	1.2.21

外部样式类

类名	说明	最低版本
custom-class	根节点样式	-
custom-image	image 外部自定义样式	-

源代码

文档

• 组件