搜索插件、代码仓与 APP 分类

country_pickers 封面
插件详情v3.0.1

country_pickers

国家、代码、旗帜以及多种选择方式,触手可及……一个组件的距离……

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
6万
喜欢数
179
Pub 分数
150

安装插件

flutter pub add country_pickers

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Country Pickers 是一个 Flutter 包,提供了一个易于使用的 widget 来选择国家,包括它们的代码、名称和旗帜。它支持多个平台——Android、iOS、Web、macOS、Windows 和 Linux,并提供了多种选择国家的方式,例如通过下拉菜单或可搜索列表。该包通过为应用中的国家选择提供一致且可自定义的界面,简化了国际化任务。

适合场景

  • 国际表单输入
  • 带国家代码的电话号码输入
  • 用户资料本地化
  • 多区域应用支持
  • 旅行和配送服务选择

主要特点

  • 内置国家旗帜
  • 可搜索的国家列表
  • 对 ISO 国家代码的支持
  • 可自定义的 UI
  • 多种选择器样式

适合对象

  • 需要国家选择的应用
  • 带国际电话号码的表单
  • 全局用户引导
  • 本地化密集型应用
  • 跨平台移动和网页应用

使用建议

  • 需要互联网才能完全加载旗帜(如果使用远程图像)
  • 可能需要针对大型国家列表进行定制
  • 限于预定义的国家数据
  • 未针对仅离线使用进行优化
  • 在低端设备上渲染标志的性能

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

country_pickers

Countries, codes, flags and several way of picking them at your service...one widget away...

CountryPickerDropdown example
 CountryPickerDropdown(
            initialValue: 'AR',
            itemBuilder: _buildDropdownItem,
            itemFilter:  ['AR', 'DE', 'GB', 'CN'].contains(c.isoCode),
            priorityList:[
                    CountryPickerUtils.getCountryByIsoCode('GB'),
                    CountryPickerUtils.getCountryByIsoCode('CN'),
                  ],
            sortComparator: (Country a, Country b) => a.isoCode.compareTo(b.isoCode),
            onValuePicked: (Country country) {
              print("${country.name}");
            },
          )
 Widget _buildDropdownItem(Country country) => Container(
        child: Row(
          children: <Widget>[
            CountryPickerUtils.getDefaultFlagImage(country),
            SizedBox(
              width: 8.0,
            ),
            Text("+${country.phoneCode}(${country.isoCode})"),
          ],
        ),
      );
CountryPickerDialog example
void _openCountryPickerDialog() => showDialog(
        context: context,
        builder: (context) => Theme(
            data: Theme.of(context).copyWith(primaryColor: Colors.pink),
            child: CountryPickerDialog(
                titlePadding: EdgeInsets.all(8.0),
                searchCursorColor: Colors.pinkAccent,
                searchInputDecoration: InputDecoration(hintText: 'Search...'),
                isSearchable: true,
                title: Text('Select your phone code'),
                onValuePicked: (Country country) =>
                    setState(() => _selectedDialogCountry = country),
                itemFilter: (c) => ['AR', 'DE', 'GB', 'CN'].contains(c.isoCode),
                priorityList: [
                  CountryPickerUtils.getCountryByIsoCode('TR'),
                  CountryPickerUtils.getCountryByIsoCode('US'),
                 ],
                itemBuilder: _buildDialogItem)),
      );
CountryPickerCupertino example
 void _openCupertinoCountryPicker() => showCupertinoModalPopup<void>(
      context: context,
      builder: (BuildContext context) {
        return CountryPickerCupertino(
          pickerSheetHeight: 300.0,
          onValuePicked: (Country country) =>
              setState(() => _selectedCupertinoCountry = country),
          itemFilter: (c) => ['AR', 'DE', 'GB', 'CN'].contains(c.isoCode),
          priorityList: [
            CountryPickerUtils.getCountryByIsoCode('TR'),
            CountryPickerUtils.getCountryByIsoCode('US'),
          ],
        );
      });

Credits

Thanks goes to country-flags repo for the flag image assets.

所属分类

源码仓库

使用此插件的项目

所在榜单