parfaitementweb / filament-country-field
带有 ISO 3166 选项值的下拉国家选择器
Requires
- php: ^8.1 || ^8.2 || ^8.3
- filament/filament: ^3.0
- illuminate/contracts: ^10.0|^11.0
- spatie/laravel-package-tools: ^1.15.0
Requires (Dev)
- filament/spatie-laravel-settings-plugin: ^3.2
- filament/spatie-laravel-translatable-plugin: ^3.2
- larastan/larastan: ^2.8
- laravel/pint: ^1.15
- nunomaduro/collision: ^7.9|^8.1
- orchestra/pest-plugin-testbench: ^2.0
- orchestra/testbench: ^8.20|^9.0
- pestphp/pest: ^2.1
- pestphp/pest-plugin-arch: ^2.0
- pestphp/pest-plugin-laravel: ^2.2
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- spatie/laravel-ray: ^1.33
README
列出每个国家作为可选下拉列表的最简单方法 🤘
特性
- 显示包含 所有 ISO 639-1 语言 的选择字段。 tl;dr: 双字母代码。
- 内置 本地化 支持 132 种语言。
- 支持所有原生 选择字段 功能。
屏幕截图
入门指南
我们已经为您简化了开始步骤。以下是您需要遵循的三个步骤
- 安装包
composer require parfaitementweb/filament-country-field
- 在 Filament 资源中添加国家表单字段。
use Parfaitementweb\FilamentCountryField\Forms\Components\Country; Country::make('country')
- 在 Filament 资源中添加国家列字段。
use Parfaitementweb\FilamentCountryField\Tables\Columns\CountryColumn; CountryColumn::make('country')
- 享受。
配置
除了所有 选择字段 方法外,您还可以使用这三个助手来为表单组件提供帮助。
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)。有关更多信息,请参阅许可证文件。