鸿蒙ArkUI 文本滑动选择TextPicker的使用和简单解析

鸿蒙5.0版开发:ArkTS基础组件(TextPicker) 滑动选择文本内容的组件。 阅读详情

引入

在移动端开发中,表单始终都是必要的环节,文本滑动选择器是不得不品的一环

鸿蒙ArkUI中同样为我们准备了对应的组件,让我们来简单的了解一下吧

如上图是一个简单的性别选择的滑动选择器,它的实现非常简单

@Entry
@Component
struct Index {
  genderList: string[] = ['男', '女', '未知']

  build() {
    Column() {
      TextPicker({range:this.genderList})
        .width('100%')
        .height(200)
        .canLoop(false)
        .backgroundColor('#ccc')
    }
    .width('100%')
    .height('100%')
  }
}

TextPicker 就是今天我们的主角

子组件

TextPicker

滑动选择文本内容的组件。

子组件

无

TextPicker无法作为容器使用,不能放入任何的子组件

接口

TextPicker仅有一个对象参数,它的类型是TextPickerOptions,让我们一起看下,它的参数都可以为TextPicker带来些什么神奇的效果吧

range: 

string[] | string[] []  | Resource | TextPickerRangeContent[] | TextCascadePickerRangeContent[]

range是TextPicker的数据源,也是唯一一个必填的参数

他提供了很多种的类型可以填入,让我们分别来看下都是些什么

string[]

最简单的string数组,我们在开篇的时候看见的性别选择列表就是string

string[][]

string二维数组

多说无益,让我们先来看下效果

下面代码,我们将personList改为了二维数组

@Entry
@Component
struct Index {

  personList: string[][] = [['男', '女', '未知'],['未成年人','成年人']]

  build() {
    Column() {
      TextPicker({range:this.personList})
        .width('100%')
        .height(200)
        .canLoop(false)
        .backgroundColor('#ccc')
    }
    .width('100%')
    .height('100%')
  }
}

效果也是立竿见影,选择列变为了2行,分别对应数据中的性别,和年龄的一维数组

通过二位数组,甚至可以添加更多的行以供用户选择

Resource

Resource类型只支持strarray.json。

其实也就是string[],只不过通过Resource提取出来了

TextPickerRangeContent[]

TextPickerRangeContent是一个对象,拥有两个属性

icon:string | Resource   和 text   string | Resource   

看到icon,相信大家都知道,没错它是可以给我们的选择中添加图片

 genderList:TextPickerRangeContent[]=[{
    text:'男',
    icon: $r('app.media.male')
  },{
    text:'女',
    icon: $r('app.media.female')
  }]

TextCascadePickerRangeContent[]

在多行联动的时候,除了二维string数组,我们还可以使用TextCascadePickerRangeContent[]

先来看下这个超长的对象是什么

const textContent = {
  text:'辽宁省',
  children:TextCascadePickerRangeContent[]:[{
       text:'沈阳市',
       children: [{ text: '沈河区',children:[] }, 
                  { text: '和平区',children:[] }, 
                  { text: '浑南区',children:[] }]
    },{
       text:'大连市',
       children:[]
    }
  ]
}

没错它是一个嵌套自身的对象,有点像递归对象版

看下它的实战效果吧

@Entry
@Component
struct Index {

  // genderList: string[][] = [['男', '女', '未知'],['未成年人','成年人']]
  iconList:TextPickerRangeContent[]=[{
    text:'男',
    icon: $r('app.media.male')
  },{
    text:'女',
    icon: $r('app.media.female')
  }]

