Flutter国家数据获取插件country_data的使用

country_data 是一个纯 Dart 编写的 Flutter 插件，提供了国家相关的数据，如名称、电话区号、货币、州和城市等信息。

特性

• 获取国家列表
• 获取特定国家的信息
• 根据国家代码获取州列表
• 根据国家代码和州代码获取城市列表

示例应用

使用方法

获取国家列表

List<Country> countries = CountryData().getCountries();

获取特定国家的信息

Country? country = CountryData().getCountryById(countryId: 'IN');
// Country 类包含国家信息
String id; // 国家 ID
String name; // 国家名称
String native; // 国家本土/语言
String phone; // 国家电话区号
String capital; // 国家首都
String currency; // 国家货币符号
String emoji; // 国家旗帜表情
String emojiU; // 国家表情代码
String currencyCode; // 国家货币代码

根据国家代码获取州列表

List<String> states = CountryData().getStates(countryId: 'IN');

根据国家代码和州代码获取城市列表

List<String> cities = CountryData().getCities(countryId: 'IN', state: 'Punjab');

完整示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 country_data 插件：

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Country Data Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const HomeView(),
    );
  }
}

class HomeView extends StatefulWidget {
  const HomeView({Key? key}) : super(key: key);

  @override
  State<HomeView> createState() => _HomeViewState();
}

class _HomeViewState extends State<HomeView> {
  CountryData countryData = CountryData();
  List<Country> countries = [];
  List<String> states = [];
  List<String> cities = [];

  @override
  void initState() {
    super.initState();
    initCountries();
  }

  Country? selectedCountry;
  late String selectedState;
  late String selectedCity;

  void initCountries() {
    countries = countryData.getCountries();
    selectedCountry = countries[0];
    initCountryStates();
  }

  // 选择国家
  void selectCountry({required String countryId}) {
    selectedCountry = countryData.getCountryById(countryId: countryId);
    if (selectedCountry != null) {
      initCountryStates();
      setState(() {});
    }
  }

  void initCountryStates() {
    // 选择州
    states = countryData.getStates(countryId: selectedCountry!.id);
    if (states.isEmpty) states = [selectedCountry!.name];
    selectedState = states[0];
    setState(() {});
    initCities();
  }

  void selectState({required String state}) {
    selectedState = state;
    initCities();
    setState(() {});
  }

  void initCities() {
    cities = countryData.getCities(
        countryId: selectedCountry!.id, state: selectedState);
    if (cities.isEmpty) cities = [selectedState];
    selectedCity = cities[0];
    setState(() {});
  }

  void selectCity({required String city}) {
    selectedCity = city;
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Country Data'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            Row(
              children: [
                const Expanded(
                  flex: 2,
                  child: Text(
                    "Select Country ",
                    style: TextStyle(
                      fontWeight: FontWeight.bold,
                    ),
                  ),
                ),
                Expanded(
                  flex: 6,
                  child: DropdownButton<String>(
                    isExpanded: true,
                    value: selectedCountry?.id,
                    hint: const Text('India'),
                    items: countries
                        .map((country) => DropdownMenuItem<String>(
                              value: country.id,
                              child: Text(
                                '${country.emoji} ${country.name}',
                                overflow: TextOverflow.ellipsis,
                              ),
                            ))
                        .toList(),
                    onChanged: (countryId) {
                      if (countryId != null) {
                        selectCountry(countryId: countryId);
                      }
                    },
                  ),
                ),
              ],
            ),
            Row(
              children: [
                const Expanded(
                  flex: 2,
                  child: Text(
                    "Select State ",
                    style: TextStyle(
                      fontWeight: FontWeight.bold,
                    ),
                  ),
                ),
                Expanded(
                  flex: 6,
                  child: DropdownButton<String>(
                      value: selectedState,
                      items: states
                          .map((state) => DropdownMenuItem<String>(
                                value: state,
                                child: Text(state),
                              ))
                          .toList(),
                      onChanged: (state) {
                        if (state != null) selectState(state: state);
                      }),
                )
              ],
            ),
            Row(
              children: [
                const Expanded(
                  flex: 2,
                  child: Text(
                    "Select City ",
                    style: TextStyle(fontWeight: FontWeight.bold),
                  ),
                ),
                Expanded(
                  flex: 6,
                  child: DropdownButton<String>(
                      value: selectedCity,
                      items: cities
                          .map((city) => DropdownMenuItem<String>(
                                value: city,
                                child: Text(city),
                              ))
                          .toList(),
                      onChanged: (city) {
                        if (city != null) selectCity(city: city);
                      }),
                )
              ],
            )
          ],
        ),
      ),
    );
  }
}

开始使用

这个项目是一个 Dart 包的起点，可以作为一个库模块，包含可以在多个 Flutter 或 Dart 项目中轻松共享的代码。

要开始使用 Flutter，请查看我们的在线文档，其中提供了教程、示例、移动开发指南和完整的 API 参考。

贡献

欢迎任何形式的贡献！您可以 fork 并以任何方式改进 country_data，提交 pull request 或打开 issue。