Skip to content

UI图片

UiImage 是继承自 UiRenderable

属性

image

默认值:''

图片元素的内容,应为图片的路径或者 URL。


imageOpacity

默认值:1

图片元素的透明度。


imageDisplayMode

默认值:ImageDisplayMode.Fill

图像显示模式的声明。

图片元素中的图片资源,不属于其子内容,所以只受到展示方式影响,不受裁剪&自适应作用


complete

图片是否加载完毕。

静态方法

create()

创建一个新的 Ui图片 实例。初始parent为空。

返回值

类型说明
UiImage新建 UiImage 元素实例

枚举

ImageDisplayMode

控制图像的显示方式

属性说明
Fill铺满:(默认)适配元素外框长宽拉伸铺满展示,图片可能会变形
Contain等比铺满:等比缩放保证图片完整展示在外框内
Cover等比截取:等比缩放图片使图片填满外框,超出部分将被裁剪(隐藏显示)
None无:按图片正常尺寸与外框中心对齐展示,不对图片进行任何缩放调整,但是超出元素框部分会被裁剪(隐藏显示)

图片加载完毕事件

load

图片加载完成后触发。

javascript
const img = UiImage.create();
img.image ='picture/cat.jpg';
img.imageDisplayMode = ImageDisplayMode.Contain;

img.events.add('load', (event)=>{
  console.log('complete = ', event.target.complete);
})

img.parent = ui;