  eastNorthList:TextCascadePickerRangeContent[]=[
    {
      text: '辽宁省',
      children: [{ text: '沈阳市', children: [{ text: '沈河区' }, { text: '和平区' }, { text: '浑南区' }] },
        { text: '大连市', children: [{ text: '中山区' }, { text: '金州区' }, { text: '长海县' }] }]
    },
    {
      text: '吉林省',
      children: [{ text: '长春市', children: [{ text: '南关区' }, { text: '宽城区' }, { text: '朝阳区' }] },
        { text: '四平市', children: [{ text: '铁西区' }, { text: '铁东区' }, { text: '梨树县' }] }]
    },
    {
      text: '黑龙江省',
      children: [{ text: '哈尔滨市', children: [{ text: '道里区' }, { text: '道外区' }, { text: '南岗区' }] },
        { text: '牡丹江市', children: [{ text: '东安区' }, { text: '西安区' }, { text: '爱民区' }] }]
    }
  ]

  build() {
    Column() {
      TextPicker({range:this.eastNorthList})
        .width('100%')
        .height(200)
        .canLoop(false)

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

这样,应该三项联动的省市区选择器就做好啦

selected: number | number[]

设置默认选中项在数组中的索引值,索引从0开始,默认0

同样支持$$双绑,用于获取当选选中的下标,拿到用户操作后的数据

value: string | string[]

设置默认选中项的值,优先级低于selected,同样支持双绑

属性

defaultPickerItemHeight

设置Picker各选择项的高度,默认值:选中项56vp,非选中项36vp。

下图为设置了100时候样式(真的丑)

disappearTextStyle

设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。

PickerTextStyle对象用于更改样式(选中样式不会因为disappearTextStyle改变)

TextPicker({range:this.eastNorthList})
        .width('100%')
        .selectedTextStyle({
          color: '#ff0000',
          font: {
            size: '18fp',
            weight: FontWeight.Bold
          }
        })

textStyle

设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。

selectedTextStyle

设置选中项的文本颜色、字号、字体粗细。

将刚才的代码改为selectedTextStyle吧

canLoop

设置是否可循环滚动。默认true

实际上循环的情况下很少而且很丑,所以一定要手动变为false哦

divider

设置分割线样式,不设置该属性则按“默认值”展示分割线。设置为null不显示分割线

gradientHeight

设置渐隐效果的高度。若未设置该属性,则显示默认渐隐效果。

其他的属性就不带大家一起看效果啦,感兴趣的朋友可以自己去试试哦

事件

onAccept

onAccept(callback: (value: string, index: number) => void)

点击弹窗中的“确定”按钮时触发该回调。该事件仅在文本滑动选择器弹窗中生效。

onCancel

点击弹窗中的“取消”按钮时触发该回调。该事件仅在文本滑动选择器弹窗中生效。

关于文本滑动选择器弹窗,会在之后给大家进行介绍

onChange

onChange(callback: (value: string | string[], index: number | number[]) => void)

滑动选中TextPicker文本内容后,触发该回调。当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空。

onScrollStop

onScrollStop(callback: TextPickerScrollStopCallback)

文本选择器的选项列滑动停止时触发该事件。手指拖动选项列触发的滑动,手指离开屏幕且滑动停止时会触发该事件

TextPickerScrollStopCallback里面是index和value

onChange和onScrollStop的使用区别

onChange和onScrollStop尽管很相似,但是使用却并不相同,onScrollStop更适合获取用户具体的选择,而onChange则是监听改变的过程

TextPicker({range:this.genderList})
        .width('100%')
        .canLoop(false)
        .onChange((value, index)=>{
          console.log('onChange',value);
        })
        .onScrollStop((value, index)=>{
          console.log('onScrollStop',value);
        })

当从男性滑动到未知的过程中

通过日志打印我们可以得到以上信息

onScrollStop的触发时机要晚于onChange,并且并不会对滑动过程中产生的改变做出响应

而onChange更加灵敏,可以全方位监听

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之TextPicker组件 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:TextPicker)

ArkTS声明式开发(基础手势:TextPicker)

m0_64420071的博客 1802

14. 快速上手!HarmonyOS4.0 (TextPicker_文本滑动选择器弹窗_TextTimer)组件详解

的基本使用了,但在我们开发的过程中,经常用到的弹窗却是 带有。根据指定的选择范围创建文本选择器,展示在弹窗上。通过文本显示计时信息并控制其计时器状态的组件。根据range指定的选择范围创建文本选择器。事件表示点击取消按钮 , 点击确认按钮时。按钮的 , 那么这种的组件如何开发呢?定义文本滑动选择器弹窗并弹出。定义一个数组对象作为数据源。代码中 我们主要使用的是。事件表示点击确认按钮,滑动选择文本内容的组件。目前我们已经大致的了解了。当然此时依旧可以使用。

全栈若城,专注知识分享 6235

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

其中TextPickerDialogOptions,主要用于配置文本滑动选择器弹窗的参数。字段配置如下:名称类型说明range选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。说明:单列数据选择器使用string[],Resource,TextPickerRangeContent[]类型。多列数据选择器使用string[][]类型。多列联动数据选择器使用TextCascadePickerRangeContent[]类型。

harmonyClassRoom的博客 1720

HarmonyOS ArkUI Picker 选择器组件深度实战

摘要:选择器(Picker)是移动应用中处理结构化数据输入的核心交互组件。

从事移动开发八年,csdn博客专家,阿里云特邀专家,华为云云享专家,高级网络信息安全工程师,大数据工程师(高级),python技术开发(高级),HarmonyOS 应用开发者高级认证,现在某学校任教。 1万+

鸿蒙Harmony实战:定义文本滑动选择器弹窗并弹出 (TextPickerDialog)

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

2401_84917132的博客 1583

HarmonyOS鸿蒙开发指南:基础组件 picker开发指导

通过设置Picker的type属性来选择滑动选择器类型,如定义Picker为日期选择器。Picker的hours属性定义时间的展现格式,可选类型有12小时制和24小时制。对Picker添加change和cancel事件,来对选择的内容进行确定和取消。hours属性为12:按照12小时制显示,用上午和下午进行区分;在本场景中,开发者可以自定义填写当前的健康情况来进行打卡。普通选择器设置取值范围时,需要使用数据绑定的方式。hours属性为24:按照24小时制显示。

斌擎科技 1630

HarmonyOS ArkUI DatePicker 日期选择器深度封装与工程化实践

在鸿蒙应用开发中,日期选择是表单交互、日程管理、预约系统等场景的核心能力。HarmonyOS ArkUI 提供了原生的DatePicker与组件,能够满足基础的日期选择需求。代码冗余:每个页面都需要重复编写日期格式化、范围校验、回调处理等逻辑;样式割裂:不同页面的日期选择器外观不一致,难以维护统一的设计规范;功能缺失:原生组件不支持农历显示、自定义主题、防抖回调等高级需求;状态混乱:日期状态分散在各页面,跨页面共享困难。本文将从组件封装架构设计出发,深入讲解如何基于 ArkUI 的。

从事移动开发八年,csdn博客专家,阿里云特邀专家,华为云云享专家,高级网络信息安全工程师,大数据工程师(高级),python技术开发(高级),HarmonyOS 应用开发者高级认证,现在某学校任教。 1万+

HAL库STM32CubeMX+DHT11温湿度传感器模块化驱动与OLED显示实战

本文详细介绍了基于HAL库和STM32CubeMX开发DHT11温湿度传感器模块化驱动的实战过程。通过精确的时序控制和模块化封装,实现了传感器数据采集,并结合OLED显示模块实时展示温湿度信息,为嵌入式开发者提供了完整的解决方案。

h6j7k8l9p0的博客 1135

鸿蒙开发常用自定义组件:TextPicker_鸿蒙textpicker(1)

创建一个新的 eTS 文件,用来编写自定义 TextPicker 组件,代码如下:@Componentbuild() {angle: 0,})})通过 import 引用自定义 TextPicker 组件到要使用的页面,创建 Sample 页面,里面显示一个按钮和一个文本,按钮点击打开一个对话框。对话框里面有四个自定义 TextPicker 组件,用餐数据源是通过资源文件引用,其它数据源是通过定义变量或直接给出。

