鸿蒙之List组件详解

前言:

List 组件的基本用法,可以用它来展示列表,并且实现列表滚动,日常开发的时候还可以用它来实现更为复杂的效果。
列表是一种复杂的容器,当列表项达到一定数量,超过List容器组件大小 时,可以自动提供滚动功能。它适合用于呈现同类数据类型或数据类型集,例如图片和文本。在列表中显示数据集合是许多应用程序中的常见要求(如通讯录、音乐列表、购物清单等)。

List 表示列表容器,ListItem表示单个列表项,可以包含单个子组件。

基本用法:

js 复制代码
@Entry
@Component
struct Index {
  build() {
    List(){
      ListItem(){
        Text('hello')
      }
      ListItem(){
        Text('hello')
      }
      ListItem(){
        Text('hello')
      }
    }
  }
}

效果如下:

常用属性:

滚动条状态 属性:scrollBar()

参数:枚举 BarState

  • Off: 不显示
  • On:常驻显示
  • Auto:按需显示(触摸时显示,2s 后消失)
js 复制代码
List() {
  listItem()
  ......
}
	.scrollBar(BarState.Off)

分割线样式 列表默认没有分割线

属性:divider()

参数:{ strokeWidth: 数字, color?: 'color', startMargin?: 数字, endMargin?: 数字 }

js 复制代码
@Entry
@Component
struct Index {
  build() {
    Column() {
      List() {
        ListItem() {
          Text('hello')
        }

        ListItem() {
          Text('hello')
        }

        ListItem() {
          Text('hello')
        }

        ListItem() {
          Text('hello')
        }
      }
      .border({width:1})
      .divider({
        strokeWidth: 1, // 设置分割线的宽度为1
        color: Color.Black, // 设置分割线的颜色为橙色
        startMargin: 10, // 设置分割线起点的边距为10
        endMargin: 10           // 设置分割线终点的边距为10
      })
    }
  }
}
相关推荐
山河木马1 分钟前
前端学习C++之:.h(.hpp)与.cpp文件
前端·javascript·c++
用户9272472502192 分钟前
PHP + CSS + JS + JSON 数据采集与展示系统,支持伪静态
前端
努力只为躺平6 分钟前
一文搞懂 Promise 并发控制:批量执行 vs 最大并发数,实用场景全解析!
前端·javascript
Web小助手8 分钟前
大保剑:Promise的有趣体验
javascript
李大玄8 分钟前
Google浏览器拓展工具 "GU"->google Utils
前端·javascript·github
爱编程的喵8 分钟前
从DOM0到事件委托:揭秘JavaScript事件机制的性能密码
前端·javascript·dom
蓝倾14 分钟前
京东批量获取商品SKU操作指南
前端·后端·api
JSLove21 分钟前
常见 npm 报错问题
前端·npm
sunbyte21 分钟前
50天50个小项目 (Vue3 + Tailwindcss V4) ✨ | ContentPlaceholder(背景占位)
前端·javascript·css·vue.js·tailwindcss
爱学习的茄子22 分钟前
React Hooks进阶:从0到1打造高性能Todo应用
前端·react.js·面试