搜尋套件、儲存庫與 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.

所屬分類

原始碼儲存庫

使用此套件的專案

所在榜單