鸿蒙5.0开发进阶:UI框架-ArkTS组件(ScrollBar)

鸿蒙5.0版开发:ArkTS组件-ScrollBar 滚动条组件ScrollBar,用于配合可滚动组件使用,如List、Grid、Scroll。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


ScrollBar

滚动条组件ScrollBar,用于配合可滚动组件使用,如List、Grid、Scroll。

说明

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

子组件

可以包含单个子组件。

接口

ScrollBar(value: ScrollBarOptions)

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueScrollBarOptions是滚动条组件参数。

ScrollBarOptions对象说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
scrollerScroller是可滚动组件的控制器。用于与可滚动组件进行绑定。
directionScrollBarDirection否

滚动条的方向,控制可滚动组件对应方向的滚动。

默认值:ScrollBarDirection.Vertical

stateBarState否

滚动条状态。

默认值:BarState.Auto

说明

ScrollBar组件负责定义可滚动区域的行为样式,ScrollBar的子节点负责定义滚动条的行为样式。

滚动条组件与可滚动组件通过Scroller进行绑定,且只有当两者方向相同时,才能联动,ScrollBar与可滚动组件仅支持一对一绑定。

从API version 12开始,ScrollBar组件没有子节点时,支持显示默认样式的滚动条。

ScrollBarDirection枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称描述
Vertical纵向滚动条。
Horizontal横向滚动条。

示例1(设置子节点)

该示例为ScrollBar组件有子节点时的滚动条样式。

// xxx.ets
@Entry
@Component
struct ScrollBarExample {
  private scroller: Scroller = new Scroller()
  private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

  build() {
    Column() {
      Stack({ alignContent: Alignment.End }) {
        Scroll(this.scroller) {
          Flex({ direction: FlexDirection.Column }) {
            ForEach(this.arr, (item: number) => {
              Row() {
                Text(item.toString())
                  .width('80%')
                  .height(60)
                  .backgroundColor('#3366CC')
                  .borderRadius(15)
                  .fontSize(16)
                  .textAlign(TextAlign.Center)
                  .margin({ top: 5 })
              }
            }, (item:number) => item.toString())
          }.margin({ right: 15 })
        }
        .width('90%')
        .scrollBar(BarState.Off)
        .scrollable(ScrollDirection.Vertical)
        ScrollBar({ scroller: this.scroller, direction: ScrollBarDirection.Vertical,state: BarState.Auto }) {
          Text()
            .width(20)
            .height(100)
            .borderRadius(10)
            .backgroundColor('#C0C0C0')
        }.width(20).backgroundColor('#ededed')
      }
    }
  }
}

示例2(不设置子节点)

该示例为ScrollBar组件没有子节点时的滚动条样式。

@Entry
@Component
struct ScrollBarExample {
  private scroller: Scroller = new Scroller()
  private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

  build() {
    Column() {
      Stack({ alignContent: Alignment.End }) {
        Scroll(this.scroller) {
          Flex({ direction: FlexDirection.Column }) {
            ForEach(this.arr, (item: number) => {
              Row() {
                Text(item.toString())
                  .width('80%')
                  .height(60)
                  .backgroundColor('#3366CC')
                  .borderRadius(15)
                  .fontSize(16)
                  .textAlign(TextAlign.Center)
                  .margin({ top: 5 })
              }
            }, (item:number) => item.toString())
          }.margin({ right: 15 })
        }
        .width('90%')
        .scrollBar(BarState.Off)
        .scrollable(ScrollDirection.Vertical)
        ScrollBar({ scroller: this.scroller, direction: ScrollBarDirection.Vertical,state: BarState.Auto })
      }
    }
  }
}

tkinter-Scrollbar详解 本文介绍另一个控件Scrollbar,在tkinter-Text详解一文中有提到过Scrollbar,但是没有做过多的说明。因此本文将详解Scrollbar及其使用场景。 文章目录Scrollbarelementorientactivebackgroundbackgroundcursorjumprepeatdelayrepeatintervaltakefocuscommandset()什么是可滚动控件?scrollbar和可滚动控件的关系?scrollbar与可滚动控件的绑定 Scrollbar Scrol 阅读详情

相关推荐

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之ScrollBar组件

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之ScrollBar组件。

zy0412326的专栏 706

CSS Scrollbar (滚动条)

webkit内核浏览器(Chrome、Edge) 类名 作用 ::-webkit-scrollbar 滚动条整体部分,其中的属性有width,height,background,border(就和一个块级元素一样)等。 ::-webkit-scrollbar-button 滚动条两端的按钮。可以用display:none让其不显示,也可以添加背景图片,颜色改变显示效果。

