全局UI方法-弹窗三-文本滑动选择器弹窗（TextPickDialog）

yyxhzdm

已于 2024-03-28 14:49:07 修改

阅读量1.4k

点赞数 15

分类专栏： HarmonyOS基础知识进阶学习文章标签： harmonyos openHarmony 华为

于 2024-03-28 11:00:34 首次发布

本文链接：https://blog.youkuaiyun.com/yyxhzdm/article/details/137102944

版权

HarmonyOS基础知识进阶学习专栏收录该内容

11 篇文章

订阅专栏

文章介绍了如何在应用中创建TextPickerDialog文本选择器，包括其接口、参数配置（如选择范围、默认选中项、回调函数等），并提供了示例代码展示了如何在不同场景下使用这个组件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、描述

根据指定的选择范围创建文本选择器，展示在弹窗上。

2、接口

TextPickDialog(options?: TextPickDialogOptions)

3、TextPickDialogOptions

参数名称	参数类型	必填	参数描述
rang	string[] \| Resource	是	设置文本选择器的选择范围。
selected	number	否	设置选中项的索引值。默认值：0。
value	string	否	设置选中项的文本内容。当设置了selected参数时，该参数不生效。如果设置的value值不在range范围内，则默认去range第一个元素。
DefaultPickItemHeight	number \| string	否	设置选择器中选项的高度。
onAccept	(value ： TextPickResult) => void	否	点击弹窗中“确定”按钮时触发该回调。
onCancel	() => void	否	点击弹窗中“取消”按钮时触发该回调。
onChange	(value ： TextPickResult) => void	否	滑动弹窗中的选择器使当前选中项改变时触发该回调。

4、TextPickerResult对象说明

称	类型	描述
value	string	选中项的文本内容。
index	number	选中项在选择范围数组中的索引值。

5、参数解析

1.当selected和value参数都设置时，且selecetd设置值在范围内时，value参数无效。

2.当不设置selected参数时，并且设置的value值不在range范围内时，显示的是默认的range的第一个元素。

3.根据onAccept和onChange监听或者确定选中项的数据信息。

6、示例

@Entry
@Component
struct TextPickerDialogPage {
  @State message: string = '根据指定的选择范围创建文本选择器，展示在弹窗上。'
  private defaultSelectIndex: number = 2; // 默认选中项索引值
  private developList: string[] = ['Android', 'IOS', 'Java', 'ArkTS', 'ArkUI-X', 'Python', 'TypeScript', 'Vue', 'HarmonyOS']; // 弹窗选项列表

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(20)
          .fontWeight(FontWeight.Bold)
          .width("96%")
          .margin({ top: 12 })

        Button("TextPickerDialog.show Default")
          .width("96%")
          .fontSize(20)
          .margin({ top: 12 })
          .onClick(() => {
            TextPickerDialog.show({
              range: this.developList,
              onAccept: (result: TextPickerResult) => {
                console.info("TextPickerDialog Default onAccept result = " + JSON.stringify(result));
              },
              onCancel: () => {
                console.info("TextPickerDialog Default onCancel");
              },
              onChange: (result: TextPickerResult) => {
                console.info("TextPickerDialog Default onChange result = " + JSON.stringify(result));
              }
            })
          })

        Button("TextPickerDialog.show Selected")
          .width("96%")
          .fontSize(20)
          .margin({ top: 12 })
          .onClick(() => {
            TextPickerDialog.show({
              range: this.developList,
              selected: this.defaultSelectIndex,
              value: "Vue", // 当设置selected参数时，value参数会失效
              defaultPickerItemHeight: 60,
              onAccept: (result: TextPickerResult) => {
                console.info("TextPickerDialog Selected onAccept result = " + JSON.stringify(result));
              },
              onCancel: () => {
                console.info("TextPickerDialog Selected onCancel");
              },
              onChange: (result: TextPickerResult) => {
                console.info("TextPickerDialog Selected onChange result = " + JSON.stringify(result));
              }

            })
          })

      }
      .width('100%')
      .height("100%")
    }
    .height('100%')
  }
}

7、效果图