PHPackages icetalker/filament-picker - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. icetalker/filament-picker ActiveLibrary[Utility & Helpers](/categories/utility) icetalker/filament-picker ========================= A Regular Picker for Filament Form 1.0.2(3mo ago)1052.8k↓45.8%12[1 PRs](https://github.com/icetalker/filament-picker/pulls)MITPHPPHP ^8.2 Since May 8Pushed 3mo ago1 watchersCompare [ Source](https://github.com/icetalker/filament-picker)[ Packagist](https://packagist.org/packages/icetalker/filament-picker)[ Docs](https://github.com/icetalker/filament-picker)[ RSS](/packages/icetalker-filament-picker/feed)WikiDiscussions 1.x Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (12)Used By (0) A Regular Picker for Filament Form ================================== [](#a-regular-picker-for-filament-form) [![Latest Version on Packagist](https://camo.githubusercontent.com/3c1a1d7b76b1e566de7ed69ce08da60d6aab2292863702d935b044b3cd82da3a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69636574616c6b65722f66696c616d656e742d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/icetalker/filament-picker)[![GitHub Tests Action Status](https://camo.githubusercontent.com/ac2131640657a59321e9e6464ea1f61a7b0cef8d1341baee8e8daf032a6c165f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f69636574616c6b65722f66696c616d656e742d7069636b65722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/icetalker/filament-picker/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/312970be36fb4434af830a9a8a6e3bf369ee9d57e04e850e0024fac56bd0ce26/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f69636574616c6b65722f66696c616d656e742d7069636b65722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/icetalker/filament-picker/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/b59a47a77ddf492b015b31d73204efb6af3c59ea1b1acbb1bac9e9ff180ebf12/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69636574616c6b65722f66696c616d656e742d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/icetalker/filament-picker) A Regular Picker for Filament Form. [![image](https://raw.githubusercontent.com/icetalker/filament-picker/main/screenshots/picker-dark.png)](https://raw.githubusercontent.com/icetalker/filament-picker/main/screenshots/picker-dark.png) [![image](https://raw.githubusercontent.com/icetalker/filament-picker/main/screenshots/picker-light.png)](https://raw.githubusercontent.com/icetalker/filament-picker/main/screenshots/picker-light.png) Installation ------------ [](#installation) You can install the package via composer: ``` composer require icetalker/filament-picker ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="filament-picker-view" ``` Usage ----- [](#usage) ``` public function form(Form $form): Form { return $form ->schema([ Picker::make('transport') ->label('Transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]) ->icons([ 'ship' => 'heroicon-o-home', 'airplane' => 'heroicon-o-paper-airplane', 'truck' => 'heroicon-o-truck', ]) ->imageSize(100) ->images([ 'ship' => 'https://source.unsplash.com/random/100x100/?ship', 'airplane' => 'https://source.unsplash.com/random/100x100/?airplane', 'truck' => 'https://source.unsplash.com/random/100x100?truck', ]) ->default('ship'), ]); } ``` ### Define Options [](#define-options) To define options, you can use the `options()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the label to be displayed. ``` Picker::make('transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]); ``` ### Add Icons [](#add-icons) To add icons, you can use the `icons()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the icon to be displayed: ``` Picker::make('transport') ->label('Transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]) ->icons([ 'ship' => 'heroicon-o-home', 'airplane' => 'heroicon-o-paper-airplane', 'truck' => 'heroicon-o-truck', ]) ``` ### Add Images [](#add-images) To add images, you can use the `images()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the image url to be displayed: ``` Picker::make('transport') ->label('Transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]) ->images([ 'ship' => 'https://source.unsplash.com/random/100x100/?ship', 'airplane' => 'https://source.unsplash.com/random/100x100/?airplane', 'truck' => 'https://source.unsplash.com/random/100x100?truck', ]); ``` The size of images is 50x50 by default, you can custom the size of images by using the `imageSize()` method and pass the size in pixels. ### Default Value [](#default-value) To set a default value, you can use the `default()` method and pass the value of the option: ``` Picker::make('transport') ->label('Transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]) ->default('ship'); ``` ### Custom Background Color [](#custom-background-color) You can customize the background color of options by using `backgroundColor()`/`activeBackgroundColor()` method: ``` Picker::make('transport') ->label('Transport') ->options([ 'ship' => 'By Sea', 'airplane' => 'By Air', 'truck' => 'By Truck', ]) ->backgroundColor('bg-white dark:bg-gray-800') ->activeBackgroundColor('bg-gray-400')， ``` > Note: Please make sure the parameters you passed are valid tailwind color value. Todo ---- [](#todo) - Add Relationship Support - Add Validation Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Martin H](https://github.com/icetalker) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 52 — FairBetter than 96% of packages Maintenance79 Regular maintenance activity Popularity39 Limited adoption so far Community16 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~57 days Recently: every ~70 days Total 12 Last Release 110d ago Major Versions 0.x-dev → 1.0.02025-09-15 PHP version history (2 changes)0.1.0PHP ^8.1 1.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/ea7da56e0d3dfb1a056f5504253dcf519f29c6264b10ed9709b8f649329c0dc8?d=identicon)[icetalker](/maintainers/icetalker) --- Top Contributors [![icetalker](https://avatars.githubusercontent.com/u/106749492?v=4)](https://github.com/icetalker "icetalker (4 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (3 commits)")[![3rgo](https://avatars.githubusercontent.com/u/437847?v=4)](https://github.com/3rgo "3rgo (2 commits)")[![Ant-V](https://avatars.githubusercontent.com/u/7198995?v=4)](https://github.com/Ant-V "Ant-V (1 commits)")[![tubring](https://avatars.githubusercontent.com/u/46536059?v=4)](https://github.com/tubring "tubring (1 commits)") --- Tags laravelicetalkerfilament-picker ### Embed Badge ![Health badge](/badges/icetalker-filament-picker/health.svg) ``` [![Health](https://phpackages.com/badges/icetalker-filament-picker/health.svg)](https://phpackages.com/packages/icetalker-filament-picker) ``` ### Alternatives [spatie/laravel-data Create unified resources and data transfer objects 1.8k28.9M627](/packages/spatie-laravel-data)[codewithdennis/filament-select-tree The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths. 320392.1k17](/packages/codewithdennis-filament-select-tree)[ralphjsmit/laravel-filament-components A collection of reusable components for Filament. 10972.2k2](/packages/ralphjsmit-laravel-filament-components)[hirethunk/verbs An event sourcing package that feels nice. 513162.9k6](/packages/hirethunk-verbs)[codebar-ag/laravel-filament-json-field A Laravel Filament JSON Field integration with CodeMirror support 1124.1k](/packages/codebar-ag-laravel-filament-json-field)[worksome/exchange Check Exchange Rates for any currency in Laravel. 123544.7k](/packages/worksome-exchange) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)