跳到主要内容

值转换器

用于配置得到的值和需要展示的值的映射。

何时使用

  • 一些页面需要将指定值显示为固定的文本,如枚举的值 0、1、2 以及 boolean 的 true 和 false 显示为对应文本。

一. 值转化器类型

当前值转化器会在部分组件的值、颜色和隐藏等配置项中提供入口,分别称为值转化器、颜色值转化器和隐藏值转化器。

(1)值转化器

image.png

(2)颜色值转化器

image.png

 (3)布尔值转化器

image.png

二. 如何使用值转化器

以枚举为例子,假如有一个天气类型枚举,枚举设计如下。

image.png

前端如果绑定了带有该枚举字段的Get接口,接口返回的该枚举字段值是0、1、2等,这通常不符合需求,界面上需要展示的往往是枚举的“显示名称”。所以就需要一个值转化器,将接口返回的枚举值,转化成对应的显示名称(或其他对应的文本、图片等)。

(1)值转化器

当前SD中做了处理,假如组件绑定了枚举字段,则会自动生成一个枚举的值转化器,将枚举值转为枚举字段对应的显示名称,也可自行编辑为其他文本。

image.png



image.png



image.png

(2)颜色转化器

假如使用一个标签组件绑定枚举字段,那么可以添加一个颜色值转化器,当为枚举的不同值时,标签颜色对应变化。

要为标签的背景色绑定颜色值转化器,首先需要将背景色改为数据绑定方式,并绑定对应枚举字段。

image.png

接着点击值转化器绑定按钮,在当前视图(全局视图也可以)点击“+”按钮,会自动生成一个 枚举字段 → 十六进制颜色色值 的颜色值转化器,也可自行编辑颜色。

image-20250710160739221

生成代码后运行效果如下。

image.png

(3)隐藏值转化器

当枚举字段为某个值时,需要隐藏个别组件,就可以使用隐藏值转化器来实现。

隐藏配置项改为数据绑定方式,并绑定天气状态枚举字段,如下。

image.png

接着点击值转化器绑定按钮,在当前视图(全局视图也可以)点击“+”按钮,会自动生成一个有全部枚举值的隐藏值转化器。

image.png

然后按照前面的需求,将枚举值为0和1时(即晴天和多云时),输出值设为true(即需要隐藏的值),其他枚举值输出值设为false,如下。​

image.png

生成代码运行,运行后可以看到,当天气状态枚举字段值为0或1时(即晴天或多云),天气状态列的标签组件不显示,其他枚举值时正常显示,如下。

image.png