Skip to content

基础使用

hi-image 组件的默认宽高为 360rpx
hi-image 默认开启了加载状态配置,即图片加载过程中会显示 loading 图标和提示文字,可以通过 showLoading 属性来关闭。
hi-image 默认开启了错误状态配置,即图片加载失败后会显示 error 图标和提示文字,可以通过 showError 属性来关闭。

vue
<hi-image src="/static/images/temp.jpeg"></hi-image>

Props

uni-app image 组件自带的属性说明参考 uni-app image 组件官方文档

参数说明类型默认值可选值
width图片宽度String--
height图片高度String--
src图片资源路径String--
mode图片裁剪模式StringaspectFit-
showLoading是否显示 loading 状态Booleantrue-
loadingIconNameloading 图标名称String__loading-
loadingTextloading 提示文本String--
showError是否显示 error 状态Booleantrue-
errorIconNameerror 图标名称String__image-error-
errorTexterror 提示文本String--
lazyLoad是否开启懒加载Booleantrue-
fadeShow是否显示动画效果Booleantrue-
webp在系统不支持 webp 的情况下是否单独启用 webp。默认 false,只支持网络资源Booleantrue-
showMenuByLongpress开启长按图片显示识别小程序码菜单Booleantrue-
draggable是否能拖动图片Booleanfalse-

Events


具体的事件说明参考 uni-app button 组件官方文档

事件名说明回调参数版本
@load当图片载入完毕时,发布到 AppService 的事件名event.detail = {height:'图片高度 px', width:'图片宽度 px'}-
@error当错误发生时,发布到 AppService 的事件名event.detail = {errMsg: 'something wrong'}-