鸿蒙UI开发——文本级联选择器

最新推荐文章于 2025-08-15 18:00:00 发布

原创

最新推荐文章于 2025-08-15 18:00:00 发布 · 1.5k 阅读

CC 4.0 BY-SA版权

文章标签：

1、概述

ArkUI提供了一个文本选择器（showTextPickerDialog），可以方便的实现文本级联选择，例如：省->市->区，示意如下：

下面针对文本选择器做简单介绍。

定义文本滑动选择器弹窗并弹出，接口定义如下：

showTextPickerDialog(options: TextPickerDialogOptions): void

其中TextPickerDialogOptions，主要用于配置文本滑动选择器弹窗的参数。字段配置如下：

名称	类型	说明
range	string[] \| string[] [] \| Resource \|TextPickerRangeContent[] \| TextCascadePickerRangeContent[]	选择器的数据选择列表。不可设置为空数组，若设置为空数组，则不显示；若动态变化为空数组，则保持当前正常值显示。说明：单列数据选择器使用string[]，Resource，TextPickerRangeContent[]类型。多列数据选择器使用string[][]类型。多列联动数据选择器使用TextCascadePickerRangeContent[]类型。Resource类型只支持strarray.json。range的类型及列数不可以动态修改。
selected	number \| number[]	设置默认选中项在数组中的索引值。默认值：0 说明：单列数据选择器使用number类型。多列、多列联动数据选择器使用number[]类型。从API version 10开始，该参数支持$$双向绑定变量。
value	string \| string[]	设置默认选中项的值，优先级低于selected。默认值：第一个元素值说明：只有显示文本列表时该值有效。显示图片或图片加文本的列表时，该值无效。单列数据选择器使用string类型。多列、多列联动数据选择器使用string[]类型。从API version 10开始，该参数支持$$双向绑定变量。
defaultPickerItemHeight	number \| string	设置选择器中选项的高度。默认值：选中项56vp，非选中项36vp。设置该参数后，选中项与非选中项的高度均为所设置的值。
disappearTextStyle	PickerTextStyle