Download the PHP package guava/filament-icon-picker without Composer
On this page you can find all versions of the php package guava/filament-icon-picker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download guava/filament-icon-picker
More information about guava/filament-icon-picker
Files in guava/filament-icon-picker
Package filament-icon-picker
Short Description A filament plugin that adds an icon picker field.
License MIT
Homepage https://github.com/GuavaCZ/filament-icon-picker
Informations about the package filament-icon-picker
Icon Picker for your filament panels
This plugin adds a new icon picker form field and a corresponding table column. You can use it to select from any blade-icons kit that you have installed. By default, heroicons are supported since it is shipped with Filament.
This can be useful for when you want to customize icons rendered on your frontend, if you want your users to be able to customize navigation icons, add small icons to their models for easy recognition and similar.
Installation
You can install the package via composer:
Filament v4:
Make sure to publish the package assets using:
Finally, make sure you have a custom filament theme (read here how to create one) and add the following to your theme.css file:
This ensures that the CSS is properly built:
For older filament versions, please check the branch of the respective version.
Usage
Usage in Schemas:
Add the icon picker to any form schema in your filament panel or livewire component that supports filament forms:
Usage in Tables:
To display the stored icon in your filamen tables, use our IconColumn class:
Usage on the frontend:
We store the full icon name in the database. This means to use the icon on the frontend, simply treat is as any other static icon.
For example, assuming we saved the icon on our $category
model under $icon
, you can render it in your blade view using:
More information on rendering the icon on the blade-icons github.
Customization
Search Results View
Out of the box, we provide three different search result views that you can choose from.
Grid View
This is the default view used. Icons will be shown in a grid with their name underneath the icon.
List View
Icons will be rendered in a list together with the icon's name.
Icons View
Icons will be rendered in a small grid with only the icons visible, optionally configurable to show a tooltip with the icon name.
Dropdown
By default, the icon picker will open a dropdown, where you can search and select the icon. (Very similar to a regular Select
field in filament).
If you prefer, you can disable the dropdown and then the search and results will be rendered directly beneath the field.
Limit sets
By default, all available icon sets in the system will be available in the icon picker.
If you want, you can limit the sets to only the sets you want, by providing an array of set names:
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Lukas Frey
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of filament-icon-picker with dependencies
blade-ui-kit/blade-icons Version ^1.8
filament/filament Version ^4.0
spatie/laravel-package-tools Version ^1.15.0