HarmonyOS NEXT鸿蒙开发 ArkUI：Scroll滚动组件 作者：马育民 • 2025-12-17 17:44 • 阅读：10000 # 介绍 [官网API](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-container-scroll-V5 "官网API") 可滚动的容器组件，当子组件的布局尺寸超过父组件的尺寸时，内容可以滚动。 ### 应用场景 使用 `Text` 组件显示文章时，当显示内容太多，超出手机屏幕时，看不到下面的内容。 可使用 `Scroll` 滚动组件，里面放入 `Text` 组件。默认情况下，文章内容 **不超出** 手机屏幕，不显示滚动条；**超出** 屏幕时，显示滚动条 # 子组件 支持单个子组件，当有多个子组件时，可搭配布局组件 # 接口 创建Scroll滚动容器。 ``` Scroll(scroller?: Scroller) ``` **参数：** - scroller：控制器，可略 # 属性 ### 滚动条状态 设置滚动条状态。如果容器组件无法滚动，则滚动条不显示。如果容器组件的子组件大小为无穷大，则滚动条不支持拖动和伴随滚动。 ``` scrollBar(barState: BarState) ``` **参数：** - barState：`BarState` 类型，必填，滚动条状态。 - Off：不显示。默认值 - On：常驻显示。 - Auto：按需显示(触摸时显示，2s后消失)。 # 例子 ``` Scroll() { Text(this.message) } ``` 当 `message` 内容超出父容器时，`Scroll` 才会显示滚动条 原文出处：http://malaoshi.top/show_1GW2QKyCYfJ7.html