根据指定的选择范围创建文本选择器,展示在弹窗上。
说明
该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用。
从API version 10开始,可以通过使用[UIContext]中的[showTextPickerDialog]来明确UI的执行上下文。
TextPickerDialog
show
static show(options?: TextPickerDialogOptions)
定义文本滑动选择器弹窗并弹出。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
options | [TextPickerDialogOptions] | 否 | 配置文本选择器弹窗的参数。 |
TextPickerDialogOptions对象说明
文本选择器弹窗的参数继承自[TextPickerOptions]。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
defaultPickerItemHeight | number | string | 否 |
disappearTextStyle10+ | [PickerTextStyle] | 否 | 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。默认值:{color: ‘#ff182431’,font: {size: ‘14fp’,weight: FontWeight.Regular}}元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
textStyle10+ | [PickerTextStyle] | 否 | 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。默认值:{color: ‘#ff182431’,font: {size: ‘16fp’,weight: FontWeight.Regular}}元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
selectedTextStyle10+ | [PickerTextStyle] | 否 | 设置选中项的文本颜色、字号、字体粗细。默认值:{color: ‘#ff007dff’,font: {size: ‘20vp’,weight: FontWeight.Medium}}元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
acceptButtonStyle12+ | [PickerDialogButtonStyle] | 否 | 设置确认按钮显示样式、样式和重要程度、角色、背景色、圆角、文本颜色、字号、字体粗细、字体样式、字体列表、按钮是否默认响应Enter键。**说明:**acceptButtonStyle与cancelButtonStyle中最多只能有一个primary字段配置为true,二者primary字段均配置为true时均不生效。元服务API: 从API version 12开始,该接口支持在元服务中使用。 |
cancelButtonStyle12+ | [Pick |