2401_84160325的博客 1041

Spring Boot 构建war 部署到tomcat下无法在Nacos中注册服务

因此,当使用外部容器时,如此处的 Tomcat 来部署项目,AbstractAutoServiceRegistration 就不能监听到容器启动事件了,也就不会尝试向服务注册中心注册当前这个微服务,那么注册就失败了,并且也就没有异常信息了。自定义获取获取外部容器端口的方法, 然后监听应用启动事件,当应用被启动时,获取外部容器启动的端口号,然后将这个 port 设置到 NacosAutoServiceReigistration 中。在启动类同级目录,复制下面代码即可(不需要修改,直接构建war即可)

ttyy1112的专栏 2520

【论文泛读|附源码】如何进行动力学重构? 神经网络自动编码器结合SINDy发现数据背后蕴含的方程

这一篇文章叫做 **数据驱动**的**坐标发现与方程发现算法**。想回答的问题很简单,就是根据数据写方程。 想想牛顿的处境,如何根据各种不同物体下落的数据,写出万有引力的数学公式的。这篇文章就是来做这件事的。当然,这篇论文并没有从牛顿视角,完全去思考牛顿所想。而是利用现有的**深度学习技术** 和 **动力学重构的方法** 。提出了一种框架,基于现有的计算机技术,去发现物质运动背后的物理规律。 这里直接给出这篇方法的核心思路图,我们后面会逐个讲解。

