鸿蒙之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
      })
    }
  }
}
相关推荐
lecepin1 小时前
AI Coding 资讯 2025-09-17
前端·javascript·面试
IT_陈寒1 小时前
React 18实战:7个被低估的Hooks技巧让你的开发效率提升50%
前端·人工智能·后端
树上有只程序猿1 小时前
终于有人把数据库讲明白了
前端
猩兵哥哥1 小时前
前端面向对象设计原则运用 - 策略模式
前端·javascript·vue.js
司宸1 小时前
Prompt设计实战指南:三大模板与进阶技巧
前端
RoyLin2 小时前
TypeScript设计模式:抽象工厂模式
前端·后端·typescript
华仔啊2 小时前
Vue3+CSS 实现的 3D 卡片动画,让你的网页瞬间高大上
前端·css
江城开朗的豌豆2 小时前
解密React虚拟DOM:我的高效渲染秘诀 🚀
前端·javascript·react.js
vivo互联网技术2 小时前
拥抱新一代 Web 3D 引擎,Three.js 项目快速升级 Galacean 指南
前端·three.js