HarmonyOS NEXT开发实战：列表项滑动快捷菜单-ListItem

冲浪王子_浪浪

于 2024-09-04 19:37:29 发布

阅读量278

点赞数 17

分类专栏： HarmonyOS OpenHarmony 鸿蒙开发文章标签： harmonyos 华为前端鸿蒙移动开发鸿蒙开发 OpenHarmony

本文链接：https://blog.csdn.net/qazwsx957486/article/details/141893740

版权

HarmonyOS 同时被 3 个专栏收录

52 篇文章 0 订阅

订阅专栏

OpenHarmony

52 篇文章 0 订阅

订阅专栏

鸿蒙开发

52 篇文章 0 订阅

订阅专栏

场景说明

在使用列表List的应用中，可以滑动列表项ListItem显示快捷菜单，快速完成对列表项的操作。List垂直布局时滑动操作支持左滑和右滑。

效果呈现

本示例最终效果如下：

listitem-slide

运行环境

本例基于以下环境开发，开发者也可以基于其他适配的版本进行开发：

IDE: DevEco Studio 4.0 Release
SDK: Ohos_sdk_public 4.0.10.13 (API Version 10 Release)

实现原理

本例关键功能点及其实现思路如下：

自定义组件实现划出后的快捷菜单。
利用ListItem组件的swipeAction属性，设置ListItem的划出组件为上述自定义组件。

开发步骤

实现自定义组件。本示例使用Row、Image组件组装一个包含两个图标按钮的快捷菜单组件。在定义组件时，给定入参便于后续定位到被滑动的ListItem。本示例中，当滑动出菜单后，点击置顶按钮可以将当前ListItem置顶，点击删除按钮可以删除当前ListItem。

@Builder itemEnd(index:number){
  Row(){
    Image($r("app.media.ic_public_topping"))
      ...
      .onClick(()=>{
        this.itemIndexArr.unshift(this.itemIndexArr.splice(index,1)[0])
      })
    Image($r("app.media.ic_public_delete"))
      ...
      .onClick(()=>{
        this.itemIndexArr.splice(index,1)
      })
  }.padding(4)
  .justifyContent(FlexAlign.SpaceEvenly)
}

使用ForEach循环渲染列表，并为ListItem设置swipeAction属性为上述自定义组件，设置属性时绑定入参。

swipeAction支持设置不同的滑动方向：
- start：List垂直布局时，向右滑动ListItem时在左侧显示的组件。本示例中未配置。
- end：List垂直布局时，向左滑动ListItem时在右侧显示的组件。
```
ForEach(this.itemIndexArr,(item:string,index) =>{
  ListItem(){
    Text('' + item)
      ...
  }.swipeAction({ end:this.itemEnd(index), edgeEffect: SwipeEdgeEffect.Spring})
},(item:string)=>item)
```

完整代码

通过上述步骤可以完成整个示例的开发，完整代码如下：

@Entry
@Component
struct Index {
  @State itemIndexArr:Array<number> = [1,2];
  @Builder itemEnd(index:number){
    Row(){
      Image($r("app.media.ic_public_topping"))
        .width(32)
        .height(32)
        .margin(4)
        .onClick(()=>{
          this.itemIndexArr.unshift(this.itemIndexArr.splice(index,1)[0])
        })
      Image($r("app.media.ic_public_delete"))
        .width(32)
        .height(32)
        .margin(4)
        .onClick(()=>{
          this.itemIndexArr.splice(index,1)
        })
    }.padding(4)
    .justifyContent(FlexAlign.SpaceEvenly)
  }

  build() {
    Column() {
      List({ space: 10 }) {
        ForEach(this.itemIndexArr, (item: string, index) => {
          ListItem() {
            Text('' + item)
              .width('100%')
              .height(100)
              .fontSize(16)
              .margin({ top: 10 })
              .borderRadius(16)
              .textAlign(TextAlign.Center)
              .backgroundColor(Color.White)
          }.swipeAction({ end: this.itemEnd(index), edgeEffect: SwipeEdgeEffect.Spring })
        }, (item: string) => item)
      }.height('90%')

      Row() {
        Image($r("app.media.ic_public_add_norm"))
          .width(40)
          .height(40)
          .margin(4)
          .onClick(() => {
            if (this.itemIndexArr.length === 0) {
              this.itemIndexArr.push(1)
            } else {
              this.itemIndexArr.push(this.itemIndexArr[this.itemIndexArr.length-1] + 1)
            }
          })
      }.height('10%')
    }.padding(10)
    .backgroundColor(0xDCDCDC)
    .width('100%')
    .height('100%')
  }
}

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

为了确保高效学习，建议规划清晰的学习路线

GitCode - 全球开发者的开源社区,开源代码托管平台希望这一份鸿蒙学习文档能够给大家带来帮助~

鸿蒙（HarmonyOS NEXT）最新学习路线