Appearance
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;