目录

视图:串联图片<ImageSeries>

功能概述

串联图片ImageSeries提供了根据输入字符串进行图片串联的功能,即能够按照字符顺序将字符图片拼在一起并显示;相比较ImageNumber,串联图片能够解析字符而不仅限于数字,提供了更强的解析能力。例如,可以用字符图片显示 '2020.01.01'(包含两个'.')或者 'Moon Festival 8.15'(包含字符),而这些功能数字图片均无法支持。

支持范围

起始规范版本:HarmonyOS 5.0

是否平台特性:否

表1 支持根标签
  

锁屏(Lockscreen)

桌面(Wallpaper)

一镜到底(LongTake)

百变卡片(Widget)

充电动效(ChargingSkin)

是否支持

√

√

√

√

√

表2 支持设备类型
  

直板机

折叠屏

平板

是否支持

√

√

√

XML规范

<ImageSeries src="date.png" string="'1234/'+ifelse(int(4.55),preciseeval('155/3',2), 0)+'/6789'" space="5" mapList="00, 11, 22, 33, 44, 55, 66, 77, 88, 99, aa, bb, cc, dd, ff, tt, Aaa, Bbb, Ccc, Ddd, /dot, .dot " />

参数说明

参数

类型

选项

注释

src

字符串

必填

待拼接的字符图片前缀,前缀与后缀通过“_”连接

string

表达式

必填

按照字符串的形式提供待拼接的多张字符图片后缀,支持字符串和字符串表达式。例如,letter_0.png表示一张完整字符图片名称,其中letter表示前缀,0表示后缀,通过“_”相连

space

数值

选填

待拼接的字符图片之间的间隔,默认为0

mapList

字符串

必填

映射列表,用英文逗号分隔。其中,每项第一个字符表示原字符(对应string中的字符),后续字符串(一个或多个)表示映射字符串(对应字符图片名称)

应用示例

示例一:该示例展示了string为字符串"Aa/Bb/Cc/Dd"的情形,可以支持字母以及斜杠字符的展示。关键在于mapList设置字符对应关系。

<Text x="400" y="600" color="#00ff00" size="50" text="测试字符串Aa/Bb/Cc/Dd拼接功能"  align="center"/>
<ImageSeries x="200" y="750" src="letter.png" space="10" string="Aa/Bb/Cc/Dd/" mapList="aa,bb,cc,dd,Aaa,Bbb,Ccc,Ddd,/dot" />