SeriousLose 9217

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

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

m0_64420071的博客 852

HarmonyOS-UIAbitity-ScrollBar——【坚果派-红目香薰】

HarmonyOS-UIAbitity-ScrollBar——【坚果派-红目香薰】

红目香薰 1226

affymatrix探针转换 | GPL5175探针对应的基因转换

一般情况下,有一些比较成熟的对应平台的注释数据集的R包。但是这个注释平台,我在Bioconductor上找了一圈都没有找到。只能通过最原始也最可靠的方法,从GEO数据集上去下载这部分的注释文件。以下展示全过程。 我要检查的数据平台是:GPL5157。 数据集的注释集链接为:https://www.ncbi.nlm.nih.gov/geo/query/acc.cgi?acc=GPL5175 这个注释数据集比较难弄的地方在于,它的基因集注释的不太好。没有比较直接的可供提取的genesample的信息;在ge.

weixin_40640700的博客 7128

WS2812B非标准通信协议:手把手实现精准时序控制

详解WS2812B的精准时序实现原理,剖析其非标准通信协议的关键细节。通过实际操作指导,帮助开发者稳定驱动ws2812b灯带,解决常见时序偏差问题,提升项目显示效果与响应一致性。

weixin_42584586的博客 587

HarmonyOS6 ArkTS scrollbar 设置子节点

ScrollBar是 HarmonyOS ArkTS 中用于自定义滚动条样式的组件,其核心特性之一是支持自定义子节点(即滚动条的滑块样式),不再局限于系统默认的滚动条外观。外层Scroll组件通过关闭系统默认滚动条,避免与自定义滚动条冲突。ScrollBar外层设置背景色#f1f1f1与圆角,子节点(滑块)设置#FF9999背景色,形成背景+滑块的双层结构。你的代码中使用Text固定尺寸保证滑块大小稳定。圆角美化让滑块边缘更圆润。个性化颜色替代系统默认蓝色,视觉更协调。ScrollBar。

qq_37048082的博客 3万+

信号完整性之阻抗(五)

一、什么是阻抗 阻抗的概念是从高中或者初中大家可能就会接触到,没想它一直陪伴我十年了。在我的印象中,提到阻抗我可能就会想到电阻,这样的思想局限也限制了我平常思考问题。所以今天也想把阻抗这个概念在顺理一遍,有错误或者欠缺的地方希望大家指正。 1.什么是阻抗: ==在具有电阻、电感和电容的电路里,对电路中的电流所起的阻碍作用叫做阻抗。阻抗常用Z表示,是一个复数,实部称为电阻,虚部称为电抗,其中电容在电路中对交流电所起的阻碍作用称为容抗 ,电感在电路中对交流电所起的阻碍作用称为感抗,电容和电感在电路中对交流电引

刘小同学的博客 2587

鸿蒙ArkTS自定义滚动条ScrollBar实战教程

本文介绍了鸿蒙ArkTS中List组件自定义滚动条(ScrollBar)的完整实现方案。通过.scrollBar()、.scrollBarColor()和.scrollBarWidth()三个核心API,开发者可以灵活控制滚动条显示策略、颜色和宽度。文章从项目搭建开始,详细讲解了状态管理、数据准备、核心布局实现以及交互式控制面板的设计,重点演示了如何通过@State变量实现滚动条样式的实时动态调整。示例代码展示了如何构建一个支持三种显示模式(Auto/On/Off)、多种颜色预设和宽度调节的交互式滚动条演示

m0_67000457的博客 363

新手必看:TwinCAT死活扫不到倍福CX5020?别慌,先检查这3个地方(附静态IP配置)

本文详细介绍了TwinCAT软件无法扫描到倍福CX5020控制器的常见问题及解决方案。从网络连通性检查、系统环境配置到静态IP设置,提供了一套完整的排查流程和优化建议,帮助新手快速解决通信问题,确保设备稳定运行。

weixin_27219587的博客 368

手把手教你用Github提交CVE漏洞(附完整截图流程)

本文提供了在GitHub平台提交CVE漏洞的完整实战指南。从前期准备、目标搜寻与漏洞验证,到撰写规范的GitHub Issue进行披露,最后通过官方渠道完成CVE提交,手把手教你如何将安全研究成果转化为获得国际认可的CVE编号。

weixin_28309571的博客 332

HarmonyOS 6.1 实战:通过 Scroll 组件配合 scrollable 和 scrollBar 属性来构建可滚动的内容区域

基于HarmonyOS 6.1.1与HarmonyOS ArkTS API 24的云庄园虚拟农场经营应用开发全栈解析:从粒子飘落动画到七日收益柱状图可视化,多Tab导航与弹窗式CRUD架构深度剖析与最佳实践。

