Flutter国家城市选择器插件uni_country_city_picker的使用

描述

uni_country_city_picker是由UNICODE团队开发的一个轻量级Flutter包，用于选择国家和城市。它支持英语和阿拉伯语，并且提供了一系列有用的功能，如国家ISO代码、国家名称（中英文）、国家拨号代码、国旗表情符号、城市列表、电话号码位数长度等。

功能支持

• isoCode: 国家的ISO代码。
• name: 国家名称（阿拉伯文）。
• dialCode: 国家拨号代码。
• nameEn: 国家名称（英文）。
• flag: 国旗表情符号（例如：🇸🇦代表沙特阿拉伯，🇧🇩代表孟加拉国）。
• cities: 国家内的城市列表。
• phoneDigitsLength: 该国家电话号码的位数长度。
• phoneDigitsLengthMax: 该国家电话号码的最大位数长度。

使用入门

为了更好地理解如何实现，您可以查看我们的示例项目。

// [UniCountryServices] 提供获取国家和城市的接口。
final _uniCountryServices = UniCountryServices.instance;
List<Country> countriesAndCities = await _uniCountryServices.getCountriesAndCities();

完整示例

下面是一个完整的例子，演示了如何在Flutter应用中使用uni_country_city_picker：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Uni Country City Picker',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const CountriesAndCitiesView(),
    );
  }
}

/// [UniCountryServices] 提供国家和城市的服务。
final _uniCountryServices = UniCountryServices.instance;

class CountriesAndCitiesView extends StatefulWidget {
  const CountriesAndCitiesView({super.key});

  @override
  State<CountriesAndCitiesView> createState() => _CountriesAndCitiesViewState();
}

class _CountriesAndCitiesViewState extends State<CountriesAndCitiesView> {
  /// 国家和城市列表
  List<Country> countriesAndCities = [];

  @override
  void initState() {
    super.initState();
    // 在视图初始化时获取国家和城市
    _getCountriesAndCities();
  }

  /// 从包中获取国家和城市数据
  Future _getCountriesAndCities() async {
    countriesAndCities = await _uniCountryServices.getCountriesAndCities();
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Uni Country City Picker")),
      body: ListView.builder(
          itemCount: countriesAndCities.length,
          itemBuilder: (_, i) {
            Country country = countriesAndCities[i];
            return ListTile(
              onTap: () => debugPrint(country.toMap().toString()),
              title: Text(
                "${country.nameEn} (${country.flag}${country.dialCode})",
                style: const TextStyle(
                  fontWeight: FontWeight.w500,
                ),
              ),
            );
          }),
    );
  }
}

通过上述代码，您可以在Flutter应用程序中集成uni_country_city_picker插件，以实现国家和城市的便捷选择功能。如果您有任何疑问或需要进一步的帮助，请随时联系我！