鸿蒙Harmony应用开发—ArkTS声明式开发（基础手势：DataPanel）

数据面板组件，用于将多个数据占比情况使用占比图进行展示。

说明：

该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

DataPanel(options: DataPanelOptions)

从API version 9开始，该接口支持在ArkTS卡片中使用。

参数:

参数名	参数类型	必填	参数描述
options	DataPanelOptions	是	数据面板组件参数。

DataPanelOptions对象说明

参数名	参数类型	必填	参数描述
values	number[]	是	数据值列表，最多包含9个数据，大于9个数据则取前9个数据。若数据值小于0则置为0。
max	number	否	- max大于0，表示数据的最大值。 - max小于等于0，max等于value数组各项的和，按比例显示。 默认值：100
type8+	DataPanelType	否	数据面板的类型（不支持动态修改）。 默认值：DataPanelType.Circle

DataPanelType8+枚举说明

从API version 9开始，该接口支持在ArkTS卡片中使用。

名称	描述
Line	线型数据面板。
Circle	环形数据面板。

属性

除支持通用属性外，还支持以下属性：

名称	参数类型	描述
closeEffect	boolean	关闭数据占比图表旋转动效和投影效果。 默认值：false 说明： 若未设置trackShadow属性，则该属性控制投影效果的开关，开启投影的效果为投影的默认效果。 若设置trackShadow属性，则由trackShadow属性值控制投影效果的开关。
valueColors10+	Array<ResourceColor | LinearGradient>	各数据段颜色，ResourceColor为纯色，LinearGradient为渐变色。
trackBackgroundColor10+	ResourceColor	底板颜色。 默认值：'#08182431