2501_92985290的博客 313

基于Termux的Android平台OpenClaw部署:移动端AI助理实现

本文介绍了在Android设备上通过Termux部署OpenClaw AI助理的方案。Android设备的便携性、Termux提供的完整Linux环境以及多样化的硬件配置使其成为理想的部署平台。文章详细分析了不同级别Android设备的硬件规格(从入门级到旗舰级),并提供了最低/推荐配置要求。部署步骤包括Termux安装初始化、Python环境配置以及性能优化建议。该方案充分利用Android设备的传感器和电池供电优势,为移动办公、学习等场景提供了低成本、高便携性的AI助理解决方案。

博客 3016

#鸿蒙 NEXT 应用开发实战:用 ArkTS 打造喝水提醒 App(API 24 篇)

本文介绍了基于HarmonyOS NEXT和ArkTS开发喝水提醒App的全过程。作者针对现代人饮水不足的问题,分析了现有应用存在的平台绑定、通知干扰等问题,选择API 24版本作为开发目标,充分利用ArkTS严格模式的类型安全和性能优势。文章详细阐述了开发环境配置、核心需求分析(包括饮水记录、进度可视化、目标设置等五大功能),以及采用单页面+状态驱动的架构设计。该项目充分利用鸿蒙生态特性,打造轻量级、本地优先的喝水提醒解决方案,避免功能臃肿,专注于改善用户饮水习惯。

duluo133的博客 468

YOLO26 正式发布源代码!极致速度优化方案, 面向工业级落地的目标检测模型!

YOLO26 作为 Ultralytics 公司于 2025 年 9 月发布的最新一代目标检测模型,在架构设计和技术实现上展现了显著的创新。本文深入分析了 YOLO26 的核心架构改进和技术原理,重点探讨了其在边界框回归、推理流程、损失函数设计和优化算法方面的突破性进展。

魔改工程师的博客 1247

【WorkBuddy专栏53】我的WB为什么变聪明了——SOUL与USER配置管理实战(上)

【WorkBuddy专栏53】我的WB为什么变聪明了——SOUL与USER配置管理实战(上)

AI人人懂 250

HarmonyOS 备忘录 :HarmonyOS ArkTS 快速记事本应用解析

备忘录应用是移动设备上最经典、最基础的生产力工具之一。本文将以 HarmonyOS 原生开发框架 ArkTS 为基础,详细解析一个轻量级备忘录应用(Quick Memo)的完整开发过程。该应用支持用户快速记录文字内容,自动添加时间戳,并具备添加与删除备忘录的核心功能。将备忘录卡片封装为独立的@Component@Componentbuild() {Column() {Button('删除')})// 时间格式化逻辑封装性。

qizayaoshuap的博客 220

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

从零打造鸿蒙原生 Python IDE:ArkTS + N-API + PTY + CPython 全链路解析

鸿蒙原生Python IDE技术解析 项目概述 鸿蟒工坊(HongMian Workshop)是一款运行在HarmonyOS PC上的Python集成开发环境,填补了鸿蒙PC生态的开发工具空白。项目将Thonny IDE的核心功能移植到鸿蒙平台,提供代码编辑、Shell交互和完整CPython解释器支持。 技术架构 UI层:基于ArkTS/ArkUI实现编辑器界面 桥接层:使用C++/N-API实现JS与C++的通信 运行时层:嵌入CPython 3.12解释器 系统层:利用HarmonyOS内核

一键难忘的博客 3万+

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

Devexpress16.2.6破解工具

Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具

HarmonyOS 6.1 实战:.scrollBar(BarState.Off)隐藏了滚动条,滚动条的存在有时会破坏整体的视觉美感

在鸿蒙操作系统的分布式应用生态中,ArkTS作为官方主推的声明式UI开发语言,承载了HarmonyOS应用开发的核心生产力。ArkTS在TypeScript的基础上进行了深度扩展,引入了装饰器(Decorator)驱动的声明式UI范式,使得开发者能够以接近自然语言的方式描述用户界面,同时享受类型系统带来的安全保障。与传统的命令式UI框架不同,ArkTS采用"数据驱动视图"的核心理念——当状态发生变化时,框架会自动计算差异并高效更新界面,这一机制与Flutter的Widget体系、React的虚拟DOM思想有

2401_86049470的博客 455

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

HarmonyOS 6效果实现:TextInput是ArkTS中用于接收单行文本输入的组件,它的placeholder参数用于设置占位提示文字,引导用户输入正确的内容