qq5q13638的博客 2460

#跟着若城学鸿蒙# UI组件篇-TextPicker及其属性

TextPicker是 ArkUI 提供的一个滑动选择文本内容的组件,支持单列或多列数据选择,以及多列联动数据选择。它提供了丰富的配置选项,如文本样式、分割线样式、渐隐效果等,以满足不同场景的需求。

Huang兄 1119

source tree clone error:fatal remote error: Repository not found

source tree clone error:fatal remote error: Repository not found

Linda的前端开发路 3079

鸿蒙开发常用自定义组件:TextPicker_鸿蒙textpicker,HarmonyOS鸿蒙个人信息界面设计

组件的成员变量可以通过两种方式初始化。本地初始化,例如:在构造组件时通过构造参数初始化,例如:具体允许哪种方式取决于状态变量的装饰器:创建一个新的 eTS 文件,用来编写自定义 TextPicker 组件,代码如下:@Componentbuild() {angle: 0,})})通过 import 引用自定义 TextPicker 组件到要使用的页面,创建 Sample 页面,里面显示一个按钮和一个文本,按钮点击打开一个对话框。

2401_84160325的博客 1423

宇树G1开发实践--PPT汇报(基础版)

本文介绍了一套基于宇树G1人形机器人的PPT自动演示系统,可实现"一键启动、自动演讲"功能。系统通过多线程同步技术,将音频播放与机器人动作完美结合,支持12种预设社交互动动作。硬件依赖宇树G1机器人、外接音响和网络连接,软件采用Python SDK和ALSA音频工具。核心功能包括音频文件自动排序、外接音响播放控制、机器人动作执行及音画同步。使用时需配置网络接口和音频设备号,运行后自动按顺序播放音频并执行随机动作。系统特别强调了安全注意事项,并提供了常见问题解决方案,适用于展会、汇报等需要

m0_47999117的博客 511

完整复现YOLOv8:包括训练、测试、评估、预测阶段【本文源码已开源,地址在文章末尾】

(这里主要是在colab.research.google.com实现的,本地的配置也是类似的方法)YOLOv8是一种用于目标检测的深度学习算法。主要参考:https://github.com/ultralytics/ultralytics/blob/main/README.zh-CN.md。yolov8的权重:https://github.com/ultralytics/assets/releases。yolov8的文档:https://v8docs.ultralytics.com/

源代码杀手的博客 1万+

鸿蒙中 选择器TextPicker组件

