返回

Flutter 可滚动小部件 - ListView

Android

Flutter 中的可滚动小部件 ListView

在 Flutter 中,ListView 是一种非常有用的可滚动小部件,它可以用来创建垂直或水平滚动的列表。ListView 的使用非常简单,只需要将要滚动的项目放在一个 List 中,然后将该列表传递给 ListView 的 children 参数即可。

ListView(
  children: [
    Text('Item 1'),
    Text('Item 2'),
    Text('Item 3'),
  ],
);

上面的代码将创建一个垂直滚动的列表,其中包含三个文本项目。

ListView 的属性

ListView 有许多属性可以用来控制列表的行为,其中一些最重要的属性包括:

  • scrollDirection :指定列表的滚动方向,可以是垂直的 (ListView.vertical) 或水平的 (ListView.horizontal)。
  • reverse :如果设置为 true,则列表将从最后一个项目开始滚动。
  • controller :一个 ScrollController 对象,可以用来控制列表的滚动行为。
  • padding :列表的内边距。
  • itemExtent :列表中每个项目的固定高度或宽度。
  • shrinkWrap :如果设置为 true,则列表将只占用其子项所需的空间。

ListView 的方法

ListView 还提供了一些方法来控制列表的行为,其中一些最重要的方法包括:

  • add() :在列表的末尾添加一个项目。
  • addAll() :在列表的末尾添加多个项目。
  • remove() :从列表中删除一个项目。
  • clear() :从列表中删除所有项目。
  • insert() :在列表中指定的位置插入一个项目。
  • removeAt() :从列表中指定位置删除一个项目。

ListView 的示例

以下是一些 ListView 的示例:

  • 垂直滚动的列表
ListView(
  children: [
    Text('Item 1'),
    Text('Item 2'),
    Text('Item 3'),
  ],
);
  • 水平滚动的列表
ListView(
  scrollDirection: Axis.horizontal,
  children: [
    Text('Item 1'),
    Text('Item 2'),
    Text('Item 3'),
  ],
);
  • 带有固定高度的列表
ListView(
  itemExtent: 50,
  children: [
    Text('Item 1'),
    Text('Item 2'),
    Text('Item 3'),
  ],
);
  • 带有可变高度的列表
ListView(
  shrinkWrap: true,
  children: [
    Text('Item 1'),
    Text('Item 2'),
    Text('Item 3'),
  ],
);

总结

ListView 是 Flutter 中非常有用的一个可滚动小部件,它可以用来创建垂直或水平滚动的列表。ListView 的使用非常简单,只需要将要滚动的项目放在一个 List 中,然后将该列表传递给 ListView 的 children 参数即可。