Download the PHP package fabioguin/livewire-searchable-select without Composer
On this page you can find all versions of the php package fabioguin/livewire-searchable-select. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fabioguin/livewire-searchable-select
More information about fabioguin/livewire-searchable-select
Files in fabioguin/livewire-searchable-select
Package livewire-searchable-select
Short Description Livewire component for searchable select inputs
License MIT
Homepage https://github.com/fabioguin/livewire-searchable-select
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package livewire-searchable-select
Livewire Searchable Select
Livewire component for searchable select inputs
Requirements
Installation
You can install the package via composer:
Basic Usage
-
use trait in your livewire component:
- Use the component in your blade view, and pass in a parameters:
Properties
| Property | Arguments | Result | Example |
|---|---|---|---|
| property | String - required property name | Define the property name | |
| model-app | String - required full model name | Define the source of data that will be select | |
| model-app-scope | String - optional name of model sope | Define model scope for filtering results | |
| option-text | String - required show column on option | Define the column(s) in model that want to be show in select option | |
| option-value-column | String - required set value | Define the column name as a value data that will be selected | |
| active-option-text | Mixed - optional set active value text | Define the default selected option to show on select | |
| active-option-value | Mixed - optional set active value | Define the default selected option value to pass in the model | |
| search-columns | Array - required search column | Define the column in model that want to be searched | |
| search-min-chars | Int - optional minimum character | Define minimum character for trigger search event; default: 0 | |
| search-limit-results | Int - optional max results to view in the dropdown | Define the lenght of result for dropdown; default: 10 | |
| input-extra-classes | String - optional add extra classes | Define the extra classes for the input, anyway each element has a class without defined attributes that can be exploited for customization, for example: "select-searchable-input", "select-searchable-input-clear-value", etc. | |
| input-placeholder | String - optional placeholder name | Define the placeholder for select input |
model-app-scope
With this parameter you can define a query scope of the model to filter the search results in a complex way (see official Laravel documentation). This makes the component even more flexible and usable in multiple contexts. Remember to use a string with the camel case syntax without specifying that it is a "scope" (see example).
Customization
Livewire Select is designed to be easily customizable. You can publish and modify the configuration, views, and language files to suit your needs.
Configuration
You can publish the configuration file with:
This will publish a livewire-searchable-select.php config file to your config directory. Here you can change the default settings of Livewire Select.
Views
If you need to modify the views, you can publish them with:
This will publish the view files to resources/views/vendor/livewire-searchable-select. You can edit these files to change the appearance of the select input.
Language
To customize the language strings, you can publish the language files with:
This will publish the language files to resources/lang/vendor/livewire-searchable-select. You can edit these files to change the text used by Livewire Select.
TODO and Future Developments
The Livewire Select package is currently under development and there are several features and improvements planned for future releases.
Here is a list of the planned tasks:
- Support for Tailwind CSS and Bootstrap 4: Currently, the views are designed for Bootstrap 5. However, the goal is to add support for Tailwind CSS and Bootstrap 4. This will require creating separate versions of the views for each of these CSS frameworks.
- Documentation Improvements: The documentation will be continuously updated to reflect new features and improvements. This includes adding more examples and tutorials.
- Testing and Bug Fixes: We will continue to test the package to identify and fix any bugs. If you find a bug, please report it via the “Issues” section on GitHub.
- Performance Improvements: We are always looking for ways to improve the performance of the package. This could include optimizing the code and adding new features to improve efficiency.
- Support for Other Livewire Features: We are exploring the possibility of adding support for other Livewire features, such as pagination and lazy loading.
Inspired by https://github.com/mitratek/livewire-select
We ❤️ Semantic Versioning https://semver.org/
Open to work, contact me: https://www.linkedin.com/in/fabio-guin-starzero/
All versions of livewire-searchable-select with dependencies
livewire/livewire Version ^3.0
illuminate/support Version ^10.0|^11.0