parfaitementweb/filament-country-field

带有 ISO 3166 选项值的下拉国家选择器

2.1.2 2024-06-09 06:14 UTC

This package is auto-updated.

Last update: 2024-09-08 15:28:55 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads Filament Version

列出每个国家作为可选下拉列表的最简单方法 🤘

特性

  • 显示包含 所有 ISO 639-1 语言 的选择字段。 tl;dr: 双字母代码。
  • 内置 本地化 支持 132 种语言。
  • 支持所有原生 选择字段 功能。

屏幕截图

filament-country-field

入门指南

我们已经为您简化了开始步骤。以下是您需要遵循的三个步骤

  1. 安装包
composer require parfaitementweb/filament-country-field
  1. 在 Filament 资源中添加国家表单字段。
use Parfaitementweb\FilamentCountryField\Forms\Components\Country;

Country::make('country')
  1. 在 Filament 资源中添加国家列字段。
use Parfaitementweb\FilamentCountryField\Tables\Columns\CountryColumn;

CountryColumn::make('country')
  1. 享受。

配置

除了所有 选择字段 方法外,您还可以使用这三个助手来为表单组件提供帮助。

  • exclude() 从列表中删除项。
  • add() 向列表中添加您自己的值。
  • map() 将一个键更改为另一个键,例如 GB 更改为 UK
use Parfaitementweb\FilamentCountryField\Forms\Components\Country;

Country::make('country')
->exclude(['NL'])
->add(['MA' =>'Mars'])
->map(['GB' => 'UK', 'GF' => 'FR'])

清除缓存

为了确保更好的性能和更快的响应时间,国家列表存储在缓存中以便快速检索,从而提供更流畅的用户体验。

要清除缓存的国列表,您可以利用 Laravel 提供的内置 artisan 命令。以下命令可以在您的终端或命令行界面中运行

php artisan countries-field:clear

内置翻译

国家值根据用户的当前区域设置显示,该设置由 App::getLocale() 的值确定。

该字段支持这 132 种语言

南非荷兰语、阿坎语、阿姆哈拉语、阿拉伯语、阿萨姆语、阿塞拜疆语、白俄罗斯语、保加利亚语、班巴拉语、孟加拉语、藏语、布列塔尼语、波斯尼亚语、加泰罗尼亚语、车臣语、捷克语、威尔士语、丹麦语、德语、不丹语、伊维语、希腊语、英语、世界语、西班牙语、爱沙尼亚语、巴斯克语、波斯语、富拉语、芬兰语、法罗语、法语、西弗里语、爱尔兰语、苏格兰盖尔语、加利西亚语、古吉拉特语、马恩岛语、豪萨语、希伯来语、印地语、克罗地亚语、匈牙利语、亚美尼亚语、国际语、印度尼西亚语、伊博语、四川彝语、冰岛语、意大利语、日语、爪哇语、格鲁吉亚语、基库尤语、哈萨克语、格陵兰语、高棉语、卡纳达语、韩语、卡什米里语、库尔德语、康瓦尔语、吉尔吉斯语、卢森堡语、刚果语、林加拉语、老挝语、立陶宛语、卢巴-卡坦加语、拉脱维亚语、马达加斯加语、毛利语、马其顿语、马拉雅拉姆语、蒙古语、马拉地语、马来语、马耳他语、缅甸语、挪威博克马尔语、北恩德贝勒语、尼泊尔语、荷兰语、挪威尼诺斯克语、挪威语、奥罗莫语、奥里亚语、奥塞梯语、旁遮普语、波兰语、普什图语、葡萄牙语、克丘亚语、罗曼什语、伦达语、罗马尼亚语、俄语、卢旺达语、信德语、北萨米语、桑戈语、塞尔维亚-克罗地亚语、僧加罗语、斯洛伐克语、斯洛文尼亚语、绍纳语、索马里语、阿尔巴尼亚语、塞尔维亚语、瑞典语、斯瓦希里语、泰米尔语、泰卢固语、塔吉克语、泰语、提格里尼亚语、土库曼语、他加禄语、汤加语、土耳其语、鞑靼语、维吾尔语、乌克兰语、乌尔都语、乌兹别克语、越南语、沃洛夫语、聪加语、斯瓦齐语、希伯来语、约鲁巴语、中文、祖鲁语

内置国家

您可以在这里查看完整的国家列表

测试

composer test

更新日志

有关最近更改的更多信息,请参阅更新日志

贡献

有关详细信息,请参阅贡献

安全漏洞

请审查我们的安全策略,了解如何报告安全漏洞。

致谢

本包使用了umpirsky/country-list中的数据。感谢您的出色工作。

许可证

MIT许可证(MIT)。有关更多信息,请参阅许可证文件