鸿蒙关于可以实现滚动效果的容器组件的相关知识

一、滚动的用途

        生活中，我们在使用各种APP应用的过程中，总是可以看到一些轮播图、内容页面的滑动、组件切换的效果等，这些都是为了提高用户的体验而设计的功能。在编程中，滚动的用途非常广泛，我们经常用在用户界面的交互、数据处理与展示等上面。总之滚动的用途是多种多样的，它可以让我们创造出富有吸引的程序。

二、关于含有滚动效果的容器组件

        在鸿蒙的学习过程中，我们目前接触到了好几个可以实现滚动效果的容器组件，它们分别是：Swiper、Grid、Scroll、Tabs，这几个容器通过不同的样式调整，可以实现不同的滚动的效果，从而达到不同的需求，在编程的过程中，我们通过不同的用户需求，来按需使用。

1、Swiper轮播图组件

Swiper是一个容器组件，它提供滑动轮播显示的能力。当设置了多个子组件后，它可以让这些子组件按照一定的时间间隔进行循环切换。通常用在展示图片上面。这个组件的基本语法为：

Swiper(控制器？) {
  //内部自检可以是Text，Image，Colum，Row等，常见的是配合Image使用
  // 轮播内容 
  // (设置尺寸，撑开swiper)
}
// 设置尺寸（内容拉伸、优先级高）
.width('100%')
.height(100)
 

它还包含了许多的属性，这些属性又分为两部分，一部分是自身的属性，另一部分是指示器样式的属性。自身的属性有：.vertical、.interval、.autoPlay、.loop；指示器样式的属性有：.indicator。每个属性都有着自己独特的特性。自身的属性（）：

指示器样式的属性——indicator：

// .indicator(Indicator.dot()) 
// 圆点指示器（默认） 
// .indicator(Indicator.digit()) 
// 数字指示器

基础代码
Swiper(){
  // 略
}
  .indicator(
    Indicator.dot()
      // .xxx(设置圆点指示器的属性)
  ) // 圆点指示器（默认）

我们还可以通过一些位置的属性来调整指示器的位置，以及点击/不点击的样式，我们可以通过以下一些属性来调整：

位置

常见样式

除了自身属性实现滚动，我们还可以通过按钮点击的形式来控制它的前后滚动，这我们就用到了一个其他的控制器了——SwpierController。它通过创建一个控制器对象，然后和轮播图组件进行绑定，最后通过SwiperController对象核心方法来进行上一页和下一页的切换。

语法为：

@Entry
@Component
struct SwiperDemo {
  // 1.创建控制器对象
  controller: SwiperController = new SwiperController()
 
  build() {
    Column({ space: 10 }) {
      // 2. 设置给 Swiper
      Swiper(this.controller) {
        // 略
      }
      Row() {
        Button('上一页')
          .onClick(() => {
            // 3.调用控制器的方式实现切换效果
            this.controller.showPrevious()
          })
        Button('下一页')
          .onClick(() => {
            this.controller.showNext()
          })
      }
 
    }
    .width('100%')
    .height('100%')
 
    // .padding(20)
  }
}

2、Grid网格布局

Grid是一个容器组件，它可以让内容按照指定的行列显示，并且可以设置滚动。它是一个强大的布局系统，它让我们对于页面中的一些卡片的布局更加整洁，提升了用户的整体体验和观看效果。

语法
Grid(){
GridItem(){
    组件
  }
}

2.1 固定行列的设置

在Grid容器组件中，我们通过给它设置行列的占比等分属性来达到行列的效果。其中属性包含：columnsTemplate、rowsTemplate、columnsGap、rowsGap。

语法

Grid（）{
 
}
 .columnsTemplate('1fr 1fr 1fr')
 .rowsTemplate('1fr 1fr 1fr')
 //以上两个属性配合生成一个固定行列的宫格
 .columnsGap(5)
 .rowsGap(5)

2.2 合并行列的设置

在日常开发中除了等比的网格布局外，我们还需要一些大小不均的网格，这我们就得用到合并行列的这个属性了。在合并行列的属性中，我们就不能设置在Grid容器上来，我们得设置在它的子组件GridItem上。在设置的过程中我们又得看要设置行还是列，以此来判断要使用的属性。我们通过在它身上使用columnStart()和columnEnd()这两个属性设置它需要合并的列。那么，设置合并列的属性就是rowStart()和rowEnd()了。