在鸿蒙操作系统的应用开发生态中,ArkTS作为首选的开发语言,承载着连接声明式UI范式与原生系统能力的重要使命。ArkTS并非一门全新的语言,而是在TypeScript的基础上进行了深度扩展,引入了装饰器(Decorator)、状态管理、自定义组件等一系列声明式开发特性,使得开发者能够以更加直观、高效的方式构建用户界面。与传统的命令式UI开发不同,声明式开发强调"描述UI应该是什么样子",而非"一步步告诉计算机如何构建UI",这种范式的转变极大地提升了开发效率和代码可维护性。鸿蒙应用的核心开发单元是组件(C

2401_86049470的博客 438

HarmonyOS6 ArkTS List 设置滚动条的边距

方向适配start= 左边距,end= 右边距;start= 上边距,end= 下边距。单位要求必须使用px()等官方单位,不可直接使用数字。生效前提滚动条状态不能为,否则属性不生效。无副作用仅修改滚动条位置,不影响列表滚动逻辑、内容布局与性能。核心属性→ 专门用于设置 List 滚动条的边距;配置方式:传入对象,使用定义单位;生效前提:配合显示滚动条;核心价值:独立控制滚动条位置,不影响内容布局,提升列表 UI 美观度与适配性。

qq_37048082的博客 5574

HarmonyOS ArkTS API 24,React Native鸿蒙跨平台使用多个useState+ 计算函数 升级为鸿蒙的@State + @DerivedState组合状态管理

Foo 和 bar 是坏成员。当读者试图通过一个使用示例来理解一段代码如何运行时,不切实际的示例会让代码难以理解。为什么不使用现实中的例子?通常的做法是确保每个代码示例都可以剪切并粘贴到一个真正的程序中。

2301_77888392的博客 865

鸿蒙原生ArkTS通讯录管家实战开发详解

文章摘要: 《鸿蒙原生ArkTS通讯录管家实战开发详解》介绍了一款基于鸿蒙系统的轻量级通讯录管理应用。项目采用ArkTS语言开发,实现了联系人增删改查、分组管理、生日提醒等完整功能。技术亮点包括:利用关系型数据库实现本地持久化、声明式UI响应式特性、全局Builder函数设计模式等。应用采用三层架构设计,包含数据层、业务层和UI层,核心代码集中在单个文件中便于维护。文章详细解析了数据模型设计、配色系统、数据库操作等关键技术点,特别介绍了联系人卡片侧滑操作、表单实时校验等交互细节。该项目既适合普通用户作为通讯

s1316339343的博客 395

Qt for HarmonyOS CheckBox 组件开源鸿蒙PC开发实践

本文介绍了在HarmonyOS平台上使用Qt开发CheckBox复选框组件的实践方法。项目实现了12种不同样式的复选框示例,包括基本样式、状态样式、自定义指示器、动画效果等多种类型。文章重点讲解了HarmonyOS上Qt应用开发的三个关键技术点:必须使用qtmain()作为应用入口而非main()、OpenGL ES表面格式的配置时机、以及QML中CheckBox的自定义实现方式。

2511_94246476的博客 685

HarmonyOS ArkTS API 24实现声明式 UI 框架与 @Builder 组件复用模式构建三标签页智能账单应用

食材保险App是一款基于鸿蒙ArkTS开发的单页面应用,核心解决两个生活痛点:一是家庭食材管理混乱、过期浪费严重;二是食材变质引发健康问题后缺乏保障机制。通过数字化的方式将食材采购、保鲜跟踪、保险理赔三个环节串联起来,用户只需在发现食材问题时一键发起理赔,系统自动审核并在1-3个工作日内完成赔付。本文围绕完整代码逐模块讲解,涵盖数据模型设计、响应式状态管理、弹框交互、列表渲染等核心功能。 项目采用单文件架构,所有代码集中在一个文件中,便于整体阅读和调试。实际工程中建议按组件拆分为独立文件。 设计要点:装饰器

qq_46340842的博客 168

鸿蒙原生ArkTS布局方式之ColumnStart垂直排列

本文介绍了鸿蒙原生应用开发中基于ArkTS的自定义弹窗实现方案,重点解析了@CustomDialog、@State和CustomDialogController三大核心技术。通过@CustomDialog装饰器可实现完全自定义的弹窗UI,配合@State实现弹窗内部状态管理,利用CustomDialogController控制弹窗生命周期。文章详细讲解了技术原理、配置参数和适用场景,并提供了包含确认弹窗和信息弹窗的示例应用架构,适用于输入反馈、选择确认、表单填写等交互场景,帮助开发者掌握鸿蒙NEXT平台下状

woshi_xiaoa的博客 392
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(WaterFlow)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Refresh)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值