图片。
起始版本:1.0.0
名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
src | string | - | 是 | 图片资源地址。支持线上资源和本地资源,支持png,jpg,jpeg,gif,svg,bmp,webp。 |
mode | string | scaleToFill | 否 | 图片裁剪、缩放的模式。详细内容参见“mode合法值说明”。 |
binderror | eventhandle | - | 否 | 当错误发生时触发,event.detail = {errMsg}。 |
bindload | eventhandle | - | 否 | 当图片载入完毕时触发,event.detail = {height, width}。 |
mode合法值说明:
值 | 说明 |
|---|---|
scaleToFill | 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素。 |
aspectFit | 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 |
aspectFill | 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 |
widthFix | 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变。 |
heightFix | 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变。 |
top | 裁剪模式,不缩放图片,只显示图片的顶部区域。 |
bottom | 裁剪模式,不缩放图片,只显示图片的底部区域。 |
center | 裁剪模式,不缩放图片,只显示图片的中间区域。 |
left | 裁剪模式,不缩放图片,只显示图片的左边区域。 |
right | 裁剪模式,不缩放图片,只显示图片的右边区域。 |
top left | 裁剪模式,不缩放图片,只显示图片的左上边区域。 |
top right | 裁剪模式,不缩放图片,只显示图片的右上边区域。 |
bottom left | 裁剪模式,不缩放图片,只显示图片的左下边区域。 |
bottom right | 裁剪模式,不缩放图片,只显示图片的右下边区域。 |
hxml文件
<view>
<view has:for="{{array}}" has:for-item="item">
<view>{{item.text}}</view>
<view>
<image
style="width: 200px; height: 200px; background-color: #eeeeee"
mode="{{item.mode}}"
src="{{src}}"
></image>
</view>
</view>
</view> js文件
Page({
data: {
array: [
{
mode: "scaleToFill",
text: "scaleToFill:不保持纵横比缩放图片,使图片完全适应",
},
{
mode: "aspectFit",
text: "aspectFit:保持纵横比缩放图片,使图片的长边能完全显示出来",
},
{
mode: "aspectFill",
text: "aspectFill:保持纵横比缩放图片,只保证图片的短边能完全显示出来",
},
{
mode: "widthFix",
text: "widthFix:宽度不变,高度自动变化,保持原图宽高比不变",
},
{
mode: "top",
text: "top:不缩放图片,只显示图片的顶部区域",
},
{
mode: "bottom",
text: "bottom:不缩放图片,只显示图片的底部区域",
},
{
mode: "center",
text: "center:不缩放图片,只显示图片的中间区域",
},
{
mode: "left",
text: "left:不缩放图片,只显示图片的左边区域",
},
{
mode: "right",
text: "right:不缩放图片,只显示图片的右边边区域",
},
{
mode: "top left",
text: "top left:不缩放图片,只显示图片的左上边区域",
},
{
mode: "top right",
text: "top right:不缩放图片,只显示图片的右上边区域",
},
{
mode: "bottom left",
text: "bottom left:不缩放图片,只显示图片的左下边区域",
},
{
mode: "bottom right",
text: "bottom right:不缩放图片,只显示图片的右下边区域",
},
],
src: "https://www.example.com/example.jpg", // 此处仅为样例,请开发者更换为可用图片资源地址
},
binderror: function (e) {
console.log("加载失败");
},
bindload: function (e) {
console.log("加载完成");
},
});