GridItem的属性

 

2.3 滚动的设置

在日常生活中，我们所见到的app内容它包含在容器组件里面是可以上下或者左右滑动的，比如：文件管理、购物、视频列表等。在开发的过程中，我们就得通过设置网格组件的属性来达到滚动的效果了，页面的滚动我们主要是水平的滚动和页面垂直滚动。我们通过设置Grid的rowsTemplate/columnsTemplate（里面的内容超出设置的屏幕宽高后实现滚动效果）属性来设置水平还是垂直。

2.4 控制滚动的设置

日常中除了容器自己滚动，我们还可以人为的点击实现滚动以此来达到自己目的。这个设置的方式是我们通过自定义一个scroller对象，然后将它绑定到Grid容器组件上，最后通过调用 Scroller 对象的 scrollPage 方法实现点击滚动的效果。

语法

// 创建 Scroller 对象
scroller: Scroller = new Scroller()
// 设置给 Grid
 Grid(this.scroller) {
   // ...
 }
// 通过代码控制
this.scroller.scrollPage({
  next:true // 下一页
  next:false // 上一页
})

2.5 自定义滚动的设置

在开发的过程中，用户在使用app的过程中对于滚动条样式审美的提升，不断向开发人员提出建议，开发人员不得不改变滚动条样式。通过使用ScrollBar组件（需要和Grid公用同一个Scroller）来自定义样式。

Grid的属性

scrollBar的参数

用法

// 和 Grid 共用同一个 Scroller
scroller: Scroller = new Scroller()
// 和 Grid 共用同一个 Scroller
Grid(this.scroller){
// 略
}
// 和 Grid 共用同一个 Scroller
// 创建 ScrollBar 组件并设置属性
ScrollBar({
scroller: this.scroller,
direction: ScrollBarDirection.Horizontal // 方向
}) {
// 滚动内容 设置外观即可
Text()
}
// 设置外观

3、Scroll组件

Scroll组件可滚动的容器组件，当子组件的布局尺寸超过Scroll的尺寸时，内容可以滚动。当页面内容由多个区域组成，并且可以滚动时，推荐使用 Scroll。

3.1核心用法

通过设置Scroll的尺寸，在内部设置子组件的大小和内容，如果子组件的高度超出 Scroll，就竖向滚动；相反，子组件的宽度超出 Scroll，scrollable改为横向滚动。

语法

Scroll(){
  // 只支持一个子组件
  Column(){
    // 内容放在内部
    // 尺寸超过 Scroll 即可滚动
  }
}
.width('100%')
.height(200)

属性

3.2 控制器的使用

日常开发中可能需要通过代码控制滚动，以及获取滚动的距离，在这里用到了 2 个方法：

1. scrollEdge：滚动到边缘
2. currentOffset： 获取当前的偏移量

语法

@Entry
@Component
struct ScrollDemo {
//1.  实例化 Scroller的 控制器
  scroller: Scroller = new Scroller()
 
  build() {
    Column() {
    //2.  绑定给 Scroll
      Scroll(this.scroller) {
        // 内容略
      }
      Row() {
        Button('返回顶部')
          .onClick(() => {
            // 滚到顶部
            this.scroller.scrollEdge(Edge.Top)
          })
        //3.  调用 控制器的方法控制滚动，通过控制器的属性获取滚动距离
        Button('获取滚动距离')
          .onClick(() => {
            const x = this.scroller.currentOffset().xOffset
            const y = this.scroller.currentOffset().yOffset
            AlertDialog.show({
              message:`x:${x},y:${y}`
            })
          })
      }
    }
  }
}

scrollEdge方法参数

滚动到的边缘位置。

Edge.Top 顶部

Edge.Start 开头

Edge.Bottom 底部

Edge.End 结尾

currentOffset 方法返回值

xOffset: 水平滑动偏移;

yOffset: 竖直滑动偏移。

3.3 onScroll 事件【Api12开始请使用onWillScroll事件替代】

Scroll(){
  // 内容略
}
  .onScroll((x,y)=>{
    // 滚动时 一直触发
    // 可以结合 scroller的currentOffset方法 获取滚动距离
  })