Download the PHP package serjoagronov/livewire3-select2 without Composer

On this page you can find all versions of the php package serjoagronov/livewire3-select2. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package livewire3-select2

Simple to use Livewire component for Select2

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

Easy to use Livewire component specifically for Select2.

Installation

You can install the package via composer: This currently works on Livewire v3, ie Laravel 11.

I haven't tested 2 yet.

Initial Setup

First of all, ensure you install jQuery, and select2- for example, the below. You can also install these via npm and import it into your app.js. Main thing is ensuring the scripts are included anywhere you want select2 to work.

Usage

The package is quite straight forward, and can be used directly in a LIVEWIRE component, see below the basic usage

Component parameters

options (required) - array

The select2 component expects an array of options, this can be for example - you must pass this into the options param as per the above.

onchange (required) - string

The select2 component expects a string of the listener function to call. For example, triggerMyFunction- you can see how to do this below. The onchange function, expects one param. The param returned from this component is an array of data - which includes the following:

Name - The name param you passed in, this can be used in your custom function if required - this is null if not supplied.
Data - This is the values returned from the select2 change, if you have not set the multiple param, this is a string- otherwise its an array. Please see https://github.com/jackbayliss/livewire-select2?tab=readme-ov-file#base-component if theres any confusion.

[!IMPORTANT]
Ensure your function includes one parameter, for example triggerMyFunction($select2)

name (not required) - string

You can pass this to your component if you need specific logic based on the name.

model (not required) - string

You can pass an option value in as model, this then auto selects the option- useful in a case where a selection has already been made.

How to add a custom class

This can apply a custom CSS class to the Livewire Select2 component, see below for an example

multiple (not required) - blank param

[!TIP] If this is used, the data will be returned as an array, rather than a string.

This allows you to select multiple options, as per select2 usually does and should be used like the following:

Creating a Listener

[!TIP] A listener is required for the onchange param, in order to create a listener, you should do the below. This means, whenever the select2 component is changed - ie an option clicked, it will call the function you defined, and you can do as you wish with the logic.

[!IMPORTANT]
Whatever string you pass to the onchange param, ensure you create a listener and function like the above. Your function must accept one parameter, this is the array of data returned which includes name and data, name being the name you set on the component (if you did set one) and the data ie the value selected.

Example / How it works in practice

Base component

I have an initial component, which I am calling as in my blade. The component is below:

The view, is basic and looks like the below - main thing to take away is how the component is used:

You then get the below...

test-component

Stuck?

I have an example project setup below.. you can simply download it and composer install.

https://github.com/jackbayliss/livewire-select-2-example-proj

Testing WIP

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

License

The MIT License (MIT). Please see License File for more information.


All versions of livewire3-select2 with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/contracts Version ^10.0||^11.0
spatie/laravel-package-tools Version ^1.16
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package serjoagronov/livewire3-select2 contains the following files

Loading the files please wait ....