本文介绍了HarmonyOS中TextPicker组件的使用方法和自定义技巧。主要内容包括:1)基础用法,展示如何设置数据源(range)、默认选中项(selected/value)及事件处理;2)样式定制,通过textStyle、selectedTextStyle等属性自定义文本样式,以及调整选项高度(defaultPickerItemHeight)和可见数量(itemSize);3)多列选择器实现,演示了省份-城市联动选择器和日期选择器的开发方法。文中提供了完整的代码示例,帮助开发者快速掌握TextPi

梦想不只是梦与想的博客 459

肺癌术后随访离散选择实验(DCE)设计与SAS实现

随着肺癌早期诊断和治疗技术的进步,肺癌患者的生存率显著提高,术后随访管理成为提升患者生活质量的关键环节。然而,如何在有限的医疗资源下设计出既符合患者需求又具有成本效益的随访方案,是临床决策面临的重要挑战。 离散选择实验(Discrete Choice Experiment, DCE)是一种定量研究方法,通过模拟真实世界的选择情境,测量患者对不同随访方案属性的偏好程度。本研究旨在通过DCE方法,系统评估肺癌术后患者对随访服务的偏好,为制定以患者为中心的随访策略提供循证依据。

huanghm88的专栏 101

鸿蒙API13开发【按钮与选择TextPicker】ArkTS组件

滑动选择文本内容的组件。

鸿蒙的技术博客 1200

用miniconda建立PyTorch、Keras、TensorFlow三个环境

如果还没有安装Miniconda,请从[Miniconda官网](https://docs.conda.io/en/latest/miniconda.html)下载合适的版本并进行安装。如果遇到问题,可以通过编辑`~/.condarc`文件来临时禁用某个源,或者通过`conda config --remove channels`命令来移除配置的镜像源。要切换到不同的环境,先使用`conda deactivate`命令退出当前环境,再用`conda activate 环境名称`命令激活另一个环境。

数字人生 2464

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

鸿蒙应用开发:Slider(滑动选择器)

本文详细介绍了HarmonyOS元服务开发中的Slider组件使用方法。该组件提供滑块交互功能,适用于音量控制、亮度调节等场景。文章涵盖三大核心内容:1) 组件属性配置,包括最小值/最大值设置、步长控制、颜色定制等12个参数;2) 事件处理说明,包含拖动结束(bindchange)和拖动过程(bindchanging)两个关键事件;3) 完整代码示例,展示了多种场景下的Slider实现方式,包括基本用法、样式定制和动态参数配置。通过JS逻辑层代码,还演示了如何响应滑块操作并实时更新界面状态

2401_87008233的博客 570

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

鸿蒙API13开发【picker】JS容器组件

滑动选择器组件,类型支持普通选择器、日期选择器、时间选择器、时间日期选择器和多列文本选择器。

鸿蒙的技术博客 874

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

【鸿蒙软件开发】ArkTS基础组件之TextClock(时间显示文本)、TextPicker(滑动选择文本)

TextClock组件:通过文本将当前系统时间显示在设备上。支持不同时区的时间显示,最高精度到秒级。TextPicker组件:滑动选择文本内容的组件。TextClock组件:通过文本将当前系统时间显示在设备上。支持不同时区的时间显示,最高精度到秒级。TextPicker组件:滑动选择文本内容的组件。

m0_62599305的博客 4217

鸿蒙 HarmonyOS 6 | Picker 容器组件自定义选择器开发实战

做表单页、筛选页和设置页时,选择器几乎绕不开。 简单场景用 TextPicker、DatePicker、TimePicker 就够了。比如选择性别、选择生日、选择时间段,这类数据结构稳定,展示形式也比较固定。ArkUI 已经提供了对应的基础选择器,直接使用能节省很多开发时间。TextPicker 本身就是官方提供的文本滑动选择器组件,适合处理普通文本选项。

Code Metaverse 715
下一篇: 鸿蒙ArkTs 可见区域变化:公共事件onVisibleAreaChange的使用方法介绍
stdstd666
博客等级 码龄4年 12粉丝 2原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值