Download the PHP package silverware/select2 without Composer
On this page you can find all versions of the php package silverware/select2. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download silverware/select2
More information about silverware/select2
Files in silverware/select2
Package select2
Short Description SilverWare Select2 Module.
License BSD-3-Clause
Homepage https://github.com/praxisnetau/silverware-select2
Informations about the package select2
SilverWare Select2 Module
Provides Select2-powered dropdown and Ajax fields for SilverStripe v4. Intended to be used with SilverWare, however this module can also be installed into a regular SilverStripe v4 project.
Contents
- Requirements
- Installation
- Configuration
- Usage
- Issues
- Contribution
- Attribution
- Maintainers
- License
Requirements
Installation
Installation is via Composer:
Configuration
As with all SilverStripe modules, configuration is via YAML. Extensions to LeftAndMain
are applied via config.yml
.
Usage
Select2Field
The Select2Field
class is used exactly the same way as a regular old DropdownField
:
Select2 Configuration
You can define any of the Select2 configuration settings by using the setConfig()
method:
Alternatively, you can set the defaults for all Select2Field
instances in your app by using YAML config:
NOTE: configuration setting names are defined using HTML attribute style, and not camel case, for example:
Select2AjaxField
The Select2AjaxField
is used to search a DataList
based on a search term entered by the user. The results are
retrieved from the server via Ajax and rendered as dropdown options. This is very handy for cases where the number of
available options in a regular dropdown would be prodigious.
The field is created like any other field:
But we do not pass an array of options to choose from to the constructor. Instead, we configure the field to search
a DataList
on the server-side. Here are the default settings:
As mentioned, these are the default settings, and the field will work out-of-the-box for SiteTree
searches.
Exclusions
You can also optionally define a series of exclusion filters, which use the same format for the exclude
method of
DataList
:
Any records matching the defined exclusion filters will be excluded from the results.
Formatting
By default, the field will render a regular series of dropdown options based on the $ID
and $Title
of the matching
records, however you can apply more advanced formatting for both results and the current selection. For example:
HTML will be rendered as a jQuery object, so be sure to wrap it in an enclosing element such as a <span>
.
Ajax Configuration
Any of the Select2 Ajax settings can be defined using the setAjaxConfig()
method:
Alternatively, you can set the defaults for all Select2AjaxField
instances in your app by using YAML config:
NOTE: configuration setting names are defined using HTML attribute style, and not camel case, for example:
Issues
Please use the GitHub issue tracker for bug reports and feature requests.
Contribution
Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.
Attribution
- Makes use of Select2 by Kevin Brown, Igor Vaynberg and others.
Maintainers
Colin Tucker | Praxis Interactive |
License
BSD-3-Clause © Praxis Interactive