【重磅发布】flutter_chen_azlist - A–Z索引列表

耳東陳12512025-08-14 18:04

Language: English | 中文简体

flutter_chen_azlist

Flutter 城市列表/联系人列表组件（支持悬停头与A--Z索引）。基于 scrollable_positioned_list。

功能特性

快速构建城市/联系人列表界面
列表项按 A--Z 分组并支持悬停（可浮动）
支持自定义 Header 与索引联动
IndexBar 支持自定义样式与本地图片
支持滚动/跳转到指定条目
索引交互可选触觉反馈（haptic feedback）

兼容性

Dart：>= 3.0.0 < 4.0.0
Flutter：推荐 3.x

安装

yaml 复制代码

dependencies:
  flutter_chen_azlist: ^3.0.0

快速开始

dart 复制代码

import 'package:flutter/material.dart';
import 'package:flutter_chen_azlist/flutter_chen_azlist.dart';

class City extends ISuspensionBean {
  City(this.name, this.tag);
  final String name;
  final String tag;
  @override
  String getSuspensionTag() => tag;
}

class DemoPage extends StatelessWidget {
  DemoPage({super.key});

  final List<City> cities = [
    City('北京', 'B'),
    City('上海', 'S'),
    City('深圳', 'S'),
  ];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('AzListView Demo')),
      body: AzListView(
        data: cities,
        itemCount: cities.length,
        itemBuilder: (context, i) => ListTile(title: Text(cities[i].name)),
        susItemBuilder: (context, i) => Container(
          height: 40,
          padding: const EdgeInsets.symmetric(horizontal: 16),
          alignment: Alignment.centerLeft,
          child: Text(cities[i].getSuspensionTag()),
        ),
        indexBarOptions: const IndexBarOptions(hapticFeedback: true),
      ),
    );
  }
}

截图

示例

完整示例见 example/ 目录：

运行：cd example && flutter run

Thanks

azlistview

许可

使用 MIT 协议，参见 LICENSE。