常德网站设计公司,东莞市建设局质量监督网站,自己建企业网站怎么建,word里面网站超链接怎么做Image为图片组件#xff0c;常用于在应用中显示图片。Image支持加载PixelMap、ResourceStr和DrawableDescriptor类型的数据源#xff0c;支持png、jpg、jpeg、bmp、svg、webp和gif类型的图片格式。 说明#xff1a; 该组件从API Version 7开始支持。后续版本如有新增内容常用于在应用中显示图片。Image支持加载PixelMap、ResourceStr和DrawableDescriptor类型的数据源支持png、jpg、jpeg、bmp、svg、webp和gif类型的图片格式。 说明 该组件从API Version 7开始支持。后续版本如有新增内容则采用上角标单独标记该内容的起始版本。 需要权限
使用网络图片时需要申请权限ohos.permission.INTERNET。具体申请方式请参考声明权限。
子组件
无
接口
Image(src: PixelMap | ResourceStr | DrawableDescriptor)
通过图片数据源获取图片用于后续渲染展示。
Image组件加载图片失败或图片尺寸为0时图片组件大小自动为0不跟随父组件的布局约束。
从API version 9开始该接口支持在ArkTS卡片中使用。
参数
参数名参数类型必填参数描述srcPixelMap | ResourceStr| DrawableDescriptor是图片的数据源支持本地图片和网络图片引用方式请参考加载图片资源。 1. PixelMap格式为像素图常用于图片编辑的场景。 2. ResourceStr包含Resource和string格式。 string格式可用于加载网络图片和本地图片常用于加载网络图片。当使用相对路径引用本地图片时例如Image(common/test.jpg)不支持跨包/跨模块调用该Image组件建议使用Resource格式来管理需全局使用的图片资源。 - 支持Base64字符串。格式data:image/[png|jpeg|bmp|webp];base64,[base64 data], 其中[base64 data]为Base64字符串数据。 - 支持file://路径前缀的字符串应用沙箱URIfile://bundleName/sandboxPath。用于读取本应用安装目录下files文件夹下的图片资源。需要保证目录包路径下的文件有可读权限。 Resource格式可以跨包/跨模块访问资源文件是访问本地图片的推荐方式。 3. 当传入资源id或name为普通图片时生成DrawableDescriptor对象。说明 - ArkTS卡片上支持gif图片格式动效但仅在显示时播放一次。 - ArkTS卡片上不支持http://等网络相关路径前缀和file://路径前缀的字符串。 - ArkTS卡片上不支持 PixelMap类型。 - 加载本地图片过程中如果对图片进行修改或者替换可能会引起应用崩溃。因此需要覆盖图片文件时应该先删除该文件再重新创建一个同名文件。 - 网络图片必须支持RFC 9113标准否则会导致加载失败。
属性
属性的详细使用指导请参考添加属性。除支持通用属性外还支持以下属性
名称参数类型描述altstring | Resource加载时显示的占位图支持本地图片png、jpg、bmp、svg和gif类型不支持网络图片。 默认值null 从API version 9开始该接口支持在ArkTS卡片中使用。objectFitImageFit设置图片的填充效果。 默认值ImageFit.Cover 从API version 9开始该接口支持在ArkTS卡片中使用。objectRepeatImageRepeat设置图片的重复样式。从中心点向两边重复剩余空间不足放下一张图片时会截断。 默认值ImageRepeat.NoRepeat 从API version 9开始该接口支持在ArkTS卡片中使用。说明 svg类型图源不支持该属性。interpolationImageInterpolation设置图片的插值效果即缓解图片在缩放时的锯齿问题。 默认值ImageInterpolation.None 从API version 9开始该接口支持在ArkTS卡片中使用。说明 svg类型图源不支持该属性。renderModeImageRenderMode设置图片的渲染模式为原色或黑白。 默认值ImageRenderMode.Original 从API version 9开始该接口支持在ArkTS卡片中使用。说明 svg类型图源不支持该属性。sourceSize{ width: number, height: number }设置图片解码尺寸降低图片的分辨率常用于需要让图片显示尺寸比组件尺寸更小的场景。和ImageFit.None配合使用时可在组件内显示小图。 单位vp 从API version 9开始该接口支持在ArkTS卡片中使用。说明 仅在目标尺寸小于图源尺寸时生效。 svg类型图源不支持该属性。 PixelMap资源不支持该属性。matchTextDirectionboolean设置图片是否跟随系统语言方向在RTL语言环境下显示镜像翻转显示效果。 默认值false 从API version 9开始该接口支持在ArkTS卡片中使用。fitOriginalSizeboolean图片组件尺寸未设置时其显示尺寸是否跟随图源尺寸。 默认值false 从API version 9开始该接口支持在ArkTS卡片中使用。fillColorResourceColor设置填充颜色设置后填充颜色会覆盖在图片上。 从API version 9开始该接口支持在ArkTS卡片中使用。说明 仅对svg图源生效设置后会替换svg图片的填充颜色。autoResizeboolean设置图片解码过程中是否对图源自动缩放。设置为true时组件会根据显示区域的尺寸决定用于绘制的图源尺寸有利于减少内存占用。如原图大小为1920x1080而显示区域大小为200x200则图片会降采样解码到200x200的尺寸大幅度节省图片占用的内存。 默认值true 从API version 9开始该接口支持在ArkTS卡片中使用。说明 降采样解码时图片的部分信息丢失因此可能会导致图片质量的下降如出现锯齿这时可以选择把autoResize设为false按原图尺寸解码提升显示效果。syncLoad8boolean设置是否同步加载图片默认是异步加载。同步加载时阻塞UI线程不会显示占位图。 默认值false 从API version 9开始该接口支持在ArkTS卡片中使用。说明 建议加载尺寸较小的本地图片时将syncLoad设为true因为耗时较短在主线程上执行即可。copyOption9CopyOptions设置图片是否可复制。 当copyOption设置为非CopyOptions.None时支持使用长按、鼠标右击、快捷组合键CTRLC等方式进行复制。 默认值CopyOptions.None 从API version 9开始该接口支持在ArkTS卡片中使用。说明 svg图片不支持复制。colorFilter9ColorFilter给图像设置颜色滤镜效果入参为一个的4x5的RGBA转换矩阵。 矩阵第一行表示R红色的向量值第二行表示G绿色的向量值第三行表示B蓝色的向量值第四行表示A透明度的向量值4行分别代表不同的RGBA的向量值。 当矩阵对角线值为1其余值为0时保持图片原有色彩。计算规则 如果输入的滤镜矩阵为 像素点为[R, G, B, A] 则过滤后的颜色为 [R’, G’, B’, A’] 从API version 9开始该接口支持在ArkTS卡片中使用。说明 svg类型图源不支持该属性。draggable9boolean设置组件默认拖拽效果设置为true时组件可拖拽。 不能和onDragStart事件同时使用。 默认值false说明 API version 9的默认值为falseAPI version 10的默认值为true。enableAnalyzer11boolean设置组件支持AI分析设置为true时组件可进行AI分析。 不能和overlay属性同时使用两者同时设置时overlay中CustomBuilder属性将失效。 默认值false说明 该特性依赖设备能力。 分析图像要求是静态非矢量图即svg、gif等图像类型不支持分析支持传入PixelMap进行分析目前仅支持RGBA_8888类型使用方式见示例。 alt占位图不支持分析objectRepeat属性仅在ImageRepeat.NoRepeat下支持分析隐私遮罩属性obscured打开时不支持分析。 基于完整原始图像进行分析设置clip、margin、borderRadius、position和objectFit属性导致图像显示不完整或使用renderMode设置蒙层仍基于完整原始图像进行分析。 copyOption属性不影响AI分析功能。analyzerConfig11ImageAnalyzerConfig设置AI分析类型包括主体识别和文字识别功能默认全部开启。说明 分析类型不支持动态修改。系统接口 此接口为系统接口。edgeAntialiasing11number设置SVG图源抗锯齿效果仅对svg图源生效。 取值范围[0.333,1.333][0.333,1.333]有效数字保留小数点后3位。 默认值00。 说明 使用快捷组合键对Image组件复制时Image组件必须处于获焦状态。Image组件默认不获焦需将focusable属性设置为true即可使用TAB键将焦点切换到组件上再将focusOnTouch属性设置为true即可实现点击获焦。图片设置为svg图源时当前支持的标签是svg、rect、circle、ellipse、path、line、polyline和polygon。 ImageInterpolation
从API version 9开始该接口支持在ArkTS卡片中使用。
名称描述None不使用图片插值。High高图片插值插值质量最高可能会影响图片渲染的速度。Medium中图片插值。Low低图片插值。
ImageRenderMode
从API version 9开始该接口支持在ArkTS卡片中使用。
名称描述Original原色渲染模式。Template黑白渲染模式。
ImageAnalyzerConfig11
从API version 11开始该接口支持在ArkTS卡片中使用。
图片AI分析类型配置。
系统接口 此接口为系统接口。
系统能力 SystemCapability.ArkUI.ArkUI.Full
名称描述SUBJECT主体识别功能。TEXT文字识别功能。
事件
除支持通用事件外还支持以下事件
onComplete
onComplete(callback: (event?: { width: number, height: number, componentWidth: number, componentHeight: number, loadingStatus: number,contentWidth: number, contentHeight: number, contentOffsetX: number, contentOffsetY: number}) void) }) void)
图片数据加载成功和解码成功时均触发该回调返回成功加载的图片尺寸。
从API version 9开始该接口支持在ArkTS卡片中使用。
参数
参数名类型说明widthnumber图片的宽。 单位像素heightnumber图片的高。 单位像素componentWidthnumber组件的宽。 单位像素componentHeightnumber组件的高。 单位像素loadingStatusnumber图片加载成功的状态值。说明 返回的状态值为0时表示图片数据加载成功。返回的状态值为1时表示图片解码成功。contentWidth10number图片实际绘制的宽度。 单位像素说明 仅在loadingStatus返回1时有效。contentHeight10number图片实际绘制的高度。 单位像素说明 仅在loadingStatus返回1时有效。contentOffsetX10number实际绘制内容相对于组件自身的x轴偏移。 单位像素说明 仅在loadingStatus返回1时有效。contentOffsetY10number实际绘制内容相对于组件自身的y轴偏移。 单位像素说明 仅在loadingStatus返回1时有效。
onError
onError(callback: ImageErrorCallback)
图片加载异常时触发该回调。
从API version 9开始该接口支持在ArkTS卡片中使用。
参数
参数名类型说明callbackImageErrorCallback图片加载异常时触发的回调。
onFinish
onFinish(event: () void)
当加载的源文件为带动效的svg格式图片时svg动效播放完成时会触发这个回调。如果动效为无限循环动效则不会触发这个回调。
仅支持svg格式的图片。
从API version 9开始该接口支持在ArkTS卡片中使用。
ImageErrorCallback11
type ImageErrorCallback (error: ImageError) void
图片加载异常时触发的回调。
参数名类型说明errorImageError图片加载异常时触发回调的返回对象。
ImageError11
图片加载异常时触发回调的返回对象。
参数名类型说明componentWidthnumber组件的宽。 单位像素componentHeightnumber组件的高。 单位像素messagestring报错信息。
示例
加载基本类型图片
Entry
Component
struct ImageExample1 {build() {Column() {Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start }) {Row() {// 加载png格式图片Image($r(app.media.ic_camera_master_ai_leaf)).width(110).height(110).margin(15).overlay(png, { align: Alignment.Bottom, offset: { x: 0, y: 20 } })// 加载gif格式图片Image($r(app.media.loading)).width(110).height(110).margin(15).overlay(gif, { align: Alignment.Bottom, offset: { x: 0, y: 20 } })}Row() {// 加载svg格式图片Image($r(app.media.ic_camera_master_ai_clouded)).width(110).height(110).margin(15).overlay(svg, { align: Alignment.Bottom, offset: { x: 0, y: 20 } })// 加载jpg格式图片Image($r(app.media.ic_public_favor_filled)).width(110).height(110).margin(15).overlay(jpg, { align: Alignment.Bottom, offset: { x: 0, y: 20 } })}}}.height(320).width(360).padding({ right: 10, top: 10 })}
} 加载网络图片
加载网络图片时默认网络超时是5分钟建议使用alt配置加载时的占位图。如果需要更灵活的网络配置可以使用HTTP工具包发送网络请求接着将返回的数据解码为Image组件中的PixelMap图片开发可参考图片处理。
使用网络图片时需要申请权限ohos.permission.INTERNET。具体申请方式请参考声明权限。
Entry
Component
struct ImageExample2 {build() {Column({ space: 10 }) {Image(https://www.example.com/xxx.png)// 直接加载网络地址请填写一个具体的网络图片地址.alt($r(app.media.icon))// 使用alt在网络图片加载成功前使用占位图.width(100).height(100)}}
}
为图片添加事件
Entry
Component
struct ImageExample3 {private imageOne: Resource $r(app.media.earth);private imageTwo: Resource $r(app.media.star);private imageThree: Resource $r(app.media.moveStar);State src: Resource this.imageOneState src2: Resource this.imageThreebuild(){Column(){//为图片添加点击事件点击完成后加载特定图片Image(this.src).width(100).height(100).onClick(() {this.src this.imageTwo})//当加载图片为SVG格式时Image(this.src2).width(100).height(100).onClick(() {//SVG动效播放完成时加载另一张图片this.src2 this.imageOne})}.width(100%).height(100%)}
} 使用PixelMap开启图像分析
import image from ohos.multimedia.image
Entry
Component
struct ImageExample4 {State imagePixelMap: image.PixelMap | undefined undefinedasync aboutToAppear() {this.imagePixelMap await this.getPixmapFromMedia($r(app.media.app_icon))}build() {Column() {Image(this.imagePixelMap).enableAnalyzer(true).width(200).height(200)}}private async getPixmapFromMedia(resource: Resource) {let unit8Array await getContext(this)?.resourceManager?.getMediaContent({bundleName: resource.bundleName,moduleName: resource.moduleName,id: resource.id})let imageSource image.createImageSource(unit8Array.buffer.slice(0, unit8Array.buffer.byteLength))let createPixelMap: image.PixelMap await imageSource.createPixelMap({desiredPixelFormat: image.PixelMapFormat.RGBA_8888})await imageSource.release()return createPixelMap}
}
最后有很多小伙伴不知道学习哪些鸿蒙开发技术不知道需要重点掌握哪些鸿蒙应用开发知识点而且学习时频繁踩坑最终浪费大量时间。所以有一份实用的鸿蒙Harmony NEXT资料用来跟着学习是非常有必要的。
这份鸿蒙Harmony NEXT资料包含了鸿蒙开发必掌握的核心知识要点内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等鸿蒙Harmony NEXT技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助有需要的小伙伴自行领取限时开源先到先得~无套路领取 获取这份完整版高清学习路线请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙Harmony NEXT最新学习路线 HarmonOS基础技能 HarmonOS就业必备技能 HarmonOS多媒体技术 鸿蒙NaPi组件进阶 HarmonOS高级技能 初识HarmonOS内核 实战就业级设备开发 有了路线图怎么能没有学习资料呢小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙OpenHarmony 学习手册共计1236页与鸿蒙OpenHarmony 开发入门教学视频内容包含ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》 《鸿蒙生态应用开发V2.0白皮书》 《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建 《鸿蒙开发基础》
ArkTS语言安装DevEco Studio运用你的第一个ArkTS应用ArkUI声明式UI开发.…… 《鸿蒙开发进阶》
Stage模型入门网络管理数据管理电话服务分布式应用开发通知与窗口管理多媒体技术安全技能任务管理WebGL国际化开发应用测试DFX面向未来设计鸿蒙系统移植和裁剪定制…… 《鸿蒙进阶实战》
ArkTS实践UIAbility应用网络案例…… 获取以上完整鸿蒙HarmonyOS学习资料请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说华为鸿蒙不再兼容安卓对中年程序员来说是一个挑战也是一个机会。只有积极应对变化不断学习和提升自己他们才能在这个变革的时代中立于不败之地。
