Skip to content

Image (图片)

image组件的加强版,在原有功能增加、加载中、加载失败提示、圆角值和形状等。

支持平台

安卓ios鸿蒙web微信小程序

示例代码

html
<template>
	<t-page main-class="p-30">
		<t-section main-class="mb-30" title="基础功能"></t-section>
		<t-image src="/pagesA/static/image/D1.jpg" main-class="h-350 w-100% tdr mb-30" :fade-show="true"></t-image>
		<t-section main-class="mb-30" title="开启预览"></t-section>
		<t-image src="/pagesA/static/image/D2.jpg" main-class="h-350 w-100% tdr mb-30" :preview="true"
			:loading="false"></t-image>
		<t-section main-class="mb-30" title="loading属性配置"></t-section>
		<t-image src="/pagesA/static/image/D1.jpg" main-class="h-350 w-100% tdr mb-30"
			:loadingAttrs="{name:'setting',type:'p',size:'l','mainClass':'s-200'}" :fade-show="true"></t-image>
		<t-section main-class="mb-30" title="加载错误占位图"></t-section>
		<t-image main-class="twh-350 tdr" src="https://ll-yundie-xyz/pagesA/static/loginbg1.jpeg"></t-image>
		<t-section main-class="mb-30" title="自定义加载错误占位图"></t-section>
		<t-image main-class="twh-350 tdr" src="https://ll-yundie-xyz/pagesA/static/loginbg1.jpeg"
			placeholder-image="/pagesA/static/image/D2.jpg"></t-image>
	</t-page>
</template>
<script setup>

</script>

属性

名称类型默认值说明可选值
sizeStringmini组件尺寸large(大尺寸), medium(中尺寸), small(小尺寸), mini(迷你)
typeString""组件类型info(信息), primary(正常), error(错误), warning(警告), success(成功)
disabledBooleanfalse组件是否禁用false, true
stopBooleanfalse是否阻止事件冒泡(Tui统一写法处理事件冒泡)false, true
hoverBooleantrue是否有点击效果false, true
pathString""点击组件后跳转的页面路径,如果为空则响应点击事件,如果不为空则跳转页面不会响应单击事件。-
mainClassString""组件根节点的样式-
nativeClassString""组件根节点原生样式-
effectString"normal"组件显示主题normal(正常), dark(深色), light(浅色), plain(镂空)
modeStringscaleToFill图片裁剪、缩放的模式scaleToFill: 不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
aspectFit: 保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
aspectFill: 保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取
widthFix: 宽度不变,高度自动变化,保持原图宽高比不变
heightFix: 高度不变,宽度自动变化,保持原图宽高比不变
top: 不缩放图片,只显示图片的顶部区域
bottom: 不缩放图片,只显示图片的底部区域
center: 不缩放图片,只显示图片的中间区域
left: 不缩放图片,只显示图片的左边区域
right: 不缩放图片,只显示图片的右边区域
top left: 不缩放图片,只显示图片的左上边区域
top right: 不缩放图片,只显示图片的右上边区域
bottom left: 不缩放图片,只显示图片的左下边区域
bottom right: 不缩放图片,只显示图片的右下边区域
loadingBooleanfalse是否显示加载动画
placeholderImageString``默认占位图
loadingAttrsUTSJSONObject{}加载组件的属性配置 支持t-loading的所有属性
srcString``图片资源地址
placeholderBooleanfalse是否默认占位图
fadeShowBooleantrue图片加载是否显示淡入动画效果
previewBooleanfalse是否预览

事件

名称返回参数说明
click(e : UniPointerEvent)-
error(e:UniImageErrorEvent)加载错误时触发
load(e:UniImageLoadEvent)图片加载完成时触发