Flutter插件csc介绍与使用方法详解

CSC

一个用于获取每个国家信息的Flutter包。

特性

• 查看国家名称及其对应的州和城市详细信息。

开始使用

在pubspec.yaml文件中添加CSC作为依赖项以使用此包。

Flutter插件csc使用方法

import 'package:csc/csc.dart';

// 获取所有国家列表
Future<List<Country>> CSC.countries;

// 按名称操作
Future<bool> CSC.countryExistsByName(String name); // 检查指定名称的国家是否存在
Future<Country> CSC.countryByName(String name); // 根据名称获取国家
Future<bool> CSC.countryHasStatesByName(String countryName); // 检查指定国家是否有州
Future<List<State>> CSC.countryStatesByName(String countryName); // 根据国家名称获取所有州
Future<bool> CSC.stateExistsByName(String countryName, String stateName); // 检查指定国家和州是否有效
Future<State> CSC.stateByName(String countryName, String stateName); // 根据国家和州名称获取州
Future<bool> CSC.stateHasCitiesByName(String countryName, String stateName); // 检查指定州是否有城市
Future<List<City>> CSC.stateCitiesByName(String countryName, String stateName); // 根据国家和州名称获取所有城市
Future<bool> CSC.cityExistsByName(String countryName, String stateName, String cityName); // 检查指定国家、州和城市是否有效
Future<City> CSC.cityByName(String countryName, String stateName, String cityName); // 根据国家、州和城市名称获取城市

// 按代码操作
Future<bool> CSC.countryExistsByCode(String code); // 检查指定代码的国家是否存在
Future<Country> CSC.countryByCode(String code); // 根据代码获取国家
Future<bool> CSC.countryHasStatesByCode(String countryCode); // 检查指定国家是否有州
Future<List<State>> CSC.countryStatesByCode(String countryCode); // 根据国家代码获取所有州
Future<bool> CSC.stateExistsByCode(String countryCode, String stateCode); // 检查指定国家和州代码是否有效
Future<State> CSC.stateByCode(String countryCode, String stateCode); // 根据国家代码和州代码获取州
Future<bool> CSC.stateHasCitiesByCode(String countryCode, String stateCode); // 检查指定州是否有城市
Future<List<City>> CSC.stateCitiesByCode(String countryCode, String stateCode); // 根据国家代码和州代码获取所有城市
Future<bool> CSC.cityExistsByCode(String countryCode, String stateCode, String cityName); // 检查指定国家、州和城市代码是否有效
Future<City> CSC.cityByCode(String countryCode, String stateCode, String cityName); // 根据国家代码、州代码和城市名称获取城市

完整示例Demo

以下是一个完整的示例，展示如何使用csc插件来获取国家、州和城市的详细信息：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('CSC Plugin Example')),
        body: Center(child: CSCExample()),
      ),
    );
  }
}

class CSCExample extends StatefulWidget {
  [@override](/user/override)
  _CSCExampleState createState() => _CSCExampleState();
}

class _CSCExampleState extends State<CSCExample> {
  List<Country> _countries = [];
  List<State> _states = [];
  List<City> _cities = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    getCountries();
  }

  Future<void> getCountries() async {
    _countries = await CSC.countries;
    setState(() {});
  }

  Future<void> getStates(String countryName) async {
    if (await CSC.countryHasStatesByName(countryName)) {
      _states = await CSC.countryStatesByName(countryName);
      setState(() {});
    }
  }

  Future<void> getCities(String countryName, String stateName) async {
    if (await CSC.stateHasCitiesByName(countryName, stateName)) {
      _cities = await CSC.stateCitiesByName(countryName, stateName);
      setState(() {});
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      children: [
        DropdownButton<String>(
          value: _countries.isNotEmpty ? _countries[0].name : null,
          onChanged: (value) {
            getStates(value!);
          },
          items: _countries.map((country) {
            return DropdownMenuItem<String>(
              value: country.name,
              child: Text(country.name),
            );
          }).toList(),
        ),
        DropdownButton<String>(
          value: _states.isNotEmpty ? _states[0].name : null,
          onChanged: (value) {
            getCities(_countries[0].name!, value!);
          },
          items: _states.map((state) {
            return DropdownMenuItem<String>(
              value: state.name,
              child: Text(state.name),
            );
          }).toList(),
        ),
        DropdownButton<String>(
          value: _cities.isNotEmpty ? _cities[0].name : null,
          onChanged: (value) {},
          items: _cities.map((city) {
            return DropdownMenuItem<String>(
              value: city.name,
              child: Text(city.name),
            );
          }).toList(),
        ),
      ],
    